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 supports Jira Cloud V3, Cloud V2. and Server V2.  

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.
    
    
• 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.
    
    
• 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.
    
    
• Your Jira Version. Depending on your configuration, the version may be listed in your Jira footer. If not, log into your Jira Administrator account and check your Billing Details.
  • Noibu supports Jira Cloud V3, Cloud V2. and Server V2.  

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.

1. Open the Domains module.
   
   [domains-overview]
   
   
2. Select a domain.
   
   [domain-details-general]
   
   
3. Open the Integrations tab. Here you'll find fields to configure the domain's Jira integration.
   
   
   
   
4. Populate the fields provided. Refer to the Requirements section to learn how to pull information for each field.
   
   
   
   
5. Click Integrate with JIRA. You'll see a confirmation message once the webhook connects.
   
   
6. Associate the domain to one or more Jira projects.
   
   1. Open the Jira Project Setup tab.
      
      
      
      
   2. Click Add JIRA Project. This summons a modal to select a Jira project.
      
      
      
      
   3. Select a project from 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.
      
      
      
      
   4. 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.
      
      
   5. Repeat as necessary.

Noibu also has integrations in place for Slack and Shopify Liquid.