Setting up Zendesk and Zendesk Guide as a Source

Setting Up Zendesk Guide as a Source

The Zendesk Guide Source can pull data out of a particular Zendesk Guide and generates search records for each Article. You can specify which Brand and which languages (multi-select) to sync.

👥

Access Required

Guru Access: You need to be an Admin in Guru to set up sources.

Zendesk Access: You'll need your Zendesk subdomain and Zendesk API token.

  1. Navigate to Manage > Sources.
  2. Select Zendesk Guide from the icon menu.
  3. Select Configure Integration.
    1. Optional: Rename the Source
  4. Click Next.
  5. In the Authorize URL box, replace with your Zendesk subdomain.
  6. In the Token URL box, replace with your Zendesk subdomain.
  7. Click Connect.
  8. Select the Brand from the dropdown.
  9. Select which languages (locales) you want to bring in.
  10. Click Finish.
  11. Select which Groups you'd like to have access for this Source.
  12. Click Submit.

Objects Synced from Zendesk Guide

This Source will bring in articles from your designated Zendesk Guide




👥

Access Required

Guru Access: You need to be an Admin in Guru to set up sources.

Zendesk Access: You will need your Zendesk subdomain, Zendesk Admin credentials or a Zendesk API key. We recommend connecting using your Zendesk credentials.

Setting Up Zendesk as a Source

✍️

Note

To find your Zendesk API Key:

  1. Within Zendesk, click the Grid icon next to your profile avatar and then select Admin Center from the prompted dropdown menu.
  2. rom here, expand the Apps and integrations dropdown in the left menu and select Zendesk API.
  3. Make sure that token access is enabled, and click Add API token.
  4. Copy the API key and then click Save.
  1. Navigate to Manage > Sources.
  2. Select Zendesk Guide from the icon menu.
  3. Click Authorize Access.
  4. Choose Use your Zendesk credentials (recommended).
  5. You will see a list of fields that will be synched. Click Continue.
  6. Enter your Zendesk subdomain and click Submit.
  7. Authenticate with your Zendesk credentials.
  8. Click Continue when prompted in Guru.
  9. Select which Groups you'd like to have access for this Source.
  10. Click Submit.

Objects Synced from Zendesk


TicketsCommentsAccountsUsers
AccountBodyDomainsAvatar
AssigneesHTML BodyNameEmail Address
Completed TimestampPrivacyIs Active
CreatorRemote Created TimestampName
DescriptionTicket
Due DateUser
Name
Priority
Remote Created Timestamp
Remote Updated Timestamp
Status
Ticket Type
Ticket URL