Integration Health Status Alert
What is an integration health status alert?
An integration health status alert is an email alert that will notify the selected users anytime there is a change in an integration's status, ex. the status changes to failed or a failed status changes back to operational. A single integrator or an entire technical team can be proactively notified of integration status changes so any issues can be quickly identified and resolved.
Create an Integration Health Status Alert
Users with "Workflows: All Access" or "Workflows: Create" permission will be able to create Workflows.
Default permissions allow admins to view and edit all existing workflows.
Default permissions allow managers to view and edit integration alert workflows they create.
1. Open the left navigation and click Workflows. Alternatively access workflows through the quick actions button > Create a Notification.
2. Click the + Create Workflow button.
3. Click Create on the Integration Health Status Alert tile.
4. Complete the create workflow form:
Required. The name will be displayed within Ambition and on the email alert notifications.
Optional. Description is visible on the manage workflows page and can be helpful to provide context.
Active = the integration health status alert workflow will run any time there is a status change within integration.
Inactive = the integration health status alert will be disabled and no alerts will be provided. Inactive workflows are not deleted and can be set back to active at the appropriate time.
Optionally provide a message to accompany the alert, ex. link to or detail internal troubleshooting steps or include contact information of integrators.
View an example of an integration health status alert here.
A single email will be sent to everyone selected in the same "Send Email" action creating a CC, reply-all behavior within the workflow email alert.
To create a BCC behavior within the workflow email alert, enable multiple "Send Email" actions.
|Send Email - Action Options||Action Description|
|Send an email to myself||
Workflow will be sent to the workflow creator's email address.
|Send an email to a user or multiple users||
Workflow will be sent to the selected user's email address.
Additional hierarchy options will appear to allow you to designate which group(s) of Ambition users you want to receive the email alert.
Learn more about hierarchy options here.
User > All = Every active Ambition user will be notified of the workflow via email.
Users > Within = You will be prompted to select one or more groups within Ambition. All users within the selected group(s) will be notified via email. Only members, and not managers, of the selected groups will be notified.
User > Custom - You will be prompted to manually select which specific users will be notified will be notified of the workflow via email.
|Send an email to the following (Custom Email Address)||
An email will be sent to the input email address.
Use for any one/any group/distribution list who needs to receive workflow updates, but DOES NOT have an Ambition account.
ex. firstname.lastname@example.org or email@example.com
Pro Tip: Ensure that any distributions lists have the proper protocols adjusted to allow Ambition emails to be received.
|Log - Action Options||Action Description|
Send workflow to internal log for troubleshooting purposes.
Logs can be viewed under the "Jobs" tab in the manage workflow view. (Workflows: All Access permission required)
You will be able to see the workflow name and the time the workflow ran.
5. Click Create Workflow.