# 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://mcp-everything.ru/integrations/telegram-bot-api/scenarios/otpravlyat-uvedomleniya-v-chat-ili-kanal.md)
- [Бот без своего сервера с HTTPS: long polling](https://mcp-everything.ru/integrations/telegram-bot-api/scenarios/bot-bez-svoego-servera-s-https-long.md)

---

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