> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/integrations/slack-integration.md).

# Slack Integration

This article explains how to integrate Slack for receiving alert notifications from Telmai.

## Overview

Setting up Slack notifications requires two steps:

1. Create a Slack app and obtain a Bot OAuth token
2. Add a Slack notification channel in Telmai and assign it to an alert policy

***

## Step 1: Create a Slack App

1. Navigate to [Slack API apps](https://api.slack.com/apps)
2. Sign in and click **Create an App**
3. Set **App Name** to `Telmai Notifier`
4. Select the Slack workspace where the bot should post messages, then click **Create App**
5. In the left navigation, select **OAuth & Permissions**

   ![](/files/YKLPqsGoZjHbGp002bSU)
6. Scroll to the **Scopes** section. Under **Bot Token Scopes**, click **Add an OAuth Scope** and add:

   * `chat:write`
   * `chat:write.public`

   ![](/files/2eoDfPA9k06CqZZCDuc2)
7. Scroll back to the top of the **OAuth & Permissions** page and click **Install App to Workspace**
8. In the confirmation dialog, click **Allow**
9. Navigate to Interactivity & Shortcuts in the left sidebar
10. Toggle Interactivity to On
11. Set a Request URL: [https://env1.telm.ai/api/backend/slack/interactions](https://dev.telm.ai/api/backend/slack/interactions) (replace host with proper one in case of private cloud deployment)
12. Copy the **Bot User OAuth Access Token** — you will need it in the next step

    ![](/files/t5DPYqNqytxABbaOHMcu)

***

## Step 2: Add a Slack Notification Channel in Telmai

Use the token from Step 1 to create a Slack notification channel in Telmai, then assign it to an alert policy.

See [Configuring Notifications](/telmai/monitoring-data/monitors-management/configuring-notifications.md) for the full walkthrough.