Skip to main content
Webhook-ът за Приключена Беседа се изпраща автоматично към зададения от вас webhook URL след приключване на чат разговор (WhatsApp или Уеб Уиджет). Този webhook съдържа пълния транскрипт, извлечени променливи, информация за клиента и данни за подателя.

Конфигурация на Webhook

За да активирате webhook-ове за приключени беседи:
  1. Използвайте API крайната точка Enable Conversation Ended Webhook
  2. Предоставете вашия webhook URL където уведомленията ще бъдат изпратени
  3. Опционално конфигурирайте променливи след повикване на вашия асистент за извличане на структурирани данни от разговорите

Формат на Заявката

Webhook-ът се изпраща като POST заявка към конфигурирания от вас URL със следното JSON съдържание:

Структура на Съдържанието

string
Уникален идентификатор (UUID) на разговора
string
Уникален идентификатор (UUID) на асистента, който обработи разговора
string
Типът на разговора. Възможни стойности: widget, whatsapp
integer
Общ брой съобщения обменени в разговора
string
Статус на разговора. Стойност: ended
object
Променливи извлечени от AI въз основа на конфигурацията на схемата след повикване на вашия асистент
object
Променливи които са подадени на асистента в началото на разговора (напр. от полета на предварителен чат форма или автоматизирани потоци)
array
Масив от обекти със съобщения представляващи пълния разговор
string
Четим форматиран транскрипт с префикси AI: и Customer:
string
Телефонен номер на клиента (достъпен за WhatsApp разговори, null за уиджет разговори)
string
Име на клиента ако е предоставено (напр. от предварителен чат форма), или null
object
Информация за 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 съдържат данни от предварителни чат форми (уеб уиджет) или автоматизирани потоци