To use your Talkdesk Zendesk Connector Integration, you need to complete several steps. The following article goes into these in detail, helping you easily get started.

Activating the Zendesk Integration

1. Log in to your Talkdesk account as an Administrator and navigate to Builder [1] > Integrations [2].

Note: Your role must contain the appropriate permissions to see these options. Learn more on Team Roles.

2. Click Add Integration [3]. The “Available Integrations” list appears.

3. Scroll down and locate Zendesk. Click Add Integration [4] to proceed to the integration’s configuration page.

4. Fill out the form with your Zendesk credentials:

• Enter your “Account” subdomain [5].
• Select the appropriate boxes to customize the configuration to synchronize contacts, load interactions and choose the interaction types [6].

5. Once you have completed these steps, click Save & Authorize [7]  at the bottom of the page.
6. You will be redirected to Zendesk. Sign in and click Allow to authorize the OAuth connection.

The Talkdesk and Zendesk integration is now activated. All information will be automatically synchronized between Talkdesk and Zendesk, and you can start adding automations.

Updating your Existing Zendesk Integration to OAuth

If your Zendesk integration was set up using API key authentication, you must migrate it to OAuth by October 27, 2026.

Note: If you do not complete this step by October 27, 2026, your Zendesk integration may stop working.

1. Log in to your Talkdesk account as an Administrator and navigate to Builder [1] > Integrations [2].
2. Locate your Zendesk integration and click Edit.
3. Click Save & Authorize [4] at the bottom of the page.
4. You will be redirected to Zendesk. Sign in and click Allow to authorize the OAuth connection.

Your integration is now using OAuth and no further action is required.

Installing Talkdesk Connector for Zendesk

Note: To complete this section, you need admin permissions.

Follow these steps to install and configure Talkdesk Connector and integrate it with your Zendesk account:

1. Log in to your Zendesk account.
2. Click on the Settings icon [1].
3. Click Go to Admin Center [2]. 

4. In the Admin Center, choose Apps and Integrations [3].
   
   
    

5. Click on Marketplace [4].

6. Search the Zendesk marketplace for "Talkdesk Connector" [5] and click on Talkdesk Connector [6].

7. Click Install [7].

8. Select the Zendesk account where you want to install the Talkdesk Connector from the drop-down list (if there’s more than one available) [8].
9. Then, click on Install [9].

10. In the Talkdesk Connector configuration page, define what type of CTI view you want to have [10] by writing down one of the following parameters: 
    • “external”: to use Talkdesk in a separate browser tab, window, or via App.
    • “workspace”: to use Talkdesk Agent Workspace embedded in Zendesk.
    • “conversations”: to use only the Conversations app embedded in Zendesk.
11. Select the Talkdesk environment region, where you want to install your Talkdesk connector, by writing down one of the following parameters [11]:

• “prd-us”: for accounts that have their cloud geographically located in the USA.
• “prd-ca”: for accounts that have their cloud geographically located in Canada.
• “prd-eu”: for accounts that have their cloud geographically located in Europe.

12. Select the desired width and height of the single UI component on the top bar (CTI view), if you wish to change the default values (width: 525px; height: 690px). In case you don’t fill anything, the component will have the default size [12].
13. Select the desired height of the component on the sidebar, if you wish to change the default value (height: 700px) [13].
14. Choose “Enable Talkdesk Copilot” [14], if you wish to enable Copilot on the sidebar. To know more about using Talkdesk Copilot on Zendesk, consult this article.
15. Choose “Enable Click-to-call on sidebar” [15], if you wish to enable Click-to-call on the sidebar.
16. Choose “Enable Role restrictions” [16] if you wish to grant access permissions only to specific roles.
17. Select “Enable Group restrictions” [17] if you wish to grant access permissions only to specific groups.
18. Click Install [18].

 Logging in to the Talkdesk Connector in Zendesk

To start using Talkdesk Connector with Zendesk, your agents need to log in to the new CTI prompt displayed on their Zendesk accounts.

1. Type in your Talkdesk account name [1] and click Login [2].

2. On the pop-up, type in your Talkdesk email address and password [3], then click Login [4].

Talkdesk Connector is now connected to your Zendesk account and you can start using it.