CoreControl/docs/notifications/Telegram.md

Telegram Notification Setup

To enable Telegram notifications, you need the following:

• Bot Token
  Generated by @BotFather when you create your bot.

• Chat ID
  A unique identifier for the target chat (user, group, or channel).

How to create the bot and get the Bot Token

1. Open Telegram and start a conversation with @BotFather.
2. Send the command /newbot, then follow the prompts to choose a name and username (must end with “bot”). :contentReference[oaicite:1]{index=1}
3. After completion, @BotFather replies with a message containing:

   Use this token to access the HTTP API:
   123456789:ABCdefGhIJKlmNoPQRsTuvWxYZ
   

   Copy this token—this is your Bot Token.

How to obtain the Chat ID

1. Start a chat with your new bot (send it any message).
2. Open in your browser:

   https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
   

3. Look for the "chat":{"id":...} field in the returned JSON. That number is the Chat ID. :contentReference[oaicite:3]{index=3}

Example: getUpdates response excerpt

{
  "ok": true,
  "result": [
    {
      "update_id": 123456789,
      "message": {
        "message_id": 1,
        "from": { "id": 987654321, "is_bot": false, "first_name": "User" },
        "chat": { "id": 987654321, "first_name": "User", "type": "private" },
        "date": 1610000000,
        "text": "Hello"
      }
    }
  ]
}

Here, the Chat ID is 987654321.