Блог і база знань сервісу

Відправлення повідомлення документ в боті Telegram

Повідомлення документ в Telegram - універсальний метод для відправки файлів будь-якого формату в Telegram. Використовується для передачі PDF, Excel, Word, архівів та інших типів даних, які не можна відправити через спеціалізовані методи (`sendPhoto`, `sendAudio`). Telegram зберігає вихідну якість файлів, додає превью (для підтримуваних форматів) і дозволяє супроводжувати документ підписом з форматуванням. Максимальний розмір-2 ГБ, що робить метод ідеальним для професійного обміну даними

Відправлення повідомлення документ в боті Telegram

Які формати приймає аудіо повідомлення в Telegram і які бувають обмеження?

Месенджер дозволяє відправляти, наприклад:

  1. Офісні документи - PDF, DOCX, XLSX та інші.
  2. Електронні книги.
  3. Таблиці Excel.


Обмеження

  1. Максимальний розмір відправленого файлу - 2 ГБ (з Telegram Premium - 4 ГБ).
  2. Максимальна довжина імені файлу — 60 символів
  3. При додаванні файлів через додаток Telegram для смартфона вони за замовчуванням відправляються без підпису — її можна додати до кожного файлу вже після публікації. 


Популярні помилки при відправці повідомлення документа

400 неправильний запит: неправильний ідентифікатор файлу

- Причина: невірний URL, битий file_id або обмеження доступу до файлу. 

- Рішення: перевірте Content-Type і доступність ресурсу. 

413 Об'єкт запиту занадто великий

- Причина: Файл >2 ГБ. 

- Рішення: Стисніть архів або розділіть файл на частини. 

400 неправильний запит: ескіз повинен бути у форматі JPEG та <200 КБАЙТ

- Рішення: Стисніть кастомное превью: 

400 неправильний запит: не вдається розібрати об'єкти підпису

- Причина: помилка в HTML / Markdown розмітці підпису. 

- Рішення: перевірити екранування тегів. 

403 заборонено: Бот не може надсилати повідомлення в чаті

- Рішення: надайте боту права адміністратора в чаті/каналі. 

Інформація

Технічна інформація для»API Bot-MARKET"

  1. Код типу повідомлення (`messageType`): "8" (для`sendDocument'). 
  2. Макс. швидкість відправки: 10 повідомлень/секунду (через великі розміри файлів).


Поради щодо ефективного використання

1. Оптимізація імені файлу: 

  - Використовуйте латиницю та підкреслення: sales_report_Q2_2024.xlsx замість звіт за 2 квартал 2024.xlsx. 

2. Прев'ю для документів: 

  - Для PDF: Telegram автоматично генерує попередній перегляд з першої сторінки. 

  - Для інших форматів: створіть JPEG-скріншот. 

3. Безпека: 

  - Запарольте архіви з конфіденційними даними → відправляйте пароль окремим повідомленням.