Jira Server Setup

Halp can integrate with Jira Data Center (and Jira Server) to sync issues bi-directionally between Slack/Teams and Jira. Follow these instructions to setup the integration.

Not sure if you're using Jira Server, Jira Data Center, or Jira Cloud? If your Jira URL ends in atlassian.net or jira.com you're using Jira Cloud and you should follow these instructions instead. If your URL is something else, these are the instructions for you!
  1. Allow Halp to communicate with your Jira instance

If your Jira instance isn't accessible from the internet you'll need to allow Halp through your firewall. Halp will send requests from this IP range:

18.234.32.224/28

If your Jira instance is open to the internet you can skip this step.

  1. Add a service account user for Halp

We require you to create a user for Halp to connect to Jira. We recommend naming it in a way that makes it clear it’s not a normal user, for example “Halp Bot”.

Then, make sure the user is in the group “jira-servicedesk-users”.

Next, add the user to a project you want to sync Halp with and ensure that it is a member of the “Service Desk Team” role:

  1. Configure webhooks

Halp uses webhooks to receive updates that happen in Jira, like comments or status changes. To add a webhook for Halp:

From the Jira settings console, navigate to System > WebHooks. 

Click “Create a webhook”, and you should see the following:

Enter the following values:

Name: Halp webhook

Status: Enabled

URL: https://halp.com/integrations/jiraserver/comment-webhook

Leave events for “All issues” and check the boxes under “Comment” labeled “created”, “updated”, and “deleted”, as well as under Issue for "created", "updated", and "deleted."

 

  1. Authenticating Jira to Halp

On your Halp instance, click the settings cog to open settings, and then select "Integrations". Then in the top-right corner press the "Add a new Integration" button and select "New Jira Server/Data Center Integration". Finally, enter your credentials in the "Add a new Jira Server Integration" modal.

Note: We no longer support authenticating with OAuth. If you have an existing integration already authenticated with OAuth, it will continue to function for now. However, we will remove support for this in the near future, so switch to basic auth when you get the chance.

  1. Set up a Halp Recipe to route tickets.

On this page, click “Allow”.

You should see this, which means Jira server is ready to configure just like any other integration!

Known Issues

  • If your Jira Server instance is behind a proxy you might need additional configuration to enable features like sending Jira tickets to Halp. Please contact support@halp.com for more information.


How did we do?


Powered by HelpDocs (opens in a new tab)