Zendesk manages customer interactions in one place by turning customer inquiries into manageable tickets to ensure every issue is tracked and resolved promptly.  More information can be found at the Zendesk Website.

Integration Method: API

Tables: Ticket Inventory (99405001)

This integration supports the following events.

This integration supports the following versions.

Prerequisites

• The user should have access to the Zendesk portal with an account that has the Global Administrator privileges. 

• The user should have access to the DataBee console.

Configuration Overview

1. Get Zendesk sub-domain, Username, API Token which is required for API authentication.

2. Add the Zendesk in the DataBee console with the below parameters.

   DataBee Parameter	Zendesk Parameter
   Sub-domain	Sub-domain of Zendesk.
   Username	Username of the agent appended with /token.
   Password	API token

Zendesk Configuration

1. Get the Sub-domain from your Zendesk portal URL. For e.g, if Zendesk portal URL is Zendesk URL then sub-domain is k2d. Refer this knowledge base for more info.
    

2. Login to Zendesk portal. Fill out Zendesk sub-domain and click on Sign in.
    

3. Enter the ‘Email’ and ‘Password’, click Sign in.
    

4. After successful login, select the Gear icon from left side menu then click Go to Admin Center as shown below.
    

5. In the Admin, select Apps and integrations from left side menu and click on Zendesk API as shown below.
    

6. Agree terms and conditions and click Get started.
    

7. Follow the steps as mentioned below.

   1. Click on Settings.

   2. Enable token access.

   3. Click on Add API token.

   4. Provide a description for the token.

   5. Copy the API token. This token is only available during this step. Ensure it is copied before proceeding.

   6. Click Save.
       

DataBee Configuration

1. Login to the DataBee UI, navigate to Data > Data Feeds and click the Add New Data Feed button.
    

2. Search for the Zendesk and click it as shown below.
    

3. Click on the API Ingest option for collection method.
    

4. Enter feed contact information and click Next.
    

5. In the configuration page, confirm the following:

   • Authorization Method: Basic

   • API Base URL: this is the base URL that DataBee will interact with. Replace <sub-domain> with your Zendesk sub domain.

   • Username: your email address appended with /token. example: name@company.com/token.

   • Password: paste the API token.

   • Event Types: preselected for all the event types that integration pulls.
      

6. Click Submit.

Troubleshooting Tips

• Ensure the token is pasted correctly. Since you cannot view the token after the 1^st time, re-create the token by following steps, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.

• Ensure /token is appended with email address in username field.