Ana içeriğe atla
Konuşma Sona Erdi Webhook’u, bir sohbet konuşması (WhatsApp veya Web Widget) sona erdikten sonra belirttiğiniz webhook URL’sine otomatik olarak gönderilir. Bu webhook, tam transkripti, çıkarılan değişkenleri, müşteri bilgilerini ve gönderen detaylarını içerir.

Webhook Yapılandırması

Konuşma sona erdi webhook’larını etkinleştirmek için:
  1. Konuşma Sona Erdi Webhook’unu Etkinleştir API endpoint’ini kullanın
  2. Bildirimlerin gönderileceği webhook URL’nizi sağlayın
  3. İsteğe bağlı olarak, konuşmalardan yapılandırılmış veri çıkarmak için asistanınızda arama sonrası değişkenleri yapılandırı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ı

conversation_id
string
Konuşmanın benzersiz tanımlayıcısı (UUID)
assistant_id
string
Konuşmayı yöneten asistanın benzersiz tanımlayıcısı (UUID)
type
string
Konuşma türü. Olası değerler: widget, whatsapp
message_count
integer
Konuşmada alışverilen toplam mesaj sayısı
status
string
Konuşmanın durumu. Değer: ended
extracted_variables
object
Asistanınızın arama sonrası şema yapılandırmasına göre yapay zeka tarafından çıkarılan değişkenler
input_variables
object
Konuşma başlangıcında asistana aktarılan değişkenler (ör. ön sohbet form alanlarından veya otomasyon akışlarından)
transcript
array
Tam konuşmayı temsil eden mesaj nesneleri dizisi
formatted_transcript
string
AI: ve Customer: ön ekleriyle okunabilir biçimlendirilmiş transkript
customer_phone
string
Müşteri telefon numarası (WhatsApp konuşmaları için mevcuttur, widget konuşmaları için null)
customer_name
string
Sağlandıysa müşteri adı (ör. ön sohbet formundan) veya null
sender
object
WhatsApp gönderen bilgileri (yalnızca WhatsApp konuşmalarında mevcuttur, widget için null)
created_at
string
Konuşmanın başladığı ISO 8601 zaman damgası (kullanıcının yapılandırılmış saat diliminde)
ended_at
string
Konuşmanın sona erdiği ISO 8601 zaman damgası (kullanıcının yapılandırılmış saat diliminde)
{
  "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"
}

Yeniden Deneme Davranışı

Webhook endpoint’iniz 2xx dışı bir durum kodu döndürürse veya istek başarısız olursa, sistem yeniden dener:
DenemeGecikme
1. yeniden deneme30 saniye
2. yeniden deneme60 saniye
3. yeniden deneme120 saniye
3 başarısız denemeden sonra, webhook teslimi başarısız olarak işaretlenir ve başka yeniden deneme yapılmaz.

Önemli Notlar

  • conversation_id ve assistant_id UUID’dir, tam sayı kimlik değildir
  • sender alanı yalnızca WhatsApp konuşmaları için doldurulur — web widget konuşmaları için null olur
  • customer_phone yalnızca WhatsApp konuşmaları için mevcuttur
  • customer_name ön sohbet formu verilerinden veya konuşma bağlamından gelir
  • Zaman damgaları kullanıcının yapılandırılmış saat dilimini kullanır (ISO 8601 formatı)
  • extracted_variables asistanınızın arama sonrası şema değerlendirmesinden doldurulur
  • input_variables ön sohbet formlarından (web widget) veya otomasyon akışlarından gelen verileri içerir