Skip to main content
Post-Call Webhook се изпраща автоматично към вашия указан webhook URL след завършване на всяко повикване. Този webhook съдържа подробности за повикването, извлечени променливи, транскрипт и по избор URL на записа.

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

За да активирате post-call webhooks:
  1. Конфигурирайте webhook URL на вашия асистент в настройките на асистента
  2. Активирайте “Post call webhook” в конфигурацията на асистента
  3. Дефинирайте post-call променливи, които AI трябва да извлече

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

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

Структура на Payload

id
integer
Уникален идентификатор на повикването
customer_phone
string
Телефонен номер на клиента в E.164 формат (напр., “+1234567890”) или null, ако не е наличен
assistant_phone
string
Телефонен номер, използван от асистента в E.164 формат, или null, ако не е наличен
duration
integer
Продължителност на повикването в секунди
status
string
Финален статус на повикването (напр., “completed”, “busy”, “failed”)
extracted_variables
object
Променливи, извлечени от AI въз основа на конфигурацията на вашата post-call схема
input_variables
object
Променливи, които са били предадени на асистента преди започване на повикването
transcript
string
Пълен транскрипт на разговора
recording_url
string
URL за изтегляне на записа на повикването (включен само ако “Include recording in webhook” е активирано в настройките на асистента)
created_at
string
ISO 8601 timestamp кога е инициирано повикването
finished_at
string
ISO 8601 timestamp кога е завършено повикването (използва updated_at от записа на повикването)
lead
object
Информация за потенциален клиент (включено само за повиквания от кампании)
transfers
array
Списък с трансферни повиквания, направени по време на това повикване (включено само ако повикването има трансфери)
{
  "id": 12345,
  "customer_phone": "+1234567890",
  "assistant_phone": "+1987654321",
  "duration": 125,
  "status": "completed",
  "extracted_variables": {
    "status": true,
    "summary": "Customer interested in product demo",
    "lead_quality": "high",
    "next_action": "schedule_demo"
  },
  "input_variables": {
    "customer_name": "John Doe",
    "product_interest": "Pro Plan"
  },
  "transcript": [
    {
      "text": "Hello! This is Sarah from Aiplocalls. How are you today?",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812511.315143
    },
    {
      "text": "Hi, I'm doing well, thanks for calling.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812514.104436
    },
    {
      "text": "I'm calling to tell you about our new product features.",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812522.918859
    },
    {
      "text": "That sounds interesting, tell me more.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812525.234567
    }
  ],
  "formatted_transcript": "AI: Hello! This is Sarah from Aiplocalls. How are you today?\nCustomer: Hi, I'm doing well, thanks for calling.\nAI: I'm calling to tell you about our new product features.\nCustomer: That sounds interesting, tell me more.",
  "recording_url": "https://call.aiployees.com/storage/recordings/call-12345.mp4",
  "created_at": "2025-01-15T10:30:00.000000Z",
  "finished_at": "2025-01-15T10:32:05.000000Z",
  "transfers": [
    {
      "id": 12346,
      "status": "completed",
      "transfer_to": "+1555123456",
      "duration": 85,
      "carrier_cost": 0.0156,
      "transcript": null,
      "formatted_transcript": "",
      "created_at": "2025-01-15T10:31:00.000000Z",
      "finished_at": "2025-01-15T10:32:25.000000Z"
    }
  ],
  "lead": {
    "id": 789,
    "phone_number": "+1234567890",
    "variables": {
      "source": "website",
      "interest_level": "high"
    },
    "status": "contacted",
    "call_tries": 2,
    "created_at": "2025-01-15T09:00:00.000000Z",
    "updated_at": "2025-01-15T10:32:05.000000Z",
    "campaign": {
      "id": 456,
      "name": "Product Demo Campaign",
      "status": "active",
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "17:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_calls_in_parallel": 5,
      "max_retries": 3,
      "retry_interval": 60,
      "created_at": "2025-01-15T08:00:00.000000Z",
      "updated_at": "2025-01-15T08:00:00.000000Z"
    }
  }
}

Настройки на Webhook

Можете да конфигурирате следните опции за вашия post-call webhook:
  • Send webhook only on completed: Изпращане на webhook само за успешно завършени повиквания
  • Include recording in webhook: Включване на полето recording_url в payload
  • Custom variables: Дефиниране на персонализирани променливи, които AI трябва да извлече от разговора

Важни Забележки

  • Полетата customer_phone и assistant_phone могат да бъдат null, ако информацията не е налична
  • Полето recording_url се включва само ако сте активирали “Include recording in webhook” в настройките на асистента
  • Обектът lead се включва само за повиквания, които са част от кампания
  • Масивът transfers се включва само за повиквания, които имат свързани трансферни повиквания
  • Обектът extracted_variables ще съдържа променливите, които сте дефинирали в конфигурацията на post-call схемата на вашия асистент