HELP ARTICLE

Configuring the Dynamics CRM – Zendesk Templates


This document will walk through the required steps to enable and configure the Zendesk service provider as part of the REST connector. After the service provider is setup then the map templates can be imported and configured as well.

General Information

The Zendesk and Dynamics CRM templates consist of 8 maps. There are integration point between the following points:

  • Zendesk Organizations to Dynamics CRM Accounts
  • Zendesk Users to Dynamics CRM Contacts
  • Zendesk Tickets to Dynamics CRM Cases


There are 2 versions of the Users to Contacts map, one version will sync all Zendesk users to contacts while the other version will only sync users categorized as an end-user in Zendesk. End-users are generally the users that are opening the support tickets and would be best suited to be tracked as contacts in Dynamics CRM. If internal users or agents can open tickets as well then the full contact and user integration would be the best option.

For every integration, a Bulk version and a Change version of the map exists. The set of bulk maps are intended for an initial sync of data from Zendesk to Dynamics CRM. Once that is complete, the change maps are designed to be scheduled as an ongoing process to keep the two systems synced up.

Any of the mappings can be changed or configured once the integrations are imported into SmartConnect, so additional fields can be included or even new maps can be added to fit specific needs.

Prerequisites to using these templates are as follows:

  • Have a valid Dynamics CRM and Zendesk instance/organization
  • SmartConnect 20.16.0.37 or higher installed and registered
  • Dynamics CRM Connector already configured within SmartConnect

 

Import and Configure the Service Provider

  1. Click on the “Maintenance” tab within SmartConnect
  2. Click the “Import” button within the REST Connector section
  3. Browse to and select the “REST_Connector_Zendesk.xml” file for the import
  4. Mark the Zendesk service provider box for import

Import REST Settings

  1. Click the “Import” button to bring in the service provider definition
  2. Close that window and click on the “Service Providers” button
  3. Double-click the “Zendesk” provider from the list to open the provider setup windows
  4. Double-click the “Authorization” parameter from the list

REST Properties

  1. The “Default Value” needs to be set with a valid authorization key, which can be obtained by using Postman
  2. Download/install postman through chrome, and when it opens up put any GET request path into the URL (https://eone.zendesk.com/api/v2/users/me.json is a request that should always work) – make sure it is using the subdomain from the correct Zendesk instance

GET Request

  1. Then put in your username and password using Basic Auth, and click the “Update Request” button

Authentication

  1. It will generate the value that needs to be copied into the Authorization parameter default value, switch to the “Headers” section to find the authorization key

Authorization

  1. Save the REST Parameters window once the value is copied in
  2. Switch to the Methods tab in the REST Service Provider window
  3. Each method in the list needs to have its URL path updated to use the correct Zendesk instance subdomain – by default they will all point to eone.zendesk.com
  4. Double-click on the first method to open the setup window
  5. Replace the “eone” subdomain with the correct value in the URL field

REST Method

  1. Save that setup window and repeat that process for each method in the list
  2. Once all the methods are updated, save and close the REST Service Provider window


Import and Configure the Dynamics CRM – Zendesk Maps

  1. Click on the “Maintenance” tab within SmartConnect
  2. Click the “Import Wizard” button within the SmartConnect Maintenance section
  3. Select the “Zendesk_Crm_Maps.sce” file and import its contents

Import Zendesk

  1. Once the import completes, navigate to the Maintenance tab within SmartConnect
  2. Click on the “MSSQL Defaults” button and then double-click the “SMARTCONNECT_DB” item to open it
  3. Update the connection information in the SQL connection to point to the correct SmartConnect server and database and then save the changes

SQL Servers


Final Steps

  1. Choose which Zendesk User to Dynamics CRM Contacts map to use, only one is needed:
  2. The Map with the suffix of _ENDUSERS will integrate only users flagged as end-users in Zendesk over to Contacts in CRM
  3. The basic Users to Contacts map will integrate all Zendesk users over to contacts in CRM
  4. Run the bulk maps to perform an initial sync of data
  5. Maps should be run in the following order
    1. BULK_ZENDESK_ORGS_TO_CRM_ACCOUNT
    2. BULK_ZENDESK_USERS_TO_CRM_CONTACTS (_ENDUSERS)
    3. BULK_ZENDESK_TICKETS_TO_CRM_CASES
  6. Schedule the maps that have the prefix of CHANGE_ on whatever schedule is desired:
  7. A 5 minute interval should be the quickest timeframe in which the maps are set to repeat, this is recommended as the Zendesk API has a minimum interval of 5 minutes when determining changed records

 

RECENT POSTS


Global Variables in SmartConnect.com
SmartConnect Setup for Office 365 E-Mail with TLS
Excel data sources work intermittently or give blank error message.
How to set up automatic payments on eOne's website portal
"Info 1625. This installation is forbidden by system policy", when attempting to install the SmartConnect Excel Add-In

POPULAR POSTS


SSL Security error using OLEDB Connection
Removed Part: /xl/vbaProject.bin part. (Visual Basic for Applications (VBA))
The server process could not be started because the configured identity is incorrect.
Using WINSCP and a task to upload or download files from an SFTP site
Shortcuts Template for Extender

CATEGORIES

ARCHIVES

open all | close all

TAGS

Business Central CRM Dynamics 365 dynamics crm Dynamics GP Dynamics NAV Econnect Employee Spotlight eone eOne News error Error Message Events Excel Excel Report Builder Extender Flexicoder GP GPUG integration Meet the Team Microsoft dynamics crm Microsoft Dynamics GP Navigation List Builder Office Relationships partners Popdock release Reporting SalesForce SalesForce.com scripting SmartConnect SmartConnect.com SmartConnect Bootcamp SmartConnect Office Hours SmartList SmartList Builder SmartView SQL Support Tech Tuesday Templates training Zendesk

Integrate & Automate without Any Code.

SmartList Data has Never Been Faster.

The Easiest Way to Report on GP Data.