🤖 Telegram Bot

PulseHub connects to Telegram via the Bot API. When users message your Telegram bot, the messages appear in PulseHub.

---

Prerequisites

A Telegram account and access to @BotFather to create a bot.

---

Setup Steps

1. Create a Bot with BotFather

1. Open Telegram and search for @BotFather
2. Send /newbot
3. Choose a display name (e.g. "Acme Support")
4. Choose a username ending in bot (e.g. acmesupport_bot)
5. BotFather replies with your Bot Token

2. Add the Channel in PulseHub

1. Go to Channels → Add Channel
2. Select Telegram
3. Paste your Bot Token
4. Click Save Channel
5. Copy the Webhook URL

3. Register the Webhook with Telegram

Open this URL in your browser:

https://api.telegram.org/bot{YOUR_BOT_TOKEN}/setWebhook?url={YOUR_PULSEHUB_WEBHOOK_URL}

Telegram responds with: {"ok": true, "result": true, "description": "Webhook was set"}

4. Test

Open your bot in Telegram and send a message. It should appear in PulseHub within seconds.

---

Telegram's Webhook Requirements

• The webhook URL must use HTTPS with a valid SSL certificate
• Telegram expects a 200 response within 60 seconds

---

Common Issues

Symptom	Likely Cause
Webhook not set	URL must be HTTPS with a valid certificate
Bot doesn't respond	Check that telegram_chat_id is in contacts.external_ids
Old messages re-delivered	Normal on webhook re-registration