¶ Голосовое сообщение Текст-в-речь (Exolve)
Синтезирует речь из текста и отправляет голосовое сообщение через Exolve. Получателю звонит робот и озвучивает текст.
¶ Когда использовать
- Приветственное сообщение с персонализацией по имени
- Уведомление о статусе заказа
- Напоминание о встрече или событии
- Когда нужно быстро изменить текст — без записи аудио
- Массовые рассылки с персональными данными
¶ Настройка робота и действия Бизнес процессов
¶ Обязательные поля
| Поле | Описание |
|---|---|
| API-ключ Exolve | ID API-ключа из настроек приложения |
| Номер отправителя | Номер телефона, с которого осуществляется звонок (11 цифр, формат 7XXXXXXXXXX) |
| Номер получателя | Номер телефона абонента (11 цифр, формат 7XXXXXXXXXX) |
| Текст сообщения | Текст для синтеза речи (до 1000 символов) |
Важно В поле
API-ключ Exolveуказывается ID ключа из настроек приложения, а не сам ключ
¶ Необязательные поля
| Поле | Описание | По умолчанию |
|---|---|---|
| Голос | Голос и эмоция диктора | (Ж) Алёна — Нейтральная |
| Громкость | Громкость голоса (от -149 до 0) | -19 (Громко) |
| Скорость речи | Скорость синтезируемой речи (от 0.1 до 3.0) | 1.0 |
¶ Доступные голоса
| ID | Имя | Пол | Доступные эмоции |
|---|---|---|---|
| 1 | Алёна | Ж | Нейтральная, Добрая |
| 2 | Ермил | М | Нейтральный, Радостный |
| 3 | Джейн | Ж | Нейтральная, Радостная, Раздражённая |
| 4 | Омаж | Ж | Нейтральная, Раздражённая |
| 5 | Захар | М | Нейтральный, Радостный |
| 8 | Даша | Ж | Нейтральная, Радостная, Дружелюбная |
| 9 | Юлия | Ж | Нейтральная, Строгая |
| 10 | Лера | Ж | Нейтральная, Дружелюбная |
| 11 | Марина | Ж | Нейтральная, Дружелюбная, Шёпот |
| 12 | Александр | М | Нейтральный, Радостный |
| 13 | Кирилл | М | Нейтральный, Радостный, Строгий |
| 14 | Антон | М | Нейтральный, Радостный |
| 15 | Маша | Ж | Радостная, Дружелюбная, Строгая |
¶ Громкость
| Значение | Уровень |
|---|---|
| -149 | 1 — Очень тихо |
| -133 | 2 — Тихо |
| -117 | 3 — Ниже среднего |
| -100 | 4 — Средне-тихо |
| -84 | 5 — Средне |
| -68 | 6 — Средне-громко |
| -52 | 7 — Выше среднего |
| -35 | 8 — Громко |
| -19 | 9 — Очень громко |
| 0 | 10 — Максимально |
¶ Результаты выполнения робота и Действия Бизнес-процесса
| Поле | Описание |
|---|---|
| Результат | Результат выполнения в человеко понятном формате или сообщение об ошибке |
| ID звонка | Идентификатор отправленного голосового SMS. Используется для проверки статуса |
¶ Пример настройки робота
¶ Откройте настройки робота и заполните поля
- API-ключ Exolve
- Номер отправителя — можно использовать явное значение, переменные и поля документа
- Номер получателя — можно использовать явное значение, переменные и поля документа
- Текст сообщения — можно использовать явное значение, переменные и поля документа
- Голос — выберите диктора и эмоцию
- Громкость — оставьте по умолчанию или измените
- Скорость речи — оставьте по умолчанию или измените
¶ Пример текста с персонализацией
Добрый день {{Контакт: Имя}}, Ваш заказ передан курьеру. Ожидайте доставку с 17:00 до 19:00
¶ Результат выполнения
После отправки через робота Битрикс24 Добавить комментарий в элемент вы можете вывести результат в карточку элемента:
📸 НУЖЕН СКРИНШОТ: [Настройка действия «Добавить комментарий» с полями result и call_id]
¶ Пример настройки Действия Бизнес-процесса
¶ Откройте настройки Действия Бизнес-процесса и заполните поля
- API-ключ Exolve
- Номер отправителя — можно использовать явное значение, переменные и поля документа
- Номер получателя — можно использовать явное значение, переменные и поля документа
- Текст сообщения — можно использовать явное значение, переменные и поля документа
- Голос — выберите диктора и эмоцию
¶ Проверка статуса доставки
После отправки вы можете проверить статус звонка с помощью робота Проверка статуса голосового SMS (Exolve). Используйте ID звонка из результата.
¶ Связанные роботы
| Робот | Назначение |
|---|---|
| Отправка голосового сообщения (Exolve) | Отправить предзаписанное голосовое сообщение (аудиофайл) |
| Проверка статуса голосового SMS (Exolve) | Проверить статус звонка |
¶ Возможные результаты
| Результат | Описание |
|---|---|
| Звонок инициирован | Голосовое сообщение отправлено, ожидается дозвон |
| Номер в чёрном списке | Номер заблокирован, звонок не выполнен |
| Ошибка валидации | Неверный формат номера или текста |
| Ошибка API | Проблема при обращении к API Exolve |
¶ Ограничения
- Текст сообщения: до 1000 символов
- Формат номера: 11 цифр, начинается с 7 (например, 79001234567)
- Скорость речи: от 0.1 до 3.0 (где 1.0 — нормальная скорость)