Events

Cloud Elements currently supports events via polling or webhooks depending on the endpoint.

• Polling is a mechanism where Cloud Elements executes the configured query every n minutes and captures the changed information.
• Webhooks are when the provider lets Cloud Elements know what information has changed. Note that additional endpoint setup may be required prior to creating your Element Instance.

If you would like to see more information on our Events framework, please see the Event Management Guide.

JIRA requires an extra configurations to the endpoint in order to enable webhooks.

Step 1. Endpoint setup

Login to your Jira Development Account

1. Click Settings

2. Click "System"

3. Scroll Down and find WebHooks on the left hand side navigation panel

4. Click “WebHooks”

5. Click ” + Create a WebHook”

6. Name the WebHook

7. Make sure “Enabled” is selected

8. Input this URL: https://api.cloud-elements.com/elements/api-v2/events/jira

From this point, your webhook will receive all possible event notifications from every project.

Customization options are available. View the next screen shot for those options.

If you wish to have your WebHook receive all possible event notifications, then scroll down and click “Create”.

Optional Customization Features

Here you have the option to customize the type of events you wish your app to listen for. For example, setting a specific project to receive event notifications, as well as, setting specific events.

• Option to set specific projects to receive event notifications

• Option to set event specific notifications

• Click “Create”.

To provision your JIRA Element with webhooks enabled, use the following JSON when calling the /instances API.

{
  "element": {
    "key": "jira"
  },
  "configuration": {
    "jira.username": "<INSERT_JIRA_USERNAME>",
    "jira.password": "<INSERT_JIRA_PASSWORD>",
    "jira.api.url": "<INSERT_JIRA_SUBDOMAIN_URL>",
    "event.notification.enabled": "true",
    "event.notification.callback.url": "<INSERT_YOUR_APPS_CALLBACK_URL>"
  },
  "tags": [
    "<INSERT_TAGS>"
  ],
  "name": "<INSERT_INSTANCE_NAME>"
}