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

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

   
6. Scroll to the Scopes section. Under Bot Token Scopes, click Add an OAuth Scope and add:

   • chat:write

   • chat:write.public

   
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 (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

    

---

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 for the full walkthrough.