SmartConnect can leverage Jira webhooks to create event driven real-time integrations. The Jira connector comes with some predefined examples, but additional webhooks can be added as needed.

1. Create Data Source

1. Navigate to Data Sources > Realtime Triggers
2. Click Create Realtime Trigger
3. Select Jira Webhook
4. Description – Friendly description for the data source
5. Connection – Jira connection to monitor
6. Webhook – The desired webhook listener
7. Run As – User impersonated on map run
8. Log Action – Which integration run events to log to the Realtime Process Logs table
9. Use the Select Fields button to add any required fields
10. Click Validate and Save
11. Copy the generated Callback url for use in step 3

2. Register Data Source

The real-time data source needs to be linked to an integration before it can be used.

1. Navigate to Processes > Integration Processes
2. + Create Integration
3. Provide an integration id and description, switch to the Source tab
4. Source Type – Real-Time Event
5. Source – Jira
6. Data source – Your previously created data source
7. Group By – Select at least 1 key field

8. Finish mapping at least one field to the target
9. Save the integration
10. Click Register
11. Enable the Trigger on the linked integration
12. Click Validate and Save

3. Configure Webhook in Jira

Now that SmartConnect is listening for events from Jira, we need to configure Jira to send the messages to our data source.

1. Log into Jira as an Administrator
2. Go to Settings > System

3. Navigate to Advanced > Webhooks > Create a Webhook

4. Name – Provide a friendly name for the webhook
5. Status – Set the status to Enabled
6. URL – Paste in the URL generated in Step 1 with an issue={issue.id} parameter
   • Example: https://apina.smartconnect.com/v1/realtime/rest-webhook-callback/00000000-0000-0000-0000-000000000000?issue={issue.id}
7. Secret – Leave blank
8. Description -Optionally, add a description of the webhook
9. Events – Select the tracked event

10. Exclude body -Check this box. SmartConnect will make an API call for the issue details
11. Save the Webhook setup

4. Testing a Webhook

After the webhook is registered, we can test a webhook notification and ensure it processes the whole way through to run the integration.

1. Trigger a webhook by causing a tracked event such as updating a record
2. Log into SmartConnect > Dashboard
3. Verify the integration executed

4. If the integration didn’t automatically run, check the following locations for errors
   • Process History >
     • Realtime Staging
     • Realtime Process Logs
     • System Events