> ## Documentation Index > Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # Configure Zendesk > Configure data exchange between CloudTalk and Zendesk to ensure your data stays up to date. > [!NOTE] > > This article explains how to connect Zendesk with CloudTalk, configure advanced call export rules, and install the CloudTalk CTI so your team can call directly from Zendesk. **User Level**: Admin *** > [!TIP] > > Looking for usage guidance?\ > See **[Using CloudTalk with Zendesk](https://help.cloudtalk.io/en/articles/5370637-using-cloudtalk-with-zendesk.md)** guide to learn how calls, tickets, and contacts behave after setup. ## Watch how it works To see the CloudTalk + Zendesk integration in action, watch this short overview: [YouTube video player](https://www.youtube.com/embed/mz-_V6mA-7I?rel=0) ## Before You Start Make sure you have the following: * An active CloudTalk account with **Admin access** * An active Zendesk Support account with **Admin permissions** * Access to **Settings > Integrations** in CloudTalk * Permission to install apps from the Zendesk Marketplace * Permission to manage API integrations in Zendesk The email address used in CloudTalk must exactly match the email address used in Zendesk. Otherwise, automatic ticket assignment will not work correctly. ## Integration Overview **You can set up your Zendesk integration in three ways:** * Only the data integration / synchronization * Only the CTI * Both (recommended) The CloudTalk + Zendesk data integration will sync all existing Zendesk data *(contacts, tickets, emails, etc.)* to CloudTalk, and vice versa. This will allow your agents to have a comprehensive understanding of their customers without having to open multiple systems. Our CTI integration lets agents use our CloudTalk softphone to make and receive calls directly from Zendesk, saving time and energy. ## Connect Zendesk to CloudTalk 1. In the Dashboard go to **Settings > Integrations** in the left menu. 2. Hover over the Zendesk integration and click **`+Add`**. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/db5429e011dc-screenshot-2025-07-24-at-10-59-49.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=5d9785c09160ca1c9491a1bf6ccaa3b6) 3. Enter your **Zendesk domain**.  ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/e81f82aeb2b8-screenshot-2025-07-24-at-11-00-29.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=76193e3a65b625448b409db21857bd3a) 4. You will be redirected to a Zendesk login page to log into your account. Select **Authorize** and follow the authorization flow. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/21225ad7cba9-bm2yopygtvplyzoow1nssyu6xjytkw7z8ieiq-dfrteb8hjzivkr20aeez5o.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=ecdb897af620933de7774cc78a25f834) ## Integration Customization After successful authorization, you will be redirected back to your CloudTalk dashboard, where you can configure how calls, contacts, tickets, SMS, and VoiceAgent data are exported to Zendesk. The integration settings are divided into the following sections: #### General Settings ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/c42549b87dc3-screenshot-2026-02-25-at-13-39-12.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=76ff3b34417c54e796eb18303901e47f) * **Caption** Customize the name of this integration instance * **Contact’s tag** Define a tag that will automatically be added to contacts synchronized from Zendesk * **Synchronize Zendesk tickets** Enable this option to activate ticket synchronization between Zendesk and CloudTalk. #### Call Export Settings ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/039fc0f608b7-screenshot-2026-02-25-at-13-48-09.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=4d916da040e37e10aa1638dfb1d95377) In the **Call export settings** section, you can configure how calls are logged, assigned, and enriched inside Zendesk. 1. **Choose when calls should be logged based on your Business hours policy.**\ You can select how CloudTalk should handle calls in relation to your configured business hours. For example, if you choose **Log all calls**, every call will be exported regardless of time. 2. **Create new contacts in Zendesk for unassociated call numbers.**\ When enabled, CloudTalk will automatically create a new Zendesk contact if a call is made to or received from a number that does not exist in Zendesk. 3. **Import assigned agent of last active ticket as contact’s preferred agent.**\ When enabled, CloudTalk will assign the Zendesk agent from the most recent active ticket as the preferred agent for that contact in CloudTalk. 4. **Choose how call data is exported as internal notes.** You can enable one or more of the following options: 1. **Export entire call as internal notes**\ When enabled, all call details (notes, metadata, links, and recordings) are added as internal comments in Zendesk. 2. **Export only recording and customer links as notes**\ When enabled, only the call recording and CloudTalk contact link are exported as internal notes. 3. **Export only call notes as internal notes**\ When enabled, only the agent’s call notes are exported as internal comments. Internal notes are not visible to customers. 5. **Enable VoiceAgent call logging.**\ When enabled, VoiceAgent calls are exported to Zendesk and labeled accordingly. You can also choose how VoiceAgent tickets are assigned using the **Assign VoiceAgent calls to** dropdown. 6. **Add call recording and transcript to ticket.**\ When enabled, CloudTalk uploads the call recording and transcript to the Zendesk ticket as a voice comment. **Important:** Whether a recording or transcript is exported depends on your Call Export [Workflow Settings](https://help.cloudtalk.io/en/articles/5450779-configuring-workflow-automations.md).\ If a call type is configured not to be logged (for example, outbound unanswered), its recording and transcript will **not** be exported. ### Advanced Call Export Rules You can configure export behavior separately for each call type. Each tab allows you to define how that specific call type is logged in Zendesk. Call types include **inbound answered calls, outbound answered calls, missed calls, and voicemail**. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/ced756707eb1-screenshot-2026-02-25-at-14-00-35.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=548b36b66bab36e6620f36dc0fc16191) #### Per Call Type Settings #### Export Behavior Choose **Strategy for logging calls to tickets.** This setting lets you decide how CloudTalk should log calls into Zendesk tickets. You can choose from three options: * **Create new ticket**: A new Zendesk ticket will be created for every new call made or received in CloudTalk. * **Add to last modified Open ticket**: The call will be added as an internal note on the most recently updated *Open* ticket associated with the contact. (Ticket fields and status are not changed directly, but Zendesk automations may trigger other updates.) * **Do nothing**: Calls will not be logged into Zendesk tickets. This gives you flexibility to control whether each call creates its own record, is grouped with ongoing conversations, or is not logged at all. > [!NOTE] > > If *Add to last modified Open ticket* is selected and no open ticket exists, CloudTalk automatically creates a new ticket using the configured type, status, priority, and assignment settings. > > When logging to an existing ticket, the type, status, priority, and assignment settings do not apply. #### Ticket Creation Timing > [!WARNING] > > This option is only available for **inbound answered** and **outbound answered** calls. Select whether CloudTalk should create a Zendesk ticket when the call is answered or when the call ends. You can choose between two options: * **Answered**: A Zendesk ticket is created immediately when the call is picked up. When the call ends, CloudTalk adds a second internal note that includes call notes and tags. * **Ended**: A Zendesk ticket is created only after the call finishes, containing all call details in a single note. If an agent later edits call tags or notes in **CloudTalk > Call History > Call Details** while the Zendesk ticket is still open, CloudTalk automatically adds a new internal note with the updated information. This setting gives you flexibility: for example, if your team wants to see tickets appear in Zendesk right away or trigger Zendesk workflows as soon as a call starts, use the **Answered** option. #### Ticket Properties (Applied When Creating a New Ticket) These settings apply only when a new ticket is created. * **With type**: Select the Zendesk ticket type (e.g., Problem, Incident, Task). * **With status**: Select the Zendesk ticket status (e.g., New, Open, Pending, Solved). * **With priority**: Select the Zendesk ticket priority (Low, Normal, High, Urgent). #### Assignment Rules Use the **Assign to** setting to control how tickets created for this call type are assigned in Zendesk. You can choose from the following options: * **Automatic assignment** The ticket is assigned to the Zendesk user whose email address matches the CloudTalk agent who handled the call. The Zendesk group is assigned automatically based on the group the agent belongs to at the time of call export. * **Assign to user** All tickets created for this call type are assigned to a specific Zendesk user that you select. * **Assign to group** All tickets created for this call type are assigned to a specific Zendesk group that you select. * **Do not assign**\ Tickets created for this call type are left completely unassigned in Zendesk, with no assignee and no group set. Unlike Automatic assignment, which matches the ticket to a Zendesk user by email, this option guarantees the ticket stays unassigned. This is useful if your own Zendesk triggers or routing rules handle assignment. ### Connected Numbers (for Calls) ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/15212c744b01-screenshot-2026-02-25-at-15-16-15.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=9db6a805567b8917946bf4f691046d45) Use this setting to control which CloudTalk numbers export calls to Zendesk. When you select one or more numbers in the **Connected Numbers (for Calls)** field: * Only calls made or received through the selected numbers will be exported to Zendesk. * Calls from other CloudTalk numbers will not be logged. If no numbers are selected, calls from all CloudTalk numbers will be exported according to your configured call type rules. ### Number Overrides (for Calls) Use Number Overrides to apply different call export rules to specific CloudTalk numbers. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/08d2e43600a0-screenshot-2026-02-25-at-15-23-17.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=8774da16743987c83b17d76a56db2fef) Each number can have its own call type configuration. When a number override exists, it takes priority over the global call type settings. The integration first checks whether a rule exists for the specific number and call type. If no override is configured, the global call type rule is applied. ### Workflow Settings for SMS ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/86cf6a9c8e02-screenshot-2026-02-25-at-15-27-21.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=4d21a17116da76bf04bea1bc444f056b) Use this section to control how SMS messages are logged in Zendesk. * **Export SMS to Zendesk** enables or disables SMS synchronization. * **Log inbound SMS** creates a Zendesk ticket for incoming messages, using the selected ticket status and type. * **Log outbound SMS** creates or updates a Zendesk ticket for outgoing messages, using the selected ticket status and type. ### Custom Field Mapping Admins can map CloudTalk call data to custom Zendesk ticket fields. This allows call details to be automatically stored in structured fields, making them available for reporting in Zendesk Explore. This mapping is triggered when a call ends. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/816bc1f3e720-screenshot-2026-03-27-at-12-31-52.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=f043ee3f5bba8d0d4cad88a75edc7cf6) > [!NOTE] > > To learn how to configure custom field mapping, see [Configure Custom Field Mapping for Zendesk.](https://help.cloudtalk.io/en/articles/14300299-configure-custom-field-mapping-for-zendesk.md) When you're done making changes, click **Save settings** to start synchronization, and don’t forget to toggle **Active** on. You can update integration settings at any time from the integration settings page in your CloudTalk dashboard. ## Install CloudTalk CTI > [!NOTE] > > **Our Zendesk CTI supports both inbound and outbound** use cases. SMS messaging is also available through the **Messages** section of the CTI. #### Steps from Zendesk 1. Navigate to the [Zendesk marketplace](http://Zendesk.com/marketplace) and search for CloudTalk. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/e44e884b7b69-screenshot-2023-08-14-at-18-00-31.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=a946b6f9a6f0857bacd5638a4710bd50) 2. Select the [CloudTalk for Support app](https://www.zendesk.com/apps/support/cloudtalk/). Install. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/a26d60deebfa-screenshot-2023-08-09-at-16-43-45.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=e5e259aa6601c665fd7a5f3c2949b512) 3. Select which Zendesk account you would like to install the app to and select **Install**. (If relevant, make sure this is the same account for which you set up your data integration.) ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/3d0c62415451-select-account-to-install-ct-support.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=a37f83a838a42006691b7275c6af574a) 4. **Optional:** Choose whether to enforce security restrictions on your integration by assigning groups or user roles that can access this integration instance. Select **Update** to finalize. 1. *You can update these settings anytime from your Zendesk admin portal*: `{yourZendeskDomainName}.zendesk.com/admin/apps-integrations/apps/support-apps` ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/1ec944660fc9-ct-for-support-installation.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=e36501f30e50acfa49c277a6a0e05284) 5. Once the CloudTalk for Support app is installed, you will see the CloudTalk logo in the toolbar. Select this logo to log into your CloudTalk Phone if it is your first use, or if you were previously logged in somewhere else. 1. You may need to allow microphone permissions on your browser. 2. During the initial setup, you can select the options for how you want your CloudTalk Phone to behave within Zendesk. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/8223c7d4184c-cti-opens.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=707b555623cda27da661582c2f22e29a) 6. When signed in, your CloudTalk Phone is ready to use within Zendesk. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/547567841a9a-cti-is-ready-to-use-zendesk.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=4dc9f3c6934cd6a2b6e6a4c52148e9d3) > [!WARNING] > > **Already using data sync only?** > > If you previously enabled only the data integration and now want to add the CTI, you do **not** need to reinstall the Zendesk integration. > > The data integration and CTI are independent. Simply follow the steps in the [Install CloudTalk CTI](#:~:text=your%20CloudTalk%20dashboard.-,Install%20CloudTalk%20CTI,-Our%20Zendesk%20CTI) section above to activate the CTI. ## Disconnect or Remove the Integration If you no longer want CloudTalk to synchronize data with Zendesk, you can disable or permanently remove the integration. To **disable the integration**, go to **Settings > Integrations**, locate the **Zendesk** integration, and toggle the status from **Active** to **Inactive**. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/82b8bda3a14d-screenshot-2026-03-27-at-16-06-30.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=5142aeb9f931188a3e1e397d44e1466b) To **delete the integration permanently**, open the Zendesk integration settings, scroll down, click **Delete Integration**, and type **DELETE** to confirm. ![](https://mintcdn.com/cloudtalk/6Hiy83aLw1wFZVvu/images/help-center/articles/3402805/8aed4aaa4354-screenshot-2025-07-03-at-11-57-50.png?fit=max\&auto=format\&n=6Hiy83aLw1wFZVvu\&q=85\&s=2af415f22802e338526edaeae6ca74c1) *** *Need help or have a question?* Just reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we’re here for you. ## Related topics - [Configure Zendesk Sell](https://help.cloudtalk.io/en/articles/3722182-configure-zendesk-sell.md) - [Using CloudTalk with Zendesk Sell](https://help.cloudtalk.io/en/articles/5372885-using-cloudtalk-with-zendesk-sell.md) - [Using CloudTalk with Zendesk](https://help.cloudtalk.io/en/articles/5370637-using-cloudtalk-with-zendesk.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.