An overview of Zendesk's data types and useful facts.
The difference between Zendesk Tickets and Events
Tickets: Every time there is an update to a ticket, we update the ticket with the new status, etc. into the ticket data source.
Events: Ticket events are a bit different and to quote Zendesk's own documentation: "Returns a stream of changes that occurred on tickets. Each event is tied to an update on a ticket and contains all the fields that were updated in that change."
So this means that Ticket Events are more like a historical log of changes on the tickets. So every time you e.g. change a status (or something else) on a ticket, it will create a ticket event.
Currently, Plecto only handles 3 types of events: 'Status change', 'New ticket comment' and 'Custom field changed' - also called 'Action's in the Event data source. For each event we log the new value of the event and the field that changed, which indicates how the change was made.
The Zendesk API is rate limited. This means that only a certain number of requests are allowed per minute depending on your plan and the endpoint.
As an API consumer, you should expect to be able to make the following number of requests per minute per Zendesk Support account:
If you exceed this daily quota, the automatic imports in Plecto will pause until you can ask for more data again and it will resume.
You will see a yellow progress bar on the data source, and if you check the logs on the settings on the data source, you'll see a message saying you've exceeded the daily quota:
Click on "View logs" to show the logs of the latest import jobs from Zendesk.
Please check if you use any other system(s) that might be using up this quota.
How do you get the Client ID and Secret for Zendesk Chat?
To add a client
- Sign in as an admin to Zendesk Chat.
- In the Dashboard, go to Settings > Account, then select the API tab.
- Click Add API Client.
- Complete the following fields:
- Client Name
- Plecto Integration
- Write your own Company Name
- Redirect URLs
- Client Name
- Click Create API Client.
If the client is successfully created, a dialog appears listing a client ID and a client secret.
- For security reasons, the entire string is displayed only once. After closing the dialog, you'll only be able to view the first few characters.
- Add client ID and client secret to Plecto