Jira is a proprietary issue tracking product developed by Atlassian that allows bug tracking and agile project management.
With the Zenduty 2-Way integration, you will be able to not only create Issues in Jira through Zenduty, but also have it binded 2-Way such that the Issue controls the status of the Incident in Zenduty.
To integrate Jira with Zenduty, complete the following steps:
To add a new Jira integration, go to "Teams" on Zenduty and click on the "Manage" button corresponding to the team you want to add the integration to.
Next, go to "Services" and click on the "Manage" button corresponding to the relevant Service.
Go to "Outgoing Integrations" and then "Add New Outgoing Integration". Give it a name and select the application "Jira(Two-Way)" from the dropdown menu.
Go to "Configure" under your Outgoing Integrations.
There are Several fields to be added here, Starting off with the "Jira URL". This can be obtained by checking the URL of your Jira Domain.
For example - https://your-domain.atlassian.net/
Then insert the Email to which your Jira Domain is linked to.
Next, the Project ID/Project Key, which can be found at the Project table in Jira under "Key" for the project you want to implement Jira with. For example, your project key may look something like - ACME, TES, INC or something else
You can also get it from your URL - https://your-domain.atlassian.net/jira/servicedesk/projects/TEST/
Next Insert the Issue Type the Jira Issue should be Regarded as, The different types of Issue types can be found in the Jira Settings, under a sub category called "Issue Types".
Then finally we need the Jira API key, this can be obtained by :
- Logging in to https://id.atlassian.com/manage/api-tokens
- Click Create API token.
- From the dialog that appears, enter a memorable and concise Label for your token and click Create.
- Click Copy to clipboard, then paste the token.
Proceed by clicking "Save & Next"
Next, Incident Response Mapping is needed. Map the appropriate incident status to the loaded statuses that Jira can transition the issue into.
Similarly, Issue mapping is also needed for 2-Way integration between Zenduty and Jira. Map the Issue statuses to the Incident statuses so issues can trigger a transition in status in the linked incident.
Do watch out for cyclic mapping of the incidents.
- Copy the generated Webhook URL to be added to Jira.
Log in to your Jira account.
Go to settings and then click System. Scroll Down towards "Webooks"
Click on Create a WebHook.
Add a Name for the Zenduty webhook and paste the Generated Webhook URL that was copied earlier.
Under "Issue related Events" make sure the "Issue Created" and "Issue Updated" checkbox is ticked.
- Scroll down and Save to create the Webhook.