Zendesk Integration

Introduction

Integrating Zendesk with TrueLoyal can significantly enhance both customer support and loyalty management, offering a seamless and efficient experience for businesses and their customers. By leveraging customer data from TrueLoyal, such as loyalty status, purchase history, and preferences, support agents can provide tailored responses and solutions. Additionally, insights from TrueLoyal’s loyalty data enable businesses to anticipate customer needs and address potential issues proactively, fostering a more proactive rather than reactive approach to customer service.

Integration Process

TrueLoyal would need credentials generated using the Zendesk API token to enable the Zendesk integration.

  • Steps to Generate API Token: API tokens are managed in the Admin Center interface at Apps and integrations > APIs > Zendesk API. More details can be found here.
  • Steps to Generate Base64 Credentials Using API Token: Follow the steps mentioned in the Zendesk help doc to create credentials: Zendesk API Security and Authentication.

Once the credential is generated, please share it with your account manager at support@trueloyal.com

If you encounter difficulties in generating the credential, please share the following details with your account manager, and we will generate it for you:

  • API token
  • Admin email address
  • Zendesk domain URL

How to create API token?

Click on the Settings tab and then on the "Go to Admin Center" hyperlink. This will take you to the Admin Center.

  1. Navigate to Apps and Integrations > APIs > Zendesk API.

  1. Enable the Token Access toggle button.
  2. Click on Add API Token.

  1. Write the token description (optional), copy the API token, and save it.

📘

Please Note:

Make sure to copy and store this token. The token won't show again after you click Save or leave the page.

Mapping Loyalty Member Data

Once the integration is enabled, TrueLoyal will start syncing below loyalty member attributes to Zendesk. These fields need to be created manually in Zendesk.

Attributes Field Type Description
zrl_member_available_points Decimal Total available points against the member.
zrl_member_member_id Text Unique Member ID of Member.
zrl_member_member_status Text Status of the Member such as active, block, deleted, opted out.
zrl_member_number_of_purchases Number Number of purchases made by the member.
zrl_member_number_of_redemptions Number Number of redemptions made by a member.
zrl_member_enrollment_date Text The date when a Member enrolled in the Loyalty Program.
zrl_member_last_modified_date Text The last date when a Member's loyalty data has been modified.
zrl_member_lifetime_points_earned Decimal Total lifetime points earned by a member till date.
zrl_member_lifetime_points_expired Decimal Total lifetime points expired for a member till date.
zrl_member_lifetime_points_redeemed Decimal Total lifetime points redeemed after redeeming a reward by a member till date.
zrl_member_lifetime_points_deducted Decimal Total lifetime points deducted against the member till date.
zrl_member_referral_url Text Unique referral URL of member used for refer-a-friend events.
first_name Text First name of the member.
email Text The email address of the member.
phone Text The phone number of the member.
last_name Text Last name of the member.
zrl_member_first_purchase_date Text The date on which the member made a first purchase.
zrl_member_last_purchase_date Text The date on which the member made a last purchase.
zrl_member_loyalty_tier_name Text Current loyalty tier name in which member exists currently.
zrl_member_loyalty_tier_id Text Current loyalty tier ID in which member exists currently.
zrl_member_qualified_points Decimal The points qualified by a member. These qualified points are considered to check the eligibility of the member for tier upgrade, tier downgrade, etc.

Please follow below steps to create loyalty attribute fields in Zendesk.:

  1. Go to the Admin Center.
  2. Navigate to People > Configuration > User Fields.

  1. Click on Add Field.

  1. Select the appropriate field type and add the attributes to Zendesk. Attributes are mentioned in the table above.

Please ensure these fields are correctly set up so that TrueLoyal can sync the loyalty member attributes to Zendesk seamlessly.

If you have any questions or need further assistance, please contact your account manager at support@trueloyal.com
The loyalty member data will be updated or synced only on points update or tier change. The scenarios are listed below:

  • When points are awarded
  • When points are deducted
  • When points are redeemed
  • When points expire
  • When tier is upgraded or downgraded
Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.