Configuring an OAuth Application in Zendesk

Overview

In this article we will discuss how to create an OAuth application in your instance of Zendesk. This step is a prerequisite to using Zendesk to create a Virtual Collection in Totango.

Create OAuth client in Zendesk

Follow Zendesk KB documentation to create OAuth client. Note that you must be a Zendesk admin.

Set the following mandatory settings:

• Client Name - Choose a name for your app. This is the name that users will see when asked to grant access to your application, and when they check the list of third-party apps that have access to their Zendesk.
• Unique Identifier - The field is auto-populated.
• Redirect URLs - Enter the value: https://app.totango.com/auth/das/callback
• Secret - Generate a secret key (make sure you save this key)
  
  

Zendesk Collection Details

To retrieve data from Zendesk, we are using the api/v2/search.json REST API. The following definition will retrieve the open tickets, based on the Organization id:

• API Query Endpoint: 

https://[your_sub_domain].zendesk.com/api/v2/search.json?query=type:ticket status:new status:open status:pending organization_id:{Resolved zendesk organization id}&sort_by=status&sort_order=desc

• List mapping (Main object): results

Read more on how to configure a Virtual Collection in Totango!