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 съдържание:

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

​
conversation_id
string
Уникален идентификатор (UUID) на разговора
​
assistant_id
string
Уникален идентификатор (UUID) на асистента, който обработи разговора
​
type
string
Типът на разговора. Възможни стойности: widget, whatsapp
​
message_count
integer
Общ брой съобщения обменени в разговора
​
status
string
Статус на разговора. Стойност: ended
​
extracted_variables
object
Променливи извлечени от AI въз основа на конфигурацията на схемата след повикване на вашия асистент
​
input_variables
object
Променливи които са подадени на асистента в началото на разговора (напр. от полета на предварителен чат форма или автоматизирани потоци)
​
transcript
array
Масив от обекти със съобщения представляващи пълния разговор
​
formatted_transcript
string
Четим форматиран транскрипт с префикси AI: и Customer:
​
customer_phone
string
Телефонен номер на клиента (достъпен за WhatsApp разговори, null за уиджет разговори)
​
customer_name
string
Име на клиента ако е предоставено (напр. от предварителен чат форма), или null
​
sender
object
Информация за WhatsApp подателя (присъства само за WhatsApp разговори, null за уиджет)
​
created_at
string
ISO 8601 време когато разговорът е започнал (в конфигурираната часова зона на потребителя)
​
ended_at
string
ISO 8601 време когато разговорът е приключил (в конфигурираната часова зона на потребителя)
{
  "conversation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assistant_id": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
  "type": "widget",
  "message_count": 8,
  "status": "ended",
  "extracted_variables": {
    "status": true,
    "summary": "Customer asked about pricing plans and was interested in the Pro plan"
  },
  "input_variables": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "transcript": [
    {
      "role": "assistant",
      "content": "Hi! How can I help you today?"
    },
    {
      "role": "user",
      "content": "I have a question about your service."
    },
    {
      "role": "assistant",
      "content": "Of course! I'd be happy to help. What would you like to know?"
    },
    {
      "role": "user",
      "content": "What are your pricing plans?"
    }
  ],
  "formatted_transcript": "AI: Hi! How can I help you today?\nCustomer: I have a question about your service.\nAI: Of course! I'd be happy to help. What would you like to know?\nCustomer: What are your pricing plans?",
  "customer_phone": null,
  "customer_name": "John Doe",
  "sender": null,
  "created_at": "2026-02-23T09:30:00+01:00",
  "ended_at": "2026-02-23T10:00:00+01:00"
}

​
Поведение при Повторни Опити

Ако вашата webhook крайна точка връща статус код, различен от 2xx, или заявката не успее, системата ще направи повторни опити:
ОпитЗакъснение
1-ви повторен опит30 секунди
2-ри повторен опит60 секунди
3-ти повторен опит120 секунди
След 3 неуспешни опита, доставянето на webhook-а се отбелязва като неуспешно и не се правят повече повторни опити.

​
Важни Бележки

  • conversation_id и assistant_id са UUID-та, не целочислени ID-та
  • Полето sender се попълва само за WhatsApp разговори — ще бъде null за разговори чрез уеб уиджет
  • customer_phone е достъпен само за WhatsApp разговори
  • customer_name идва от данни от предварителен чат форма или контекст на разговора
  • Времената използват конфигурираната часова зона на потребителя (ISO 8601 формат)
  • extracted_variables се попълват от оценката на схемата след повикване на вашия асистент
  • input_variables съдържат данни от предварителни чат форми (уеб уиджет) или автоматизирани потоци