From a8180f392b880cbe9ebf6dd4e181dde0dfbb10bd Mon Sep 17 00:00:00 2001
From: Pulse Monitor <pulse@pulse-monitor.dev>
Date: Sun, 31 Aug 2025 19:11:55 +0000
Subject: [PATCH] docs: update Telegram webhook configuration instructions
 (addresses #305)

- Remove chat_id from URL (should be in JSON payload)
- Add requirement to select 'Telegram Bot' service type
- Include custom payload template example
- Clarify that chat_id goes in the JSON body, not URL params
---
 docs/WEBHOOKS.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/docs/WEBHOOKS.md b/docs/WEBHOOKS.md
index 92f35c46f..b6108c455 100644
--- a/docs/WEBHOOKS.md
+++ b/docs/WEBHOOKS.md
@@ -39,9 +39,18 @@ Template should be a JSON payload like:
 }
 
 1. Create a bot with @BotFather on Telegram
-2. Get your bot token
+2. Get your bot token from BotFather
 3. Get your chat ID by messaging the bot and visiting: `https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates`
-4. Use the URL format above (Pulse will handle chat_id correctly)
+4. In Pulse, select "Telegram Bot" as the service type
+5. Use the URL format: `https://api.telegram.org/bot<YOUR_BOT_TOKEN>/sendMessage`
+6. Add a custom payload template:
+```json
+{
+  "chat_id": "YOUR_CHAT_ID",
+  "text": "{{.Message}} on {{.Node}}",
+  "parse_mode": "Markdown"
+}
+```
 
 ### Slack
 ```