Use when setting up Telegram webhooks, configuring bots in BotFather, implementing secret_token validation, or switching between webhook and getUpdates polling. Also use when debugging webhook delivery failures or bot lifecycle issues.
| Model | Source |
|---|
| inherit | pack: telegram |
| Item | Value |
|---|
| Webhook ports | 443, 80, 88, or 8443 only |
| SSL | Required (self-signed supported) |
| Max connections | 1-100 (default 40) |
| Retry | ~5 retries over 20 minutes |
| Secret header | X-Telegram-Bot-Api-Secret-Token |
| Docs | core.telegram.org/bots/webhooks |
Full Reference
┏━ 🔧 telegram-webhooks ━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Telegram webhook + bot setup reference ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
| Item | Value |
|---|
| Webhook ports | 443, 80, 88, or 8443 only |
| SSL | Required (self-signed supported) |
| Max connections | 1-100 (default 40) |
| Retry | ~5 retries over 20 minutes |
| Secret header | X-Telegram-Bot-Api-Secret-Token |
| Docs | core.telegram.org/bots/webhooks |
| File | Contents |
|---|
reference/setup.md | Webhook and polling setup — setWebhook, getUpdates, BotFather commands, ports, SSL |
reference/security.md | Webhook security — secret_token validation, retry behavior, rate limiting, IP allowlisting |
Usage: Read the reference file matching your current task. Each file has working code examples and inline gotchas.