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

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

Аудио сообщение в Telegram —  метод для отправки музыкальных треков, подкастов и звуковых файлов в чаты, группы и каналы. Поддерживает метаданные (исполнитель, название), обложки и главы, превращая аудио в полноценный медиаобъект. Telegram автоматически генерирует плеер с прогресс-баром, позволяя пользователям слушать контент без скачивания. Максимальная длительность не ограничена, что идеально для лонгридов.

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

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

Некоторые форматы, которые поддерживает Telegram:

  1. MP3 — универсальный формат, сочетает качество и размер.
  2. AAC — обеспечивает хорошее качество звука при меньших размерах файлов.
  3. OGG — формат сжатия, сохраняет качество при компактности файлов.
  4. WAV — формат без потерь, подходит для высокого качества звука.


Некоторые ограничения, связанные с отправкой аудиосообщений в Telegram:

  1. Максимальный размер отправляемого файла — 2 ГБ (для Premium — 4 ГБ).
  2. Длительность аудиосообщения — до1 минуты.
  3. Отправка сообщений к незнакомым пользователям — Telegram ограничивает отправку сообщений к незнакомым пользователям для предотвращения спама. Можно попробовать добавить человека в контакты или дождаться снятия ограничений.
  4. Временные ограничения — если аккаунт попал под временный бан, сообщения можно отправлять только тем контактам, которые уже добавлены в список, и отвечать тем людям, которые написали первыми. Время блокировки зависит от тяжести нарушения: первый случай — несколько минут или часов, повторные нарушения — дни или недели.


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

400 Bad Request: Wrong file identifier

- Причина: Неверный URL, битый file_id или неаудиофайл. 

- Решение: Проверьте Content-Type: audio/mpeg для MP3. 

413 Request Entity Too Large

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

- Решение: Конвертируйте в OPUS: 

400 Bad Request: Thumbnail must be JPEG and <200 KB

- Решение: Сожмите обложку: 

400 Bad Request: Audio title/performer too long

- Решение: Сократите метаданные до 64 символов. 

403 Forbidden: Bot can't send messages in chat

- Решение: Добавьте бота в чат с правами администратора. 

Информация

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

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


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

1.Оптимизация файлов: 

  - MP3: 128 кбит/с, 44.1 кГц (баланс качества/размера):     

2. Метаданные для SEO:. Оптимизация качества: 

- Всегда заполняйте title и performer → улучшает поиск в чатах. 

- Используйте ключевые слова: performer: "Подкаст о маркетинге". 

3. Обложки-триггеры: 

- Создавайте яркие JPEG с текстом (например: "Новый эпизод!"). 

- Оптимальный размер: 500×500 px.

4. Длинный контент: 

- Разбивайте подкасты >50 МБ на части → добавляйте кнопку "Продолжение".