Сообщение документ в Telegram — универсальный метод для отправки файлов любого формата в Telegram. Используется для передачи PDF, Excel, Word, архивов и других типов данных, которые нельзя отправить через специализированные методы (`sendPhoto`, `sendAudio`). Telegram сохраняет исходное качество файлов, добавляет превью (для поддерживаемых форматов) и позволяет сопровождать документ подписью с форматированием. Максимальный размер — 2 ГБ, что делает метод идеальным для профессионального обмена данными
Какие форматы принимает аудио сообщение в Telegram и какие бывают ограничения?
Мессенджер позволяет отправлять, например:
- Офисные документы — PDF, DOCX, XLSX и другие.
- Электронные книги.
- Таблицы Excel.
Ограничения
- Максимальный размер отправляемого файла — 2 ГБ (с Telegram Premium — 4 ГБ).
- Максимальная длина имени файла — 60 символов.
- При добавлении файлов через приложение Telegram для смартфона они по умолчанию отправляются без подписи — её можно добавить к каждому файлу уже после публикации.
Популярные ошибки при отправке сообщения документа
400 Bad Request: Wrong file identifier
- Причина: Неверный URL, битый file_id или ограничение доступа к файлу.
- Решение: Проверьте Content-Type и доступность ресурса.
413 Request Entity Too Large
- Причина: Файл >2 ГБ.
- Решение: Сожмите архив или разделите файл на части.
400 Bad Request: Thumbnail must be JPEG and <200 KB
- Решение: Сожмите кастомное превью:
400 Bad Request: Can't parse caption entities
- Причина: Ошибка в HTML/Markdown разметке подписи.
- Решение: Проверить экранирование тегов.
403 Forbidden: Bot can't send messages in chat
- Решение: Дайте боту права администратора в чате/канале.
Информация
Техническая информация для «API BOT-MARKET»
- Код типа сообщения (`messageType`): "8" (для `sendDocument`).
- Макс. скорость отправки: 10 сообщений/секунду (из-за больших размеров файлов).
Советы по эффективному использованию
1. Оптимизация имени файла:
- Используйте латиницу и нижнее подчёркивание: sales_report_Q2_2024.xlsx вместо Отчёт за 2 квартал 2024.xlsx.
2. Превью для документов:
- Для PDF: Telegram автоматически генерирует превью из первой страницы.
- Для других форматов: создайте JPEG-скриншот.
3. Безопасность:
- Запарольте архивы с конфиденциальными данными → отправляйте пароль отдельным сообщением.
