Page Comparison

Image Added

How to Create a New Listener

To create a new listener, follow these steps:

1. Navigate to Apps in the Jira top menu and select Manage your apps.

2. In the sidebar, click Easy Integrations configuration.

3. Choose Listeners from the top app menu.

4. Click Add listener to create a new listener.

5. When creating the listener, provide the following information:

   Image Added

   • Listener Name: Give your listener a descriptive name to help you identify it easily.

   • Listener is enabled: Check or uncheck to enable or disable the listener.

   • Retry attempt count: Define the number of retries for failed API calls (maximum 5 retries are allowed). The listener will attempt to continue where it previously failed.

   • Events: Add events for the listener by clicking Add event and selecting them from the popup.

     • Event kind: Select the type of the event:

1. • • JQL

1. • • supported or JQL not supported.

     • Events

1. • • : Select one or more events to listen

1. • • to. Without selected events, the listener won't function until added to a Post Function of the Easy Integrations app.

     • JQL: If you've selected the "JQL Supported" event

1. • • type, provide the JQL for it. The JQL filter

1. • • specifies which issues trigger the webhook

1. • • . Note that only a subset of JQL clauses is supported. This enables us to optimize event matching on the Jira side.

1. • • For more information, check out this Jira article.
       The supported clauses (left-hand side values) are:

       • issueKey

       • project

       • issuetype

       • status

       • assignee

       • reporter

       • issue.property

1. • • • (any

1. • • • indexed

1. • • • issue property can be queried.)

       • cf[id]

1. • • • (for custom fields

1. • • • - currently only the ID of the

1. • • • Epic

1. • • • custom field is supported here)

       Supported operators

1. • • are -,

1. • • !=,

1. • • IN, and

1. • • NOT IN.

1. • • If you would like to use more clauses or operators, raise a request in the

1. • • Atlassian Connect in Jira project

1. • • or watch and comment on a relevant issue there.

1. • Condition

1. • : Enable or

1. • disable a condition.

1. • When enabled, you must write the JavaScript condition

1. • for the listener

1. • , and the listener action will work if the script returns true.

1. • Actions: Add one or more actions for the listener

1. • , which will be executed in display order

1. • . To learn more about actions, click here.

2. After you finish configuring your listener, click Save.

Troubleshooting

If you encounter issues with listeners, consider the following troubleshooting steps:

• Ensure the listener is enabled.

• Check the retry attempt count and adjust if needed.

• Verify that events are correctly configured.

• Double-check the JavaScript condition for the listener.

• Review the actions and their order.

If the issue persists, get in touch with our Support team.