Jira
Create Jira issues from synthesized feedback.
What you will need
- Site URL
- Account email
- API token
- Project key
Steps
In FeedbackFlow, open your project, go to Integrations, and select Jira. Then:
- 1
Enter your Jira site URL and the email of the account that will create issues.
- 2
Create an API token at id.atlassian.com → Security → API tokens, then paste it into FeedbackFlow.
- 3
Enter the project key of the target project (the prefix on issue IDs, e.g. WEB-123 → WEB).
What FeedbackFlow sends to Jira
Nothing. Jira is a destination, not a source. Filing a topic creates an issue of type Task in the project key you configured, with the synthesized summary as the issue title and the supporting detail as the description.
Check that it worked
- Save the credentials, then file any triaged topic to Jira from the topic view.
- The issue opens in your Jira project under a key like WEB-123.
- FeedbackFlow reads that issue back afterwards, so moving it in Jira reflects on the topic.
If it is not working
- Creating an issue fails with a permission error
- The API token belongs to an account without Create Issues on that project. A token inherits exactly the permissions of the account whose email you entered, so check that account in Jira rather than the token.
- The request comes back as a bad request
- Usually the project key. It is the prefix on issue IDs (WEB in WEB-123), not the project name. A project whose workflow has no Task issue type will also refuse the create.
- A filed issue shows as deleted
- Status tracking reads the issue back, and a 404 or 410 from Jira is recorded as deleted rather than as an error, so a topic whose issue was removed says so instead of failing.
Still stuck? Widget and integration troubleshooting covers the problems that are not specific to Jira.