ZenDesk to Microsoft CRM integration password change

Changing your password in ZenDesk may affect your Microsoft CRM integration

 if you are to upgrade or change the password that you utilise in your ZenDesk system for the account that has been set to synchronise data with the Microsoft CRM platform, you will notice that the synchronisation may not function correctly or may only perform a one-way synchronisation. 

You will remember from the instructions that you likely followed in your initial configuration: http://www.interactivewebs.com/blog/index.php/zendesk/zendesk-to-crm-2015-integration/  

 that part of these configuration settings is to set up your password and username in the SETTINGS / ZD Personal Settings –  area of your Microsoft CRM system.

 Below is an extract from the vendor’s configuration portal found here

Step 2: Setting up new security roles

The Zendesk integration introduces two new security roles to Microsoft Dynamics CRM that must be assigned before you can proceed to the next step:

  • Zendesk – Read configuration settings – grants the user  access to Zendesk ticket details in read-only mode  To gain access to create/edit Zendesk tickets functionality directly from Microsoft Dynamics CRM, these users must have a valid Zendesk liecense and enter their own personal Zendesk credentials on the ZD Personal Settings page.
  • Zendesk administrator – grants access to the global Zendesk Settings page and the Zendesk Entity mappings .  Have full access to create/edit Zendesk tickets directly from Microsoft Dynamics CRM.

By default, all users can view Zendesk ticket information in Microsoft Dynamics CRM if the panels are enabled.

To enable the roles, do the following:

  1. In Microsoft Dynamics CRM, select Settings System Administration Users .
  2. In the Users page, click New if you need to add new users. 
    If you are editing a list of existing users, select the user you want to modify and click on the Manage Roles button.
  3. In the Add Users dialog box, select the role for the group you want to configure. 
    The two new roles created by the Zendesk integration are at the bottom. Click Next to select and assign the users to a particular role and to send email invitations.  Make sure you give yourself the Zendesk administrator role for now so you can complete the setup.

Users are now configured to use the Z endesk for Microsoft Dynamics CRM integration!  If you have pre-existing users, you can simply add the appropriate roles to each of your uses.

Note: For users with the Zendesk – Read configuration settings permission, they can individually add their own credentials by navigating to Settings->ZD Personal Settings in Microsoft Dynamics and clicking the New button to add credentials. Enter the Zendesk User ID andPassword then save the record and it will be applied when they access Zendesk tickets. The password will be encrypted so others cannot see the value. 

Zendesk to CRM 2015 and Microsoft Dynamics 365 Integration

Installing the Zendesk to CRM 2015 or Dynamics 365 integration

These instruction have been updated from the Zendesk instructions provided here: https://support.zendesk.com/hc/en-us/articles/203660156-Zendesk-for-Microsoft-Dynamics-CRM-Part-1-Installing-the-Zendesk-for-Microsoft-Dynamics-CRM-as-a-module-in-Microsoft-Dynamics-CRM


They use a combination of the original processes that Zendesk have created originally for CRM 2011 and that worked on Pre SP1 versions of CRM 2013. The packages referenced have been update by InteractiveWebs to work with CRM 2013 Post SP1 and CRM 2015 (technically all versions but we recommend post SP 0.1)


Instillation of the CRM Solution

Install the CRM Managed Solution as you would any other CRM solution.

Download the managed solution for CRM 2015 https://www.dropbox.com/s/0rhlgnxcwz9s4yh/ZendeskDynamicsCRMConnector_2_0_0_2_managed.zip?dl=0


Click on Import

Screenshot 2015 06 18 17 45 23

Chose File

Screenshot 2015 06 18 17 47 09


Select the Managed CRM package – Click Next

Screenshot 2015 06 18 17 49 51

Click Next

Screenshot 2015 06 18 17 51 30


Leave the Enable any SDK ticked, and click on Import

Screenshot 2015 06 19 23 39 37


Allow the Import to take place

Screenshot 2015 06 19 23 40 43


Click on Close

Screenshot 2015 06 19 23 42 16


On Completion, Click “Publish All Customisations”.

Screenshot 2015 06 19 23 43 04


Update Security Roles

In the CRM menu, select Settings / Security

Screenshot 2015 06 19 23 45 15


Select the User that you wish to use to bring in Zendesk Integration Items. We are using in this example the Administrator account, but it could be anyones account.

Then with the account loaded, select the additional item dropdown menu to the far right of the top level menu, selecting Manage Roles

Screenshot 2015 06 19 23 48 51


Select Zendesk Administrator

Screenshot 2015 06 19 23 50 18

There is also a Zendesk Read configuration setting. The Zendesk support site has details on how this can be used.




Screenshot 2015 06 19 23 47 22

Double Click on that name to load the account.


Configure Entity Mapping

In your browser, click on Refresh to reload the CRM page, and in turn the top level menu that has been updated after import for the Zendesk Solution.

