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

Робот Отправка голосового ([Telegram] Отправить голосовое) отправляет аудиофайл в виде голосового сообщения (voice note). Получатель видит его как стандартное голосовое сообщение с кнопкой воспроизведения.

Заметка

Робот отправки голосовых сообщений доступен только для Telegram.

Назначение

• Отправить предзаписанное голосовое сообщение клиенту
• Автоматизировать отправку аудиоуведомлений
• Добавить аудиосообщение в цепочку автоматизации

Параметры

Параметр	Описание	Обязательный
Линия	Линия Олчат, через которую отправляется голосовое	Да
Тип идентификатора	Способ определения получателя	Да
ID чата / Username / Телефон	Идентификатор получателя	Да
Источник файла	Откуда берётся аудиофайл: URL, Битрикс24.Диск или поле CRM	Да
Файл	URL-адрес аудиофайла, ID файла на диске или значение поля CRM	Да
Длительность (сек)	Продолжительность голосового сообщения в секундах	Нет
Публикация в ОЛ	Режим публикации в открытую линию	Нет
Записать в CRM карточку	Добавить запись в таймлайн CRM	Нет (по умолчанию: Да)

Настройка в редакторе роботов

Шаг 1. Добавьте робота

На нужной стадии воронки добавьте робота [Telegram] Отправить голосовое из раздела Олчат.

Шаг 2. Укажите источник аудиофайла

Выберите источник файла и укажите аудиозапись:

• URL ссылка — прямая ссылка на аудиофайл
• Битрикс24.Диск — ID файла на корпоративном диске
• Поле CRM сущности — значение поля CRM с файлом

Шаг 3. Укажите получателя

Выберите линию и идентификатор получателя.

Настройка в дизайнере бизнес-процессов

Параметры аналогичны настройке в роботах CRM.

Возвращаемые значения

Значение	Тип	Описание
is_sent	bool	Результат отправки: Y или N
message_id	string	ID отправленного сообщения
error	string	Текст ошибки
error_code	string	Код ошибки

Коды ошибок

Код	Описание
FILE_ERROR	Ошибка при подготовке аудиофайла
FILE_NOT_FOUND	Аудиофайл не найден
LINE_NOT_FOUND	Линия не найдена или не активна
CHAT_NOT_FOUND	Не удалось найти чат с получателем
CLIENT_ERROR	Не удалось подключиться к мессенджеру
SEND_ERROR	Ошибка при отправке

Требования к аудиофайлу

Для корректного отображения как голосового сообщения в Telegram:

• Рекомендуемый формат: OGG с кодеком Opus
• Также поддерживаются: MP3, WAV, M4A (Telegram конвертирует автоматически)
• Максимальный размер: 50 МБ

Осторожно

Если аудиофайл не в формате OGG/Opus, Telegram может отобразить его как обычный аудиофайл, а не как голосовое сообщение.

Примечания и рекомендации

Совет

Загрузите предзаписанные голосовые сообщения на Битрикс24.Диск и используйте их ID в роботах. Это надёжнее, чем внешние URL, так как файлы всегда доступны.

• Параметр Длительность необязателен — если не указан, мессенджер определит длительность автоматически
• Голосовое сообщение в ОЛ отображается как текст «[Голосовое сообщение]»