Jira integration

PushFeedback creates Jira issues from user feedback using Jira Cloud Automation or Jira Data Center Automations. Each feedback submission becomes a trackable issue on your board.

Prerequisites

Before you begin, ensure you have:

• A PushFeedback account. If you don't have one, sign up for free.
• A project created in your PushFeedback dashboard. If you haven't created one yet, follow the steps in the Quickstart guide.
• A Jira workspace (Cloud or Data Center) with access to Automation options.

1. Configure Jira automations

Create the automation rule

1. Go to Project settings in your Jira project.

2. Navigate to Automation under Project settings.

3. Click Create rule:

   

Configure the automation rule

1. Choose the Incoming webhook trigger:

   

2. Click Next.

3. Create a Then component:

   

4. Configure the Then component to Create work item:

   

   tip

   If you don't see the Create work item component, ensure All actions is marked.

5. Configure the Create work item action as follows:

   

   1. Project: Set the Jira project where you want to create the issue.
   2. Issue type: Select the issue type you want to create.
   3. Summary: Set to {{webhookData.summary}}.
   4. Description: Set to {{webhookData.description}}.

6. Click Next.

7. Click Turn on rule, set a name for your rule, and assign the necessary permissions:

   

Get the incoming webhook details

1. Click the Incoming webhook.

2. On Work criteria, select No work items from the webhook:

   

3. Copy the webhook URL and secret - you'll need these in the following section.

   important

   Save both the webhook URL and secret in a secure location. You'll need them to configure PushFeedback.

4. Click Update.

2. Configure PushFeedback

1. Open app.pushfeedback.com and log in.

2. Go to Projects and select your project.

3. Click Settings, then under Integrations, select Jira.

4. Configure the webhook settings:

   

   1. Paste the webhook URL you copied from Jira
   2. If your Jira project requires authentication:
      • Paste the webhook secret in the Secret field
      • The secret will be sent as an X-Automation-Webhook-Token header with each request

5. Save your changes by clicking Save.

3. Test the integration

To ensure everything is working correctly:

1. Go to any webpage where you've implemented the feedback widget and submit a feedback entry.

2. Confirm the feedback appears on your specified Jira board as a new issue:

   

3. Verify that all relevant details are correctly mapped and visible on the Jira issue.

Troubleshooting

If the integration isn't working:

• Double-check the webhook URL and secret in PushFeedback.
• Verify the Jira automation rule is enabled.
• Check the Jira audit log for any error messages.