¶ Проверка статуса голосового SMS (Exolve)
Проверяет статус голосового SMS (звонка) через платформу Exolve по ID звонка.
¶ Когда использовать
- После отправки голосового сообщения роботом Отправка голосового сообщения (Exolve) или Голосовое сообщение Текст-в-речь (Exolve)
- Проверить, дозвонился ли робот до получателя
- Получить информацию о длительности звонка
- Определить, прослушал ли получатель сообщение
¶ Настройка робота и действия Бизнес процессов
¶ Обязательные поля
| Поле | Описание |
|---|---|
| API-ключ Exolve | ID API-ключа из настроек приложения |
| ID звонка | Идентификатор голосового SMS (звонка), полученный от робота отправки |
Важно В поле
API-ключ Exolveуказывается ID ключа из настроек приложения, а не сам ключ
Важно
ID звонкавы получаете в результате работы робота отправки голосового SMS в полеID звонка
¶ Результаты выполнения робота и Действия Бизнес-процесса
| Поле | Описание |
|---|---|
| Результат | Человеко читаемый результат выполнения |
| Статус звонка | Человеко читаемый статус звонка на русском языке |
| Код статуса | Исходный код статуса Exolve для использования в условиях БП |
| Время создания | Время создания вызова голосового SMS |
| Время начала | Время начала вызова |
| Время окончания | Время окончания вызова |
| Длительность (сек) | Продолжительность вызова в секундах |
¶ Статусы звонка
| Статус | Код | Описание |
|---|---|---|
| Ожидает | wait | Звонок ожидает соединения |
| Соединяется | route | Идёт соединение с получателем |
| В процессе | play | Идёт воспроизведение сообщения |
| Завершён | finish | Звонок завершён |
| Не отвечает | no answer | Получатель не ответил |
| Занято | busy | Получатель занят |
| Ошибка | error | Ошибка при дозвоне |
¶ Пример настройки робота
¶ Откройте настройки робота и заполните поля
- API-ключ Exolve
- ID звонка — используйте переменную
ID звонкаот робота отправки голосового SMS
¶ Результат выполнения
После проверки через робота Битрикс24 Добавить комментарий в элемент вы можете вывести результат в карточку элемента:
¶ Пример настройки Действия Бизнес-процесса
¶ Использование статуса в условиях БП
Если [Код статуса] = "finish" ТО
→ Отметить в CRM "Клиент прослушал голосовое сообщение"
Иначе Если [Код статуса] = "no answer" ТО
→ Запланировать повторный звонок через 2 часа
¶ Связанные роботы
| Робот | Назначение |
|---|---|
| Отправка голосового сообщения (Exolve) | Отправить предзаписанное голосовое сообщение |
| Голосовое сообщение Текст-в-речь (Exolve) | Отправить голосовое сообщение с синтезом речи |
¶ Возможные результаты
| Результат | Описание |
|---|---|
| Информация получена | Данные о звонке успешно получены |
| Звонок не найден | ID звонка не найден в системе |
| Ошибка API | Проблема при обращении к API Exolve |