# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.telm.ai/telmai/integrations/slack-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.