Ana içeriğe atla
Arama Sonrası Webhook, her arama tamamlandıktan sonra belirttiğiniz webhook URL’sine otomatik olarak gönderilir. Bu webhook, arama detaylarını, çıkarılan değişkenleri, transkripti ve isteğe bağlı olarak kayıt URL’sini içerir.

​
Webhook Yapılandırması

Arama sonrası webhook’ları etkinleştirmek için:
  1. Asistan ayarlarında asistanınızın webhook URL’sini yapılandırın
  2. Asistan yapılandırmasında “Post call webhook” seçeneğini etkinleştirin
  3. Yapay zekanın çıkarması gereken arama sonrası değişkenleri tanımlayın

​
İstek Formatı

Webhook, yapılandırılmış URL’nize aşağıdaki JSON yüküyle POST isteği olarak gönderilir:

​
Yük Yapısı

​
id
integer
Aramanın benzersiz tanımlayıcısı
​
customer_phone
string
Müşterinin E.164 formatındaki telefon numarası (ör. “+1234567890”) veya mevcut değilse null
​
assistant_phone
string
Asistanın kullandığı E.164 formatındaki telefon numarası veya mevcut değilse null
​
duration
integer
Aramanın saniye cinsinden süresi
​
status
string
Aramanın son durumu (ör. “completed”, “busy”, “failed”)
​
extracted_variables
object
Arama sonrası şema yapılandırmanıza göre yapay zeka tarafından çıkarılan değişkenler
​
input_variables
object
Arama başlamadan önce asistana aktarılan değişkenler
​
transcript
string
Konuşmanın tam transkripti
​
recording_url
string
Arama kaydını indirmek için URL (yalnızca asistan ayarlarında “Include recording in webhook” etkinleştirildiyse dahil edilir)
​
created_at
string
Aramanın başlatıldığı ISO 8601 zaman damgası
​
finished_at
string
Aramanın tamamlandığı ISO 8601 zaman damgası (arama kaydındaki updated_at değerini kullanır)
​
lead
object
Müşteri bilgileri (yalnızca kampanya aramaları için dahil edilir)
​
transfers
array
Bu arama sırasında yapılan aktarım aramalarının listesi (yalnızca aramada aktarımlar varsa dahil edilir)
{
  "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 WhatTalk. 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 WhatTalk. 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://app.whattalk.ai/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 Ayarları

Arama sonrası webhook’unuz için aşağıdaki seçenekleri yapılandırabilirsiniz:
  • Yalnızca tamamlanan aramalarda webhook gönder: Webhook’u yalnızca başarıyla tamamlanan aramalar için gönder
  • Webhook’a kayıt dahil et: Yüke recording_url alanını dahil et
  • Özel değişkenler: Yapay zekanın konuşmadan çıkarması gereken özel değişkenleri tanımlayın

​
Önemli Notlar

  • customer_phone ve assistant_phone alanları, bilgi mevcut değilse null olabilir
  • recording_url alanı yalnızca asistan ayarlarınızda “Include recording in webhook” seçeneğini etkinleştirdiyseniz dahil edilir
  • lead nesnesi yalnızca bir kampanyanın parçası olan aramalar için dahil edilir
  • transfers dizisi yalnızca ilişkili aktarım aramaları olan aramalar için dahil edilir
  • extracted_variables nesnesi, asistanınızın arama sonrası şema yapılandırmasında tanımladığınız değişkenleri içerir