Skip to main content
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ı

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

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: 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