Slack alerts
Connect your account to Slack to receive alert notifications directly in a channel of your choice. When an alert is triggered, a message is sent to Slack automatically — no manual checks required.
Choose a connection method based on how your Slack app is configured:
| Method | Use when | Credentials required |
|---|---|---|
| Webhook | You want a fast, single-channel setup | Incoming Webhook URL |
| Token | You need multi-channel support or programmatic control | Bot Token + Channel ID |
Webhook method
Use this method to connect a single Slack channel using an Incoming Webhook URL. This is the recommended starting point for most users.
Step 1: Create a Slack workspace
Skip this step if you already have a workspace.
- Go to slack.com/get-started and click Create a new workspace.
- Enter and verify your email, then name your workspace.
- Create a channel dedicated to alerts (e.g.
alerts-test).
Step 2: Create a Slack app
- Go to api.slack.com/apps and click Create New App.
- Select From scratch.
- Enter a name for your app (e.g.
Alert System), select your workspace, and click Create App.
Step 3: Enable Incoming Webhooks
- In the app dashboard, go to Incoming Webhooks in the left sidebar.
- Toggle Activate Incoming Webhooks to on.
Step 4: Add a Webhook URL
- Click Add New Webhook to Workspace.
- Select the channel where alerts should be delivered (e.g.
alerts-test) and click Allow.
Step 5: Copy the Webhook URL
Copy the generated URL. It follows this format:
https://hooks.slack.com/services/T.../B.../...
This is the credential you will paste into this app as the Slack Webhook URL.
Note: This URL is scoped to the selected channel. Regenerating it will invalidate the previous URL immediately.
Step 6: Configure the integration
- Enter a name and description for your integration.
- Under Contact Point Type, select Slack.
- Set Slack Channel Type to Webhook.
- Paste the copied URL into the Webhook URL field.
Step 7: Test the connection
Click Test URL to send a sample notification to your Slack channel. Confirm the message appears before saving.
If no message is received, verify that the Webhook URL is complete and that the target channel exists.
Step 8: Save the integration
Click Create Integration.
The integration is now active. Attach it to a service to start receiving alerts — every alert triggered on that service will be delivered to your Slack channel automatically.
Token method
Use this method to connect Slack using a Bot Token and Channel ID. This approach supports multiple channels and is suited for programmatic or advanced configurations.
Step 1: Open your Slack app
Go to api.slack.com/apps and select your app. If you do not have an existing app, complete steps 1 and 2 from the webhook method above.
Step 2: Add the required scope
- In the left sidebar, go to OAuth & Permissions.
- Under Bot Token Scopes, click Add an OAuth Scope.
- Select
chat:write.
This scope grants the bot permission to post messages in channels it has been invited to.
Note: Use
chat:writeand notchat:write.public. Thechat:writescope restricts the bot to channels it is a member of. Thechat:write.publicscope — listed nearby in the Slack dashboard — allows the bot to post in any public channel without being invited, which is broader access than required.
Step 3: Install the app
- In the left sidebar, click Install App.
- Click Allow to install the app to your workspace and apply the configured scopes.
Step 4: Copy the Bot Token
Copy the Bot User OAuth Token displayed after installation. It begins with xoxb-:
xoxb-12345678901-12345678901-abc123def456...
Store this token securely. It provides access to your Slack workspace on behalf of the bot.
Step 5: Invite the bot to your channel
Open the Slack channel where alerts should be delivered and run the following command, replacing Alert System with your app's display name:
/invite @Alert System
Note: This step is required. If the bot is not invited to the channel, messages will fail silently with no error returned.
Step 6: Get the Channel ID
- In Slack, click the channel name at the top to open its details.
- Scroll to the bottom of the panel and copy the Channel ID.
It follows this format: C12345678.
The Channel ID is distinct from the channel name. This app requires the ID, not the name.
Step 7: Configure the integration
- Enter a name and description for your integration.
- Under Contact Point Type, select Slack.
- Set Slack Channel Type to Token.
- Paste the Bot Token and Channel ID into their respective fields.
Step 8: Test and save
- Click Test Connection to send a sample notification to your Slack channel.
- Click Create Integration to save.
The integration is now active. Attach it to a service to start receiving alerts — every alert triggered on that service will be delivered to your specified Slack channel automatically.
Summary
| Webhook method | Token method | |
|---|---|---|
| Setup complexity | Low | Moderate |
| Credential required | Incoming Webhook URL | Bot Token + Channel ID |
| Multi-channel support | No | Yes |
| Programmatic control | Limited | Full |
| Recommended for | Single-channel, quick setup | Multi-channel or advanced configurations |