For teams that make use of the Slack platform it can be useful to send notifications of eSign Signature events to Slack. This document describes how to set up eSign, Jira Automation and Slack to enable this type of notification. Microsoft Teams, Twilio, Email and other notification paths can be set up similarly using any of the Actions available in Jira Automation.
Table of Contents |
---|
See Jira Automation Integration for additional information on eSign webhooks.
Process Overview
At a high level, this is how the notification will work once configured.
...
Leave all other settings at default, scroll to the bottom and press Next to save the trigger.
...
Part 3 - Setup Jira Automation Action
...
Code Block | ||
---|---|---|
| ||
Issue: <https://MYCLOUDSITE.atlassian.net/browse/{{issue.key}}|{{issue.key}} {{issue.summary}}>
Event: {{webhookData.eventText}}
{{webhookData.pendingCount}} signatures waiting: {{ webhookData.pendingList}}
Diagnostics (webhookData): {{webhookData}} |
Issue: <https://MYCLOUDSITE.atlassian.net/browse/{{issue.key}}|{{issue.key}} {{issue.summary}}>
Event: {{webhookData.eventText}}
{{webhookData.pendingCount}} signatures waiting: {{ webhookData.pendingList}}
...
{{webhookData}} |
Leave the settings at default and scroll down to Next to save the action.
...
After Configuring as above, the integration should be operational. To test, execute a signature on any issue within the test project, and .
Then check Slack to see if a message similar to the message following arrives.
...
Additional Notes
Each eSign project has 3 webhooks events (Invite, Execute and Finalize). They can all be set to the same automation trigger webhook URL to call the same Jira automation rule. Similarly the same webhook URL could be shared for any number of projects that want the same notification rule.
Jira Automation can do conditional logic on eSign webhook data. For example it would be possible to add a condition step into the automation rule to only send notification if pending signatures is greater than zero. Condition would like like this: {{webhookData.pendingCount}} > 0.
Jira Automation could be used to send custom emails and notifications.