Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To send data out from your Azure DevOps instanceIn order for the Zendesk meshlet to connect to Zendesk to create and update tickets as well as query for changes to push to the other application being integrated, you will have to create two webhooks which will be triggered by creating or updating Task work itemsneed to enable API access in Zendesk.


Procedure

To create the webhooks that will share data out of Azure DevOpsenable API access in Zendesk, follow these steps:


UI Steps


UI Step
Access project 

Go to the Admin Center

In Azure DevOpsZendesk, select the project that contains the work items you want to share out.the icon at the bottom of the left navigation menu and click on the Go to Admin Center link.

Image AddedImage Removed


UI Step

Access

Project settings

In the bottom left-hand corner, click Project settings. Then, click Service hooks.

Image RemovedImage Removed

Zendesk API settings

Select the Apps and integrations option and then scroll down and choose the Zendesk API option underneath APIs.

Image Added



UI Step

Create new webhook

Click Image Removedto create a new webhook. Then, select Web Hooks as the service to integrate with. Click Next

Image Removed

UI Step

Configure the trigger and filters

In the Trigger, select Work item created for the trigger event. In the Area path under Filters, select the current project. Then, select Task in the Work item type filter. Click Next.

Image Removed

UI Step

Configure the action

Fill in the URL and the basic authentication credentials. Contact Perspectium Support to receive the URL and basic authentication credentials.

Select HTML for both Messages to send and Detailed messages to send fields.

Click Finish to complete the webhook setup.

Image Removed

Enable API access

Toggle API access by sliding the toggle to the right for Password access and/or Token access. You can enable either option or both options for the meshlet to connect to Zendesk.

Image Added


(info) NOTE:  If using Token access, click on the Add API token option to create a new token and copy this token down so you can enter it in the meshlet configuration file. Make sure to save this token value here as it will not appear again after leaving this page. Then click Save to save the token into Zendesk.  

Token access requires setting the apiTokenAuth configuration to true in the meshlet configuration file. See 

UI Step

Repeat the above steps

Repeat the above steps to capture updated Work items. However, in Step 4,  choose Work item updated for the trigger event. Then continue with the rest of the above steps.