Обробка подій у Голосових роботах
Справжня цінність Голосового робота розкривається тоді, коли він стає частиною вашої комплексної бізнес-логіки. Обробка подій (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. Використовуйте ці вебхуки, щоб перетворити кожен діалог, який веде робот, на автоматизовану бізнес-подію.
