Set up the sync
1
Open Data Sources
Go to AI Training → Data Sources in the OpenCX dashboard.
2
Add a Zendesk source
Click Add source → Zendesk. Paste the credentials below (each field label and placeholder mirrors the dashboard form).
You can reuse the API token from the Ticketing integration. The token just needs to be able to read Help Center articles.
3
Start the sync
Click Connect. The first run pulls every article across every locale — minutes to a few hours depending on catalog size.
4
Verify in AI Instructions
Open AI Training → AI Instructions. Articles appear grouped under Zendesk. Filter by visibility to confirm the eye icon matches expectations — see the visibility rules below.
What gets synced
All article variants, across every locale
All article variants, across every locale
Published, , and articles are all fetched. Each locale is stored as its own entry so the AI answers in the right language.
Visibility is derived automatically
Visibility is derived automatically
Every synced article is tagged public or internal based on Zendesk’s own signals. This mirrors Zendesk’s access model — you don’t configure it twice.
The eye icon in AI Instructions shows the final visibility. Override per-article if you need to.
Incremental sync on updated_at
Incremental sync on updated_at
After the initial pull, only articles whose
updated_at changed since the last run are fetched. Outdated articles marked outdated: true in Zendesk are filtered out before ingestion.Re-sync, disconnect, and re-connect
- Sync now on the source row pulls only articles changed since the last run. Use after a bulk edit in Zendesk.
- Remove on the source row deletes the connection and the synced items. The articles in Zendesk aren’t touched.
- Re-adding the source re-pulls everything from scratch.
Limits
Related Documentation
Zendesk overview
Scope and dual-presence context.
Troubleshooting
Auth failures, visibility surprises, archived content.
Zendesk integration
Ticketing, Sunshine, channels.