Jira

Connecting the account
- Setup EnjoyHQ Link field in Jira
Test your integration
- Other features

EnjoyHQ allows you to link your customer feedback to Jira issues.The integration is two way:

You can link a research project with a Jira issue and track the progress from EnjoyHQ. The integration will synchronize any linked issue's status every hour and update it in your project

Optionally, we can add the EnjoyHQ project linked to the linked JIRA issue so that anybody working on the issue can quickly go back to EnjoyHQ to see customer feedback collected in the linked project

This feature is only supported for Jira's "company-managed" project - "team-managed" projects are not compatible!

Connect your Jira integration account

Only Jira (Atlassian) Cloud is suported. Currently we don't integrate with self-hosted (on-premise) Jira installations.

First you need to connect your Jira account to EnjoyHQ. You can use your own username & token if you have sufficient privileges.

Generate new Jira API token

We use API tokens for authentication when syncing requests between Jira and your EnjoyHQ account.

You can generate a new token in your Jira user profile at Manage your account

Make sure to set sensible name for the new token (e.g. '-token') so you won't accidentally delete it in future.

Don't forget to copy your token to the clipboard before exiting the screen:

Required Jira permissions

To allow full functionality the user connecting integration needs to have at least following permissions enabled in JIRA:

Edit issues in a project
Create issues in a project
Browse projects in which you can edit and create issues

If you do not have those permissions you can ask your Jira administrator to use his own credentials or to setup an EnjoyHQ specific user which will have those permissions enabled.

Permissions are important: Make sure the user you'll be using can access all the JIRA projects you are planning to be linking

Connecting the account

Connect Jira in integrations section:

If the credentials are correct and the user has sufficient permissions you should see the following screen:

Your Jira account is now connected to EnjoyHQ!

Setup EnjoyHQ Link field in Jira

This step is optional, you can skip to testing your integration section below.

If you skip this step the integration will only work one way You’ll be able to see JIRA issues & their statuses in EnjoyHQ projects but you won’t see the EnjoyHQ project link in your Jira issues

In order to allow a you need to a custom field in JIRA which will be used for the EnjoyHQ links.

To a custom field in your Jira account go to Settings -> Issues:

Then click on "Custom fields":

Now click on "Add custom field":

For the field type, find the "URL Field" (we'll be adding to EnjoyHQ in that field):

Finally, the name of the custom field needs to be "EnjoyHQ Link". This is because EnjoyHQ needs to know where to insert and look for data in Jira.This is really important in order to make sure the integration will work.

Now you need to add the created "Custom field" to all your Jira projects "Default screen". In order to do this, "EnjoyHQ Link" custom field needs to be added to all edit and create issue screens.

You should be able to do that straight after creating your new custom field:

You have to select "Default Screen" at least. Other screens are optional, but recommend enabling them as well.

Why? This is required due to Jira API limitationsThe API uses the same data model setup as your UI screen setup.We can only assign EnjoyHQ links to your project's issues when the project has an available field for both Edit and Create issue.

Jira Version Please note that since Jira version 6.2, adding a new project no longer uses Default screen and you’ll need to add the EnjoyHQ Link custom field to the project's screens manually. You can find more at https://confluence.atlassian.com/jirakb/creating-new-project-always-creates-a-new-issue-type-scheme-588582374.html

If the "Associate EnjoyHQ Link to screens" doesn't show automatically, follow the steps below:

In order to configure your Jira screens, in the next window select all your Default screens.In our example, these are "AK: Kanban Default Issue Screen" and "Default Screen":

Finally, ensure all your changes are saved:

Now EnjoyHQ will be able to add links to your Jira projects and you should start seeing a "EnjoyHQ Link" field in all your issues that are linked to EnjoyHQ.

Test your integration

Now that you have connected your Jira account to EnjoyHQ you will be able to link projects to your Jira issues.

In order to do this, go to any EnjoyHQ project and click "Link to Jira" button, available at the settings menu in the projects Plan page:

A new modal will popup where you can select your project:

And the issue you want to link:

If you want to create a new Jira issue, we also provide a shortcut for you. Go ahead a click “create new issue”. A new modal will appear and ask you for the issue type that you want for your new issue.

Now you can click “Create Issue” and you will be sent to a Jira form where you can finish creating your new issue:

At EnjoyHQ side, you'll now be able to refresh your list of issues and your new issue should appear in the list.

After connecting your project with Jira, you should see the Jira issue information in the plan section of your project, in the right sidebar

From there you can go to your Jira issue and if you have integration setup you should also be able to go from Jira back to EnjoyHQ.

Other features

Once Jira is connected, you can filter your projects by their linked Jira ticket status.