In the CRM system, select Settings / Zen Entity Mappings

Screenshot 2015 06 19 23 54 49


Click + New

Screenshot 2015 06 19 23 55 47


The most typical setups are things like on a “Contact” entity, match the Zendesk ticket requester with the email address on the “Contact” record. But what if you wanted to match of the “Full Name” field instead in both systems?  Now you can by utilizing entity mappings.


  • Select the following items

    • Entity Name – This is the Microsoft Dynamics entity that you want the mapping applied to.
    • Zendesk Object – This is where you can select which object from Zendesk you’d like to pick your field from.
    • Zendesk Field – This will populate with values depending on your selection from Zendesk Object.
    • Entity Field – This is a list of fields associated to the selected Entity Name.  Pick which field you want to match to the Zendesk Field.Click “Save” to store the mapping. 
  • Click the ZD Entity Mapping tile to return to the page. 
  • Repeat steps 1-5 if you wish to add more mappings for additional Entities..


Here’s a list of the most common types of mappings:


  • Account/Organization Entity
    • Entity Name: “Account” or “Organization”
    • Zendesk Object: Organization
    • Zendesk Field: Name
    • Entity Field: Account Name
    • Contact/Lead Entity
      • Entity Name: “Contact” or “Lead”
      • Zendesk Object: User
      • Zendesk Field: EmailAddress
      • Entity Field: EmailAddress 1


Configure Zendesk Settings Page

In CRM Navigate to Settings / ZD Settings (Note that this one is not the ZD Personal Settings Menu Item).

NOTE – This works best in Chrome – We found troubles with IE and Safari (not our work)!


Screenshot 2015 06 20 00 11 05

You now need to set up your Zendesk credentials so that the system can authenticate to the appropriate Zendesk instance.

To do so, navigate to Settings, then locate the Zendesk Settings->Settings title and click the title.

You will be presented with 4 sections:

  • Ticket view defaults  – global default settings for ticket views in the Zendesk ticket panel. 
    This sets the defaults at the account level, but can be overwritten by individual preferences by each user.
  • Filtering – sets the default values for filters in the Zendesk ticket panel.
  • Sorting – sets the default sort order for tickets in the Zendesk ticket panel.
  • Authentication – enter your Zendesk subdomain (make sure you specify HTTP vs. HTTPS if you have SSL enabled) and login credentials (you need administrator credentials). 
    This gives your Microsoft Dynamics CRM users read-only access to available tickets. To create or edit tickets from Microsoft Dynamics CRM, your Dynamics users must have a Zendesk license, and they will need to enter their own credentials (explained later in this article).  
  • Mapped record types – enables you to modify the data elements that display in a Zendesk user profile when a ticket is loaded. 
    You can choose from LeadContact, and Account. All fields are available, including custom fields.
  • Ticket-to-case mapping – identifies data items that should be mapped from standard Zendesk ticket fields into Microsoft Dynamics CRM cases. 
    The three Zendesk fields that are supported are StatusPriority, and Type.


Add Zendesk Ticket Grid

Now you are ready to add the Zendesk ticketing panel to any of the entity pages that you’ve configured mappings for. You need to repeat the steps below for each entity type you want the ticketing grid displayed on.

  1. In Microsoft Dynamics, navigate to the first entity where you want to add the ticketing grid. 
    For this example, we’ll refer to a Contact record.
  2. Select any contact in your list and navigate to the Form Editor.
  • In Dynamics 2015, highlight the More (…) tab(1) and select the option for Form(2) to start the form editor.Form2013-1.png
  • In Dynamics 2011, navigate to the Customize (1) tab and click on Form (2)Form2011-1.png
  • In the Form Editor, click the Insert tab (1), then click the Web Resource button (2).Form2013-2.png
  • In the Add Web Resource page, click the magnifying glass next to Web resource to find the Zendesk ticket grid (zd_/Pages/TicketGrid/TicketGrid.html).Form2013-3.png
  • In the next page, select the check box next to zd_/Pages/TicketGrid/TicketGrid.html, then click OK.
  • Back in the Add Web Resource dialog box you should see zd_/Pages/TicketGrid/TicketGrid.html in the Web resource field. Enter a Name and Label you can easily recognize (consider naming it Zendesk Ticket Panel). Check the box for Pass record object-type code and unique identifier as parameters.  
    Click OK. 
  • ou now have a Zendesk ticket panel in the form layout that you can drag anywhere you’d like on the page. You can even create a special subsection for it if you’d like.
  • After you place the panel, navigate to the Home tab, click Save, then click Publish
  • Refresh the contact page you had open and you should see the new Zendesk ticket panel where you placed it!  Form2013-5.png
  •  Repeat these steps for any other entities you have created mappings for.


Configuring InteractiiveWebs Zendesk to CRM 2015 or Dynamics 365 Web Service

