Обработка событий в голосовых роботах
Истинная ценность Голосового робота раскрывается тогда, когда он становится частью вашей комплексной бизнес-логики. Обработка событий (Webhooks) в UniTalk позволяет вам мгновенно передавать детали о диалоге (начало, завершение, переход на узел) в вашу CRM, аналитические системы или другое программное обеспечение. Это обеспечивает полную синхронизацию данных, позволяет запускать автоматизированные процессы (например, создание лида после успешного звонка) и точно анализировать путь клиента.
Обработчики событий в работах можно задать для событий:
- запуска секретаря (в основных настройках)
- завершения секретаря (в основных настройках)
- перехода на узел (в настройках действий)
Динамические значения
В динамических значениях обработки событий доступны переменные для голосовых роботов.
Динамические значения заполняются только для событий голосовых роботов.
Возможны варианты заполнения некоторых динамических значений:
1) События:
- VOICE_SECRETARY_START — запуск робота
- VOICE_SECRETARY_END — завершение робота
- VOICE_SECRETARY_ENTERED_NODE — переход на узел
2) Робот является фоновым:
- true — фоновый
- false — не фоновый
3) Тип действия узла:
- SPEECH_RECOGNITION — Распознавание речи зпізнавання мовлення
- TO_SIP — Перевод звонка на SIP-линию
- TO_GSM — Перевод звонка на GSM номер
- TO_GROUP — Перевод звонка на отдел
- TO_SCENARIO — Активация сценария
- TO_IVR — Активация голосового меню
- TO_NODE — Перейти на другой узел
- REJECT — Завершение звонка
- EXIT — Выход с голосового робота
- PLAYBACK — Воспроизведение аудио
4) Тип узла, на котором завершился робот:
- INTERMEDIATE — Промежуточный
- END_SUCCESS — Успешный
- END_FAIL — Неуспешный
- BACKGROUND — Фоновый
- BACKGROUND_DEFER — Фоновый — перенос звонка
5) Причина завершения робота:
- NORMAL — Закончился нормально
- USER_REJECT — Абонент завершил разговор
- GREETING_SILENCE — Абонент молчал во время приветствия
- ANSWERING_MACHINE — Распознан автоответчик
- RECOGNITION_ERROR — Распознавание речи перервалось по техническим причинам
- JUMP_LIMIT — Превышен лимит выполненых действий “Перейти на другой узел”
- NODE_LIMIT — Превышен лимит пересеченных узлов
- FAIL — Неизвестная ошибка
Стандартный JSON вебхуков
Пример JSON со всеми возможными полями:
{
«event»: «VOICE_SECRETARY_END»,
«id»: 123456789,
«dbid»: 54321,
«from»: «380971234567»,
«outerNumber»: «380681234567»,
«projectName»: «someprojectname»,
«secretaryName»:»some secretary name»,
«secretaryId»: 12,
«backgroundDialogue»: false,
«nodeId»: 5,
«actionName»: «node action name»,
«actionType»: «TO_SIP»,
«conditionName»: «some condition name»,
«recognizedText»: «some recognized text»,
«endNodeType»: «END_SUCCESS»,
«endReason»: «NORMAL»,
«utmCampaign»: «sale2021»,
«utmSource»: «google»,
«utmMedium»: «email»,
«utmTerm»: «term»,
«utmContent»: «content»,
«googleId»: «11111.11111»,
«facebookClientId»: «fb.1.1234567890»
}
Не обязательно все возможные поля будут заполнены, все зависит от типа события, робота и узла, на которых было вызвано событие.
Описание полей, касающихся только роботов:
- secretaryName — название робота
- secretaryId — id робота
- backgroundDialogue — диалог является фоновым (возможные значения описаны в возможных вариантах заполнения динамических значений)
- nodeId — id узла на котором вызвано событие
- actionName — название действия узла, на котором вызвано событие
- actionType — тип действия узла (возможные значения описаны в возможных вариантах заполнения динамических значений)
- conditionName — название действий узла, на котором вызвано событие
- recognizedText — распознанный текст перед переходом на узел
- endNodeType — тип узла, на котором завершился секретарь (возможные значения описаны в возможных вариантах заполнения динамических значений)
- endReason — причина завершения секретаря (возможные значения описаны в возможных вариантах заполнения динамических значений)
Настройка обработки событий обеспечивает двустороннюю интеграцию между вашим Голосовым роботом и внешними системами. Передавая детализированный JSON-объект, включающий распознанный текст, причину завершения и UTM-метки, вы получаете полный контекст диалога. Это критически важно для точной аналитики, сегментации клиентов и инициирования последующих шагов в CRM. Используйте эти вебхуки, чтобы превратить каждый диалог, который ведет робот, в автоматизированное бизнес-событие.
