Send alerts for workflow events App
You can send workflow alerts to Email and Google Chat to notify your team when workflows in Atlan complete or fail. You can also send alerts to Slack and Microsoft Teams using Atlan’s built-in notification capabilities.
Prerequisites
Before you begin, make sure you have:
- Access to the Workflow Alerting app. You can verify this by searching for Workflow Alerting in the Atlan marketplace. If you don't have access, contact Atlan support or your Atlan customer team to request it.
Setup workflow
-
In your Atlan workspace, go to the homepage and click New workflow in the top navigation bar.
-
Search for Workflow Alerting, and then select Set up workflow.
-
In the Mode option, select the alert delivery method:
- Google Chat
Sends workflow alerts as a tabular report to one or more email addresses, including details of the selected workflow runs.
-
Enter one or more email addresses in the Email IDs field, separated by commas. Use valid addresses for recipients who need to receive workflow alerts.
-
In the Email subject field, enter a clear, concise subject line for the alert email so recipients can quickly identify the notification.
Atlan Workflow Failure Alert
Sends workflow alerts to a Google Chat space using a webhook URL. Alerts appear as structured Google Chat cards, which include the workflow name, status (for example, Failed
or Completed
), and other run details.
-
Enter the Google Chat webhook URL in the Webhook URL field. You can generate a webhook URL by navigating to your Google Chat space, selecting Settings → Apps & integrations, and adding an incoming webhook. For more information, see the Google Chat documentation.
https://chat.googleapis.com/v1/spaces/AAAA123456/messages?key=abc123&token=xyz456
-
In Workflows Created By, select the users whose workflows trigger alerts. Leave blank to monitor workflows from all users.
Select Failed to receive alerts only for failed runs, or All Workflows to receive alerts for every workflow execution.
infoWorkflows that are still running are ignored. The package only captures workflows that have finished, either successfully or with a failure.
-
In Scheduling Status, choose one of the following options to specify which workflows to monitor:
-
Scheduled: Includes only workflows with a defined run schedule.
-
Unscheduled: Includes only workflows without a set schedule.
-
All: Includes both scheduled and unscheduled workflows.
-
-
In Workflow Type, select the categories of workflows you want to monitor. Multiple categories can be selected if needed.
-
In Monitoring interval for workflow completions, select the time range to track workflow completions. Atlan evaluates workflows completed within the chosen interval and triggers alerts if they meet the configured criteria, enabling timely detection of issues and faster response.
If Last 24 Hours is selected, the alert includes all workflows that completed or failed within the past day, listed together in a single notification.
-
Schedule and run the workflow. Run the workflow manually or set a recurring schedule to send alerts at regular intervals.
Need help?
If you have any issues related to configuring the app, contact Atlan support.