Next you need to enable your CRM instance to use the InteractiveWebs Web Service that will connect Zendesk to your CRM instance either in the cloud, IFD or on premises.

If you have an IFD instance or a Microsoft Hosted Cloud

instance of CRM then go here: http://www.interactivewebs.com/Admin/Zendesk/tabid/3566/Default.aspx

If you have never registered with InteractieWebs then click on “Subscribe Now”

 Screenshot 2015 06 20 19 08 05

Fill in the form with the following details.

Username: Select a user name to use with our website.

Password: Select a password to use on our website

Email: Be sure to use a valid email address. We will not share or spam you, but for services we need this to be accurate.

First Name: Your First Name

Last Name: Your Last Name

CRM Address: This is the address of your CRM server in the following format: e.g.. https://contoso.hostedcrm.com:444/  You type “contoso.hostedcrm.com” (without the  “ “ ).

CRM Organization: You administrator can help with this, but in the example above it is “contoso” and is usually the word before the domain of your hosting environment.

You can contact us on the help link at the bottom of the page if you are not sure what you should type here.

Screenshot 2015 06 20 19 15 01


If you have an on premises CRM solution

you will need a custom version of the web service to host on your own servers. Contact us at our website: http://www.interactivewebs.com/ContactUs/tabid/55/Default.aspx

and advise that you are after a custom web service for Zendesk to CRM 2015 integration. Advise us of:

1. The URL you use to access your CRM internally.

2. The Organisation name you use in CRM.

We can then provide you with a custom web service for $200 one off fee with no expiry date on the web service.


Zendesk Setup – Display of CRM Data

It is possible to display the user data from Microsoft CRM in the Zendesk tickets. To do this:

1. In Zendesk select Admin

2. Select Apps / Market Place and search the words – “Microsoft Dynamics”

3. Install the App – Microsoft Dynamics

Screenshot 2015 09 15 04 27 23

Under Manage – you should see the app installed:

Screenshot 2015 09 15 04 28 09

Installing this will allow you to select the “User Data Lookup” Feature that is explained in the next section below.

Screenshot 2015 09 15 04 29 03 – Found in the Extensions / CRM in Zendesk.


Setup Zendesk Settings

Now you will need to set up the Zendesk side of the integration.

To do this, you login to your Zendesk interface and Admin / Extensions 

Screenshot 2015 06 21 09 12 10

In Extensions you select CRM

Select Microsoft Dynamics CRM 2011 (For all versions of CRM including Dynamics 365)

Screenshot 2015 09 15 04 30 17

Select your hosting type

Screenshot 2015 09 15 04 30 36

If you have IFD or Microsoft Cloud Hosted Solution, select Cloud or IFD respectively

FOR CRM versions before Dynamics 365 (up to CRM 2016 pre SP1)

For the Web Service (having subscribed to the service) put in:

https://zendesk.interactivewebs.com  (note that this will only work if you have subscribed)

Screenshot 2015 09 15 04 31 03

For Dynamics 365 (or CRM versions after CRM 2016 SP1)

Because the SDK was updated for Dynamics 365 we have created a web service URL unique for later versions of Dynamics 365. Use the

URL: https://zendesk365.interactivewebs.com (note that this will only work if you have subscribed)


If you have an on-premise then select that and put in the URL of your web service that was supplied to you after contact InteractiveWebs for a custom solution.

All the other data for that page is per the instructions and help provided by Zendesk in their help pages found here: 





If you have problems or questions, please feel free to contact us at: http://www.interactivewebs.com – We have a range of other integration products, including website to CRM integrations for forms, billing, kb, support and more.



Import KB Articles from Microsoft CRM to Zendesk


Zendesk KB Import Tool / Sync

We have created a tool that allows the importing of Microsoft CRM (IFD) into your Zendesk setup.


The simple tool will look at your Microsoft CRM 2011 Articles (also known as KB articles) and draw them into your Zendesk support portal.

This is powerful if you have an existing CRM system with useful client data that you wish to expose to your support portal as a way of helping your customers find answers to their questions before they directly lodge a support ticket.

Additionally, the tool is smart enough to remove duplications. So if you run it against more than one instance of CRM, you can import KB articles without the fear of duplicating up on KB articles.

At the Zendesk end, the KB articles import something like this:


From original articles in CRM like this:




We have at this stage only release a version that runs as a Windows installable program, and connects to an IFD deployment of CRM. This is because we don’t anticipate a huge demand for the tool, and the only need we had was for this type of setup.

We are releasing the Source Code for the program, so that others can update it to their needs. Alternatively we would be happy charge a small amount to customize it to other particular needs.

In the near future we are going to update the tool to convert WordPress posts into Zendesk Knowledge Base Articles.

Please feel free to give feedback and or ask questions on what you would like to see in this too.