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
Connect your Jira integration account
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.
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.
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.
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.
Once Jira is connected, you can filter your projects by their linked Jira ticket status.