Блог и база знаний сервиса

Отправка голосового сообщения в боте Telegram

Голосовое сообщение в Telegram —  формат для отправки аудиосообщений в личные чаты, группы и каналы. Идеально для персонального общения, инструкций и уведомлений, где важен голосовой контекст. Telegram автоматически оптимизирует аудио для быстрой доставки, поддерживая подписи с форматированием и интерактивные кнопки. Максимальная длительность — 5 минут, что позволяет передавать развёрнутые сообщения.

Отправка голосового сообщения в боте Telegram

Какие форматы принимает голосовое сообщение в Telegram и какие бывают ограничения?

Telegram поддерживает следующие форматы голосовых сообщений:

OGG

Некоторые ограничения, связанные с голосовыми сообщениями в Telegram:

  1. Недоступность в шумной обстановке. Аудио может быть трудно понять, если вокруг громкий шум.
  2. Отсутствие возможности быстрого поиска. В отличие от текстов, поиск нужной информации в аудио более сложен.
  3. Ограничения по времени прослушивания. Не всегда удобно слушать длинные аудиосообщения, особенно если на это нет времени.


Популярные ошибки при отправке голосового сообщения

400 Bad Request: Wrong file identifier

- Причина: Недопустимый URL или битый file_id. 

- Решение: Проверьте Content-Type и доступность файла. 

400 Bad Request: Duration too long

- Причина: Аудио >300 секунд. 

- Решение: Обрезать через ffmpeg: 

413 Request Entity Too Large

- Причина: Файл >20 МБ. 

- Решение: Конвертировать в OGG: 

400 Bad Request: Can't parse caption entities

- Причина: Ошибка в разметке подписи. 

- Решение: Проверить экранирование тегов. 

403 Forbidden: Bot was blocked by the user

- Решение: Пользователь должен разблокировать бота. 

Информация

Техническая информация для «API BOT-MARKET»

  1. Код типа сообщения (`messageType`): "6" (для `sendVoice`). 
  2. Макс. скорость отправки: 20 сообщений/секунду в группах. 


Советы по эффективному использованию

1. Оптимизация качества: 

  - Конвертируйте в OGG/Opus (64 кбит/с):

  - Удалите тишину в начале/конце. 

2. Увеличение вовлечённости: 

  - Добавляйте временные метки в подпись: 

  - Используйте эмодзи: 🎧 Прослушайте до конца! 

3. Обработка длинных сообщений: 

  - Разбейте аудио на части по 5 минут → отправляйте последовательно с кнопкой "Далее".