Noibu's integration with Jira creates a direct path between issues in Noibu and tickets in Jira. After triaging an issue, you can sync the issue to Jira to create a corresponding ticket with all the information your developers need to solve the issue.
Noibu only supports Jira Cloud and NOT Jira Server.
The Jira integration is built using a webhook that listens to two events: issue_updated and issue_deleted. This means that changes to an issue's status in Noibu will reflect in the ticket's status in Jira, and vice versa. Closing or reopening a ticket in Jira will close or reopen the issue in Noibu.
Requirements
To set up your Jira integration, you will need:
- An Email Address Associated to a Jira Admin Account. If your company has security concerns about using an existing user's account for the integration, create a new dummy user and give it Admin permissions in the projects you want to integrate with Noibu.
- Note: The account should have multi-factor authentication enabled.
- Note: The account should have multi-factor authentication enabled.
- A Jira API Token. You can generate an API token from your Jira Admin account's profile settings. Review Jira's guide to Managing API Tokens for more information.
- Note: You must generate the token while logged into the same Admin account you'll use for the integration.
- Note: You must generate the token while logged into the same Admin account you'll use for the integration.
- A Jira Domain. To retrieve the domain, log into your Jira account and copy the host name from the URL.
- Jira Project Names. Retrieve the names of one or more Jira projects you would like to integrate with Noibu.
- Note: To review your projects, log into Jira and click View All Projects. Ensure you retrieve a project's Name, not the project's Key.
- Note: To review your projects, log into Jira and click View All Projects. Ensure you retrieve a project's Name, not the project's Key.
Integrating with Jira
The Jira integration is configured on the domain level. If you use multiple domains, you must configure a Jira integration for each one. It makes sense to use a different Jira project in each domain integration.
- Open the Domains module.
- Select a domain.
- Open the Integrations tab. Here you'll find fields to configure the domain's Jira integration.
- Populate the fields provided. Refer to the Requirements section to learn how to pull information for each field.
- Click Integrate with JIRA. You'll see a confirmation message once the webhook connects.
- Associate the domain to one or more Jira projects.
- Open the Jira Project Setup tab.
- Click Add JIRA Project. This summons a modal to select a Jira project.
- Enter the project's full name–not the project's key–in the field provided. Error text will appear if you enter an invalid project name, or enter the name of a project that has already been integrated with that domain.
Once you enter a valid project name that has not yet been integrated, a dropdown field will appear in the modal. - Expand the dropdown, and populate the fields provided. These fields tell the integration how to classify an issue when creating a corresponding ticket in Jira, including its type and which Jira statuses correspond to an Open and Closed state in Noibu.
- Click Save *project* Config. Now, when a new issue appears in Noibu, the integration will create a corresponding ticket in Jira under the specified project.
- Repeat as necessary.
- Open the Jira Project Setup tab.
Noibu also has integrations in place for Slack and Shopify Liquid.