Конфигурация на Webhook
За да активирате webhook-ове за приключени беседи:- Използвайте API крайната точка Enable Conversation Ended Webhook
- Предоставете вашия webhook URL където уведомленията ще бъдат изпратени
- Опционално конфигурирайте променливи след повикване на вашия асистент за извличане на структурирани данни от разговорите
Формат на Заявката
Webhook-ът се изпраща като POST заявка към конфигурирания от вас URL със следното JSON съдържание:Структура на Съдържанието
string
Уникален идентификатор (UUID) на разговора
string
Уникален идентификатор (UUID) на асистента, който обработи разговора
string
Типът на разговора. Възможни стойности:
widget, whatsappinteger
Общ брой съобщения обменени в разговора
string
Статус на разговора. Стойност:
endedobject
Променливи извлечени от AI въз основа на конфигурацията на схемата след повикване на вашия асистент
object
Променливи които са подадени на асистента в началото на разговора (напр. от полета на предварителен чат форма или автоматизирани потоци)
array
Масив от обекти със съобщения представляващи пълния разговор
string
Четим форматиран транскрипт с префикси
AI: и Customer:string
Телефонен номер на клиента (достъпен за WhatsApp разговори,
null за уиджет разговори)string
Име на клиента ако е предоставено (напр. от предварителен чат форма), или
nullobject
Информация за WhatsApp подателя (присъства само за WhatsApp разговори,
null за уиджет)string
ISO 8601 време когато разговорът е започнал (в конфигурираната часова зона на потребителя)
string
ISO 8601 време когато разговорът е приключил (в конфигурираната часова зона на потребителя)
Поведение при Повторни Опити
Ако вашата webhook крайна точка връща статус код, различен от 2xx, или заявката не успее, системата ще направи повторни опити:
След 3 неуспешни опита, доставянето на webhook-а се отбелязва като неуспешно и не се правят повече повторни опити.
Важни Бележки
conversation_idиassistant_idса UUID-та, не целочислени ID-та- Полето
senderсе попълва само за WhatsApp разговори — ще бъдеnullза разговори чрез уеб уиджет customer_phoneе достъпен само за WhatsApp разговориcustomer_nameидва от данни от предварителен чат форма или контекст на разговора- Времената използват конфигурираната часова зона на потребителя (ISO 8601 формат)
extracted_variablesсе попълват от оценката на схемата след повикване на вашия асистентinput_variablesсъдържат данни от предварителни чат форми (уеб уиджет) или автоматизирани потоци

