diff --git a/docs/notifications/Telegram.md b/docs/notifications/Telegram.md index 04e7113..87a3722 100644 --- a/docs/notifications/Telegram.md +++ b/docs/notifications/Telegram.md @@ -1,3 +1,49 @@ -# Telegram +# Telegram Notification Setup -![Telegram](../assets/screenshots/notifications_telegram.png) \ No newline at end of file +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/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 +```json +{ + "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`.*