Telegram Bot API: POST /bot{token}/sendDocument — Отправка файла

Боты могут отправлять файлы любого типа до 50 МБ.

Параметр	Где	Тип	Обяз.	Описание
token	path	string	да	Токен бота
chat_id	body	integer/string	да	ID чата или @username
document	body	file/string	да	file_id, HTTP URL или загрузка через multipart/form-data
thumbnail	body	file/string	нет	Превью в JPEG до 200 кБ
caption	body	string	нет	Подпись, 0–1024 символа
parse_mode	body	string	нет	Режим форматирования подписи
disable_content_type_detection	body	boolean	нет	Отключить определение типа файла на сервере
reply_markup	body	object	нет	Клавиатура

Базовые 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://core.telegram.org/bots/api Вся интеграция одним документом: https://mcp-everything.ru/integrations/telegram-bot-api.md