Telegram Bot API: POST /bot{token}/getUpdates — Получение обновлений (long polling)

Возвращает массив объектов Update. Не работает, пока установлен вебхук.

Параметр	Где	Тип	Обяз.	Описание
token	path	string	да	Токен бота
offset	body	integer	нет	ID первого обновления; на 1 больше последнего полученного — подтверждает предыдущие
limit	body	integer	нет	Число обновлений, 1–100, по умолчанию 100
timeout	body	integer	нет	Таймаут long polling в секундах, по умолчанию 0
allowed_updates	body	array	нет	Типы обновлений, например ["message", "edited_channel_post", "callback_query"]

Базовые URL

• Боевой: https://api.telegram.org
• URL метода: https://api.telegram.org/bot<token>/METHOD_NAME

Авторизация

Тип: 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: long polling

---

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