Saltar al contenido principal

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:

    Create rule with Jira

Configure the automation rule​

  1. Choose the Incoming webhook trigger:

    Configure incoming webhook with Jira

  1. Click Next.

  2. Create a Then component:

    Create then component with Jira

  3. Configure the Then component to Create work item:

    Create issue with Jira

    tip

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

  4. Configure the Create work item action as follows:

    Configure issue with Jira

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

  5. Click Next.

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

    Turn on the rule

Get the incoming webhook details​

  1. Click the Incoming webhook.

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

    Exclude automation

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

    info

    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:

    Jira integration

    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:

    Jira board

  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.