Telegram Bot API: Отправлять уведомления в чат или канал

Сценарий из mcp-everything. Актуально на 2026-10-24.

Самый частый случай: сайт или сервис пишет в Telegram о новых заказах, ошибках, заявках.

Создай бота у @BotFather и получи токен. Проверь его: POST /bot{token}/getMe вернёт данные бота.
Узнай chat_id: напиши боту любое сообщение (или добавь бота в группу) и вызови POST /bot{token}/getUpdates — chat_id будет в message.chat.id. Для публичного канала можно передавать @username канала, бот должен быть в нём администратором.
Отправь сообщение: POST /bot{token}/sendMessage с chat_id и text (до 4096 символов). Для жирного текста и ссылок передай parse_mode = HTML.
Храни chat_id в 64-битном целом: идентификаторы групп и каналов не помещаются в 32 бита. Если пришла ошибка с retry_after — подожди столько секунд и повтори.

TOKEN='123456:ABC-DEF...'

curl -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \
  -H 'Content-Type: application/json' \
  -d '{
        "chat_id": -1001234567890,
        "text": "<b>Новый заказ №1042</b>\nСумма: 15 000 ₽\n<a href=\"https://example.ru/admin/orders/1042\">Открыть</a>",
        "parse_mode": "HTML",
        "link_preview_options": {"is_disabled": true}
      }'

Базовые 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

Методы сценария

POST /bot{token}/getMe — Проверка токена

Параметров нет. Возвращает объект User с информацией о боте.

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"]

POST /bot{token}/sendMessage — Отправка текстового сообщения

Возвращает отправленный Message.

Параметр	Где	Тип	Обяз.	Описание
`token`	path	string	да	Токен бота
`chat_id`	body	integer/string	да	ID чата или @username канала/супергруппы
`text`	body	string	да	Текст, 1–4096 символов после разбора сущностей
`parse_mode`	body	string	нет	Режим форматирования (Markdown-стиль или HTML)
`entities`	body	array	нет	Сущности текста вместо parse_mode
`message_thread_id`	body	integer	нет	ID темы форума
`link_preview_options`	body	object	нет	Настройки превью ссылок
`disable_notification`	body	boolean	нет	Отправить без звука
`protect_content`	body	boolean	нет	Запретить пересылку и сохранение
`reply_parameters`	body	object	нет	Сообщение, на которое отвечаем
`reply_markup`	body	object	нет	Inline-клавиатура, обычная клавиатура, её удаление или ForceReply
`business_connection_id`	body	string	нет	Бизнес-подключение, от имени которого отправляем

Нюансы

Поддерживаются 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