Connect (or disconnect) a Jira Server/Data Center Site

Updated by Jensen

This doc is reflective of our new integration set up. If you are still on legacy set up, and would like to switch to our updated integration experience, please review this FAQ and contact support to opt in.

Connecting a Jira Server/Data Center Site to Halp

In order to connect a Jira Cloud Site to a Halp Instance, you need to be a Halp Global Admin.
- Trying to connect to Jira Cloud?
- Trying to connect to Zendesk?
- Trying to connect to Zapier?

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.
  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 sends requests from a set of known IP addresses. You can view a list of all IPs here. Alternatively you can dynamically configure your firewall from this URL.

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”.

  1. Make sure the user is in the group “jira-servicedesk-users”.
  2. Add the user to the project(s) you want to sync with Halp and ensure that it is a member of the “Service Desk Team” role:
  1. Configure Webhooks

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

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

Enter the following values:

In the input box under Issue related events, leave the entry that says :check_mark: All issues.Underneath that, check the boxes for “created”, “updated”, and “deleted” in both the Comment and Issue columns.

It should look like this when you’re finished:

  1. Navigate to the Integrations tab in your Halp Settings: [subdomain].halp.com/settings/integrations
  1. Click "Add An Integration" and then "Jira DC/Server"
  2. Enter your Jira domain, Bot User credentials, and authenticate.
  1. Once you have authenticated, the site will be listed as an integration.
  1. Next step is to connect a project. Please follow this doc for instructions.
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 for more information.

Disconnecting a Jira Server/Data Center Site from Halp

In order to disconnect a Jira site from Halp , you must first disconnect each queue connected to this Jira site. You can see all currently connected queues in the Jira Site box on the Global Integrations page.

How to disconnect a Queue connected to Jira.
  1. After disconnecting all Queues, navigate to the Integrations tab in your Halp Settings:

[subdomain].halp.com/settings/integrations

  1. Click the red trash can icon by the Jira integration you’d like to disconnect.
  2. Read the confirmation message carefully and confirm you’d like to disconnect your Jira site.
  3. Jira is now disconnected; follow the directions on this page to reconnect.

How did we do?