---
title: Telegram alerts
description: Send Glowo alerts to a Telegram chat, group or channel via a bot.
sidebar:
  icon: <svg viewBox='0 0 24 24' width='100%' height='100%' fill='currentColor' xmlns='http://www.w3.org/2000/svg'><path d='M11.944 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0a12 12 0 0 0-.056 0zm4.962 7.224c.1-.002.321.023.465.14a.506.506 0 0 1 .171.325c.016.093.036.306.02.472-.18 1.898-.962 6.502-1.36 8.627-.168.9-.499 1.201-.82 1.23-.696.065-1.225-.46-1.9-.902-1.056-.693-1.653-1.124-2.678-1.8-1.185-.78-.417-1.21.258-1.91.177-.184 3.247-2.977 3.307-3.23.007-.032.014-.15-.056-.212s-.174-.041-.249-.024c-.106.024-1.793 1.14-5.061 3.345-.48.33-.913.49-1.302.48-.428-.008-1.252-.241-1.865-.44-.752-.245-1.349-.374-1.297-.789.027-.216.325-.437.893-.663 3.498-1.524 5.83-2.529 6.998-3.014 3.332-1.386 4.025-1.627 4.476-1.635z'/></svg>
  label: Telegram
---

{/* Source of truth: packages/shared/src/notifications.ts —
    telegramChannelSchema (botToken, chatId). Dispatcher:
    dispatchers/telegram.dispatcher.ts, telegram-markdown.ts */}

## Configuration

| Field | Value |
| --- | --- |
| `botToken` | The token from BotFather |
| `chatId` | The chat, group or channel ID to post to |

## Setting it up

1. **Create a bot**

    Message [@BotFather](https://t.me/botfather) in Telegram, send
    `/newbot`, and follow the prompts. It replies with a bot token.

2. **Start a conversation**

    Send your new bot a message, or add it to the group or channel you want
    alerts in. A bot cannot message you first — this step is required.

3. **Find the chat ID**

    Open `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates` in a browser and
    read `result[].message.chat.id` from the response.

4. **Paste both into Glowo**

    Create a Telegram channel with the token and chat ID, then press **Test**.

:::note
Group chat IDs are negative numbers (for example `-1001234567890`). Include the
minus sign.
:::

:::caution
The bot token grants full control of the bot. Treat it as a secret; regenerate
it via BotFather if it leaks.
:::

## Action track

Telegram receives an inline follow-up when an alert is muted or reactivated, the
same as [Slack](/alerting/slack) and [Discord](/alerting/discord).

## Practical notes

- **Adding the bot to a group requires the right permissions**, and some groups
  restrict who bots can post as. Test after adding.
- Telegram is a good personal alerting channel for a solo operator or a small
  team, and reaches a phone reliably without SMS costs.