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.
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:
If your Jira instance is open to the internet you can skip this step.
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:
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
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."
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.
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!
- 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 firstname.lastname@example.org for more information.