Telegram Bot API: POST /bot{token}/setWebhook — Установка вебхука

Telegram отправляет на URL HTTPS POST с JSON-объектом Update; при ответе не 2XX повторяет запрос.

Параметр	Где	Тип	Обяз.	Описание
`token`	path	string	да	Токен бота
`url`	body	string	да	HTTPS URL для обновлений; пустая строка удаляет вебхук
`certificate`	body	file	нет	Публичный ключ для самоподписанного сертификата
`ip_address`	body	string	нет	Фиксированный IP для отправки вебхуков
`max_connections`	body	integer	нет	Одновременных соединений, 1–100, по умолчанию 40
`allowed_updates`	body	array	нет	Типы обновлений
`drop_pending_updates`	body	boolean	нет	Сбросить накопленные обновления
`secret_token`	body	string	нет	1–256 символов A-Z, a-z, 0-9, _, -; приходит в заголовке X-Telegram-Bot-Api-Secret-Token

Базовые URL

Тип: API-ключ

Токен бота (выдаёт @BotFather) передаётся в пути запроса после bot.

https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getMe

Поддерживаются GET и POST; параметры — строкой запроса, application/x-www-form-urlencoded, application/json (кроме загрузки файлов) или multipart/form-data (для файлов).
Имена методов нечувствительны к регистру; все запросы — в UTF-8 и только по HTTPS.
Ответ — JSON с полем ok; при успехе результат в result, при ошибке — description и error_code.
getUpdates и вебхук взаимоисключающие: пока вебхук установлен, getUpdates не работает. Порты вебхука: 443, 80, 88, 8443.
Чтобы не получать дубли при long polling, пересчитывайте offset после каждого ответа.
ID чатов могут превышать 32 бита (до 52 значимых бит) — храните их в 64-битных целых.
allow_paid_broadcast снимает лимиты рассылки до 1000 сообщений в секунду за 0,1 Telegram Stars за сообщение.

Если этого недостаточно — официальная документация: https://core.telegram.org/bots/api Вся интеграция одним документом: https://mcp-everything.ru/integrations/telegram-bot-api.md