Overview
The Zendesk connector brings supported ticket conversations and their associated information into Ender Turing for analysis. You can connect through Sign in with Zendesk, Paste OAuth access token, or Client ID and secret.
This article covers the Zendesk entry in the Apps catalogue. Zendesk Chat is a separate connector with its own connection settings.
How It Works
Before you start
In Ender Turing, you need the Marketplace Configuration permission to open and manage Apps.
Have your Zendesk subdomain ready. For
your-company.zendesk.com, enteryour-company.Ask a Zendesk administrator for the credentials for your chosen connection method. The Zendesk account behind the connection must have access to the data you want to import.
OAuth access must include the read scope. A token limited to
tickets:readdoes not meet this connector's requirement.
Find your client ID and secret
For Client ID and secret, use a Confidential OAuth client in Zendesk.
In Zendesk Admin Center, open Apps and integrations → APIs → OAuth clients.
Select the OAuth client created for Ender Turing and open Edit.
Copy Identifier into Ender Turing's OAuth client ID field. For example, an Identifier of
enderturingmeans the client ID isenderturing.Use that client's Secret in the OAuth client secret field. The client name, numeric ID in the browser address, access token, and secret are different values; use the field labels to match them.
If Allowed scopes restricts the client, ensure it permits read.
If there is no client for Ender Turing yet, a Zendesk administrator can click Add OAuth client, fill in the client details, choose an Identifier, set Client kind to Confidential, and allow read. Save the client and copy its generated secret. The Client ID and secret connection method does not require a redirect URL.
Zendesk displays a newly created secret in full once. If you no longer have it, ask your Zendesk administrator to provide a replacement. Regenerate in the client's Secret section changes the client secret; it does not produce the access token for the Paste OAuth access token option.
Zendesk's OAuth setup instructions explain where these fields are maintained.
Open the connection form
For an existing connection:
Open Settings → Apps.
Choose Installed, then open Zendesk.
Open Actions → Change app credentials. This action is available while the connection is healthy as well as when it reports a problem.
Select a Connection method.
For a first connection, find Zendesk in the catalogue and click Install, then choose the connection method.
Connect with a client ID and secret
Choose Client ID and secret when you want Ender Turing to maintain access automatically.
Enter your Zendesk subdomain for a new connection. An existing connection keeps its saved subdomain.
Enter the OAuth client ID and OAuth client secret from the same Zendesk client.
Click Save changes.
Ender Turing checks the credentials and connection before saving. If a check fails, the form stays open and the previous credentials remain saved. Correct the reported problem and try again.
On later updates, the saved client ID is shown and the secret field starts empty. Leave the secret blank to keep the saved secret for that client ID. Enter a secret when changing to another client or replacing the current secret.
Connect with an existing OAuth access token
Choose Paste OAuth access token when your administrator has supplied a token for the connection.
Enter your Zendesk subdomain for a new connection.
Paste the token into OAuth access token.
Click Save changes.
The token must be valid and include read access. The form shows the saved token's expiry when Zendesk supplies that information. This option requires you to provide a replacement when the token expires. Choose Client ID and secret if you want access to be maintained automatically.
Connect through browser sign-in
Select Sign in with Zendesk.
Check the Zendesk Subdomain and any prefilled CSAT Field ID and Campaign Field ID values.
Click Install Zendesk and complete the sign-in and approval in the popup.
While the sign-in popup is open, Connection method, Cancel, and Install Zendesk are unavailable. Closing the popup ends the attempt and closes the form. To use another method, open the form again and choose it under Connection method.
Allow popups for Ender Turing if your browser blocks the window. If the window takes you to a public website instead of an approval screen, ask your Zendesk administrator to check the sign-in route for staff accounts, or use credentials they supply for one of the other methods.
Keep CSAT and campaign settings
Changing credentials preserves the existing installation, conversation history, synchronization progress, CSAT Field ID, and Campaign Field ID.
To edit the mappings, use Actions → Update settings on the Zendesk details page. Keep the existing field IDs unless you intend to change which Zendesk custom fields supply CSAT and campaign information. You can change credentials without opening this settings form.
Secret fields are not displayed back after saving. Reopening the credentials form lets you supply replacements.
Check synchronization after reconnecting
Review Connection status, the last synchronization time, and the synchronized conversation count on the Zendesk details page. A successful connection check confirms access; importing and processing conversations can finish later.
Changing credentials does not itself request a new historical import. To fetch an earlier period, use Actions → Sync more historical conversations and choose the number of days you need.
Resolve common connection problems
What you see | What to check |
Credentials could not be validated | Match the client Identifier and current secret from the same Zendesk account, or ask for a valid replacement access token. |
The token needs the read scope | Ask the Zendesk administrator to provide read access and confirm the client's allowed scopes permit it. |
The access token has expired | Use Change app credentials to paste a replacement, or connect with Client ID and secret. |
The form asks for a secret after you change the client ID | Supply the secret belonging to that client ID. |
A subdomain change is refused | Use the subdomain already connected to this installation. Ask your Ender Turing administrator before connecting a different Zendesk account. |
Connection is healthy but recent conversations are missing | Review the last synchronization time and allow processing to finish. Request the missing historical period if needed. |
For catalogue access, settings, and general connector actions, see Apps.
