In this article, we’re going to walk through the process of setting up a Webhook to receive events from JIRA that will “tell“ Deskpro to affect a ticket in some way. For example, we’re going to listen for when a JIRA comment is added and update the Deskpro ticket status.
Why is this useful?
Listening to events from other systems is very useful for keeping Deskpro up-to-date with recent changes that were not actioned through Deskpro itself. You can imagine listening to when an issue is updated in JIRA and then adding a note or changing the status of an associated Deskpro ticket.
Installing the JIRA app
The first step is to install the JIRA app. To do this, navigate to the “Admin > Apps & Integrations > Apps” section of Deskpro.
![](https://support-attachments.deskpro.com/22275/22274705DAKCWNCKKXDRTKP0-image.png)
Click on the JIRA app and install it using your JIRA API credentials. Once the app is installed, go to one of your Deskpro tickets and use the JIRA app to link a JIRA issue to your Deskpro ticket.
Creating the Webhook
![](https://support-attachments.deskpro.com/22275/22274776AQDTSQSBCCTBQMK0-image.png)
Now that we have a linked issue, let’s add a webhook to “listen“ to JIRA events. Navigate to the “Admin > Apps & Integrations > Inbound Webhooks“ section and add a new webhook.
![](https://support-attachments.deskpro.com/22275/22274842NBRSSZBZKRCQBPB0-image.png)
Add the following settings to your new webhook:
Title: “JIRA: Update status on new comment“ - this is the title of your webhook, it’s important to give it a descriptive name so you can tell what the webhook is doing at a glance
Payload Format: “Webhook accepts json payload“ - JIRA will send data in JSON format, let’s set our webhook up to parse this type of data
Filter: “Linked JIRA Issues -- Contains -- twig:{{webhook.data.issue.key}}“ - our filter is going to interrogate the data sent from JIRA and attempt to match the JIRA issue key with the linked Deskpro tickets
Click “Create“ to create the new webhook before we continue
Webhook Trigger and Action
Now that we can listen to and match Deskpro tickets from JIRA events, the next step is to actually “do“ something in Deskpro. In this case, we’re going to update the ticket status to “Awaiting Agent“ if a new comment is added to the associated issue in JIRA itself.
Reopen the webhook and add a webhook “trigger“ and set the criteria to:
Operation: Check Webhook variables
Field: webhook.data.webhookEvent
Operator: is
Value: comment_created
Also, let’s add the “action“ that will be performed:
Type: Set status
Value: Awaiting Agent
Now click “Save“
![](https://support-attachments.deskpro.com/22276/22275090MNPXCNQXHAGSSBR0-image.png)
Ok great! We now have our webhook in Deskpro. Next, let’s let JIRA know about our new webhook URL so it can start sending us events.
Grab the webhook URL by revealing it by clicking “Show URL“ and copying it to your clipboard.
Adding the webhook to JIRA
![](https://support-attachments.deskpro.com/22276/22275177HCHWZXWGDPTPTRS0-image.png)
Login to your JIRA account and navigate to the “JIRA Settings > System“ section in the cog menu at the top right of the screen.
![](https://support-attachments.deskpro.com/22276/22275253NJYMTAJZWJKQTKA0-image.png)
Next, navigate to the “WebHooks“ section in the left-hand sidebar.
![](https://support-attachments.deskpro.com/22276/22275271ADGBMKXQZXXKYBN0-image.png)
Create a new webhook and enter the following details:
Name: “Deskpro Status Change Webhook“ - a descriptive name so we can recognize our webhook at a glance
Status: “Enabled“ - enable this webhook so JIRA starts sending events to Deskpro
URL: The URL in your clipboard we copied from the Deskpro webhook
Issue Related Events: “Comment > created“ - we’re only interested in newly created comments
Click the “Create“ button at the bottom of the webhook screen. That’s it - we’ve created our webhook in JIRA. Tickets associated with JIRA issues will now update their status to “Awaiting Agent“ when new comments are added to issues via JIRA itself.
![](https://support-attachments.deskpro.com/22276/22275296RCQMMPAJNJSYXYR0-image.png)
Добавить комментарий
Please log in or register to submit a comment.