Zendesk with VSTS
If you use Zendesk to support your customers, you can create work items in VSTS directly from your Zendesk tickets. Then you can configure VSTS to update the Zendesk ticket when the work item is updated.
Install the VSTS app for Zendesk
Download the .zip file that contains the VSTS for Zendesk app from GitHub.
If you don't have a Zendesk account, get one.
Go to your Zendesk administration page to mange your apps.
Upload the VSTS for Zendesk app .zip file
Install and configure the app
If you use a work item tag, work items you create from Zendesk will have that tag. Later, you can use it to find items that were created from Zendesk.
Each user of the app must provide credentials so that the VSTS app can create and query work items as that user. Creating a personal access token is recommended.
Navigate to the VSTS account you associated with your Zendesk account (from step 5 above)
Open the profile menu and select Security
Create a personal access token
- Give the token a recognizable name so you can find it later if you need to revoke it or check its expiration date
- Scope the token to the account associated with Zendesk
- Limit to at least Work item (read and write)
Copy the token and paste it into the Password field of the VSTS app in Zendesk
- If you are running version 0.5.0 or higher of the app, you do not need to specify a Username. Otherwise, supply any value into the Username field (for example "me").
Create a work item from Zendesk
Go to a ticket in Zendesk and log in to the VSTS for Zendesk app.
Add a work item to VSTS based on this ticket.
Create the work item.
Open the work item in VSTS directly from Zendesk.
In VSTS, the work item is tagged with the tag you set up , and it's linked back to the ticket in Zendesk.
Configure VSTS to update Zendesk tickets
Close the loop by configuring VSTS to update the Zendesk tickets whenever there's a change in the work items that were created from Zendesk.
Go to the your Zendesk API administration page.
Enable token access and copy your token.
Go to your VSTS project service hooks page:
Click Create Subscription.
Start configuring Zendesk.
Use the Work item is commented on event. You can filter for comments, too. For example, you can only act on comments that contain the string "Zendesk:" and only those comments will be reflected back to Zendesk.
Configure the action that Zendesk will take in response to that event. This is where you provide the Zendesk access token.
The Zendesk documentation states to append the User name with "/token". Do NOT include this on the User name as the integration already accounts for this.
Now when you comment on the work item, a private comment will be added to the Zendesk ticket.
VSTS doesn't charge for the framework for integrating with external services. Check out the specific service's site for pricing related to their services.
Q & A
Q: Why do I keep getting prompted for a user name and password?
A: If you supplied a Personal Access Token (recommended) in the login panel of the app, make sure the token is scoped either to "all accessible accounts" or to the specific VSTS account configured in the app's settings. To open the app settings from Zendesk go to Settings > Apps > Manage.
Also make sure the token has not expired and that it has the Work items (read and write) scope.
For more details, see the Authenticating section above or the Authenticate access with personal access tokens topic.
Q: Can I programmatically create subscriptions?
A: Yes, use the REST APIs.