Create Jira tickets via AGILITY Webhook events

Owned by Aly Gueye, created
Last updated: Jan 02, 2024 by Dina Bennett (Deactivated)
3 min read

You can automatically generate Jira tickets using webhook events from AGILITY. This feature is intended for users with Administrative permissions to Jira and AGILITY.

Prerequisites

  • Access to AGILITY with permissions to set up webhooks.

  • Administrative permissions to a Jira Project. For more details on Jira permission for managing automations check here.

  • Basic familiarity with Jira’s project and automation settings.

Configure AGILITY to send Webhook events

  1. Log into AGILITY with the necessary permissions.

  2. Select Settings > Application Settings > Webhook Configuration.

  3. Register a new webhook subscription for the desired trigger events.

Generate Webhook URL in Jira

  1. Access your target Jira project. Log into your Jira instance using the correct permissions to access Automation settings.

  2. Navigate to the Project Settings where you want to create tickets.

  3. Go to Automation settings in your project settings.

  4. Set up an automation rule with "Incoming Webhook" as the trigger and copy the provided URL.

  5. Choose Incoming Webhook as the trigger.

  6. Jira will provide a unique webhook URL. Copy this URL and use it in Step 1.

  7. Select No issues from the webhook , AGILITY webhook payload only contains JSON data relevant to the event. Use Jira Smart Values to access and manipulate data from the payload.

Set up the automation rule in Jira

  1. Choose the “Incoming Webhook” trigger you previously created.

  2. Define Conditions (Optional). Add conditions to filter the webhook events that will create a ticket. For example, you can add a condition to create tickets only for specific types of events.
    In the example below, only Analysis with failed Call Flows will create a ticket.

  3. Configure the “Create issue” action. Use smart values to fill in the issue fields from the webhook data.

Test the integration

  1. Trigger an Event in AGILITY. Carry out an action in AGILITY that triggers the webhook. For example, create a new Analysis with a PCAP file that contains failures.

  2. Verify that a new issue is created in Jira with details from the AGILITY event.
    With rule’s Audit Log you can review to see when the rule was triggered, the final result of the execution, and any actions that may have been performed.

Tips and best practices

  • Implement webhook security.

  • Regularly monitor the automation rules for any errors.

  • Enable or Disable the rule as needed.

  • Be mindful of Jira's rate limits.