Create a web trigger to monitor events on Jira and initiate next actions in your automation.

Map your trigger to a Jira instance and configure the trigger to run the automation by receiving real time notifications from the Jirainstance. You can also use a Jira Query Language (JQL) query to define the conditions, on which the automation must be triggered.

Prerequisites

  • You must have a Bot Creator or Citizen Developer license.
  • You must have View my bots permission.
  • You must have all the EVENT TRIGGERS permission for the role.
  • You must have Check in and Check out permission on the folders of where the automation resides.
  • You must be logged in to your Control Room.
  • You must establish an OAuth connection before using them to build an automation. For more information, see Create OAuth connection.

Procedure

  1. On the left pane, click Automation.
  2. Click Create > Task Bot.
    The Create Task Bot wizard is displayed.
  3. Enter an appropriate name for the bot in the Name field.
    All the bots are stored in \Bots folder by default.
  4. Optional: You can add a description for the bot in the Description field.
  5. Optional: You can use the Choose button to save the bot in a different folder.
  6. Click Create & Edit.
    The bot is created and the Edit Task Bot is displayed.
  7. Click Triggers > Jira, and then double-click or drag Web trigger to add the web trigger to Triggers section.
  8. Select the one or multiple events to listen from the Listen to event drop-down.
    The following events are supported:
    • Issue created
    • Issue updated
    • Issue deleted
    • Comment created
    • Comment updated
    • Comment deleted
  9. Optional: Enter a JQL query with predefined conditions in the JQL query field.
    For example: project in (ABC) and status in ("In Progress", "To do").

    This JQL query searches for Jira issues in In Progress or To do status in a project named ABC.

    For more information about JQL queries, see Use advanced search with Jira Query Language (JQL) section in https://support.atlassian.com/.
  10. Click Pick to choose the pre-configured OAuth connection from the Pick an OAuth connection modal.
  11. Select one of the following in the Client secret to verify received event section.
    • Credentials: Click Choose to select the Jira Client secret that is already configured in the Credential Vault.
    • Insecure string: Copy and paste the Client secret string that is generated in Jira developer settings.
    Note:
    • Use the same Client secret, that is used to set up the OAuth connection to authenticate the user identity and the received events that the trigger is listening to. This prevents unauthorized users from accessing the incoming Jira data to create and trigger automations.
    • For more information about generating and managing Client secret, see Enabling OAuth 2.0 section in OAuth 2.0 (3LO) apps.
    .
  12. Optional: Add variables to the trigger in the Response option. For more information about variables, see Variables overview.
    Note: If you use an existing variable for response, ensure that Use as input check box is enabled for the variable.
  13. Optional: Add more triggers as required in the Triggers section.
  14. Double-click or drag an appropriate action from the Actions palette to the Action section.
    For information about actions, see Actions to build automations.
  15. Click Save to save the bot.