Zendesk Knowledge
Connect Zendesk Help Center articles to Jimo AI Knowledge and train your project on published Guide content.
Overview
The Zendesk Knowledge integration connects Jimo AI Knowledge to your Zendesk Help Center. It lets you use published Zendesk Guide articles as training content for your project's AI Knowledge.
This integration is for Zendesk Knowledge and Guide content only. It does not connect Zendesk Support tickets.
Prerequisites
Before you start, make sure you have:
A Zendesk account with Help Center or Guide enabled.
Published articles in Zendesk that you want to use.
A Zendesk user email allowed to use API access.
Access to create or view API tokens in Zendesk Admin.
Never share API tokens in tickets, chat, or email. Treat them like passwords.
Enable the integration in Jimo
In Jimo, go to Settings → Integrations → Zendesk Knowledge.
Add the integration for the project.
Open the integration settings page.
Enter the required Zendesk credentials.
You only need to add this integration once per project.
Get Zendesk credentials
Find your Zendesk subdomain
Open your Zendesk URL in the browser.
Copy only the host prefix.
Do not include
.zendesk.com.
Example:
If your Zendesk URL is
https://acme.zendesk.com, the subdomain isacme.
Choose the Zendesk email
Use the email of the Zendesk account that will authenticate API calls.
This is usually an admin or agent account.
Follow your organization's access policy.
Example:
Create or copy the API token
In Zendesk, go to Admin → Apps and integrations → APIs → Zendesk API → API tokens.
If your Zendesk Admin uses different wording, use the equivalent path.
Create a new API token, or copy an existing one.
Store it securely.
Jimo stores the token securely after you save it. If a token is already saved, the field shows a masked placeholder. Enter a new token only when you need to rotate it.
Make sure to enable the use of API Token. Zendesk Admin should prompt you with a warning message if API Token aren't enabled in your Zendesk workspace.
Save and verify in Jimo
Enter the subdomain and email in Jimo.
Save those identity fields first.
Enter the API token if required.
Save again.
Select Test connection.
A successful test confirms Jimo can reach your Zendesk Help Center with those credentials. Run the test before training Knowledge content.
If the test fails, check these first:
The subdomain format.
The Zendesk user email.
The API token value.
The Zendesk user's admin or API permissions.
Using Zendesk content in Jimo AI Knowledge
In Jimo, go to AI Knowledge → Sources → Add source → Zendesk Knowledge.
If needed, enter a source name.
Keep the default name, or use a custom name such as
Zendesk Knowledge.Choose the article scope.
Select Train to create the source and start training.
Article scope options
All articles
Choose All articles to train on every published Help Center article.
Use this when the full help center should inform the AI.
Specific articles
Choose Specific articles to train on a subset of content.
Browse or search the article list. Then select one or more published articles and start training.
Use this when you want tighter scope.
If the integration is not fully configured, Jimo should direct you back to Settings → Integrations → Zendesk Knowledge. Complete the subdomain, email, and token setup first.
Operational notes
Rotate the API token
Generate or copy the new token in Zendesk.
Open the Zendesk Knowledge integration settings in Jimo.
Replace the saved token.
Save the change.
Run Test connection again.
Disconnect the integration
If your team removes Zendesk or stops using this connection, disconnect it from the integration settings in Jimo. After disconnecting, new access to Zendesk content stops until the integration is configured again.
Troubleshooting
Wrong subdomain format. Enter only the prefix, not
.zendesk.com.Invalid or expired API token.
Zendesk user lacks permission to access Help Center content through the API.
Credentials changed in Zendesk but were not updated in Jimo.
Last updated