Webhook
Çağrı Analizi Tamamlandı Webhook Model Örneği

Çağrı Analizi Tamamlandı Webhook Model Örneği

Bir çağrının analizi tamamlandığında sistem, CompletedCallAnalysis olayı için tanımlı aktif webhook adresine aşağıdaki modeli içeren bir POST isteği gönderir. Gövde tek bir JSON nesnesidir (dizi değildir).

Bu model, Çağrı Arama (get-calls) endpoint'inin yanıtındaki her bir kayıtla aynı yapıdadır. Tek fark: webhook payload'ında analysis alanı her zaman doludur (Çağrı Arama'da yalnızca includeAnalysis: true gönderildiğinde dolar) ve callDate kullanıcı saat dilimine çevrilmeden, sistemdeki ham değeriyle döner.

Örnek Model

{
  "callId": "019e925a-5f79-7778-b0be-a45a146cf828",
  "customerId": "11111111-2222-3333-4444-555555555555",
  "callDate": "2026-04-10T14:35:12",
  "queueName": "Musteri Hizmetleri",
  "topic": "Odeme",
  "subTopic": "Iade > Gecikme",
  "resolutionStatus": "Cozuldu",
  "title": "Iade sureciyle ilgili sikayet",
  "summary": "Musteri, [MASKED] numarasi icin iade surecinin geciktigini belirtti.",
  "callIssueType": "Şikayet",
  "newRequestInfo": "Müşteri, iade sürecinin durumunu uygulama üzerinden takip edebilmek için yeni bir özellik talep etti.",
  "direction": 1,
  "directionName": "Giden",
  "resultId": 1,
  "resultName": "Cevaplandı",
  "hangupDirectionId": 1,
  "hangupDirectionName": "Müşteri",
  "endTime": "2026-04-10T14:41:47",
  "answerTime": "2026-04-10T14:35:20",
  "callDurationSeconds": 387.5,
  "queueWaitSeconds": 12,
  "personnelId": "22222222-3333-4444-5555-666666666666",
  "personnelName": "Ayşe Yılmaz",
  "agentId": "agent-42",
  "agentName": "İade Botu",
  "analysis": [
    { "key": "musteri_memnuniyeti", "friendlyName": "Müşteri Memnuniyeti", "value": "Olumlu" }
  ],
  "metadata": {
    "ref_id": "q_6876"
  }
}

Parametreler

AlanTipZorunluAçıklama
callIdstring (UUID)HayırÇağrının sistemdeki benzersiz kimliği.
customerIdstring (UUID)HayırMüşterinin sistemdeki benzersiz kimliği.
callDatedatetimeHayırÇağrı tarihi. Kullanıcı saat dilimine çevrilmez; sistemdeki ham değerdir.
queueNamestringHayırÇağrının ait olduğu kuyruk.
topicstringHayırAna konu.
subTopicstringHayırAlt konu zinciri.
resolutionStatusstringHayırÇözüm durumunun metinsel karşılığı.
titlestringHayırÇağrı başlığı. Hassas veriler maskelenir.
summarystringHayırÖzet metni. Telefon, e-posta, TCKN gibi veriler [MASKED] olarak döner.
callIssueTypestringHayırÇağrı tipi.
newRequestInfostringHayırYeni talep veya özellik isteği bilgisi. Yoksa null döner.
directionintHayırÇağrı yönü. 0 = Gelen, 1 = Giden.
directionNamestringHayırÇağrı yönünün metinsel karşılığı. Örn: "Gelen", "Giden".
resultIdintHayırÇağrı sonucu id'si. 1 = Cevaplandı, 2 = Meşgule Atıldı, 3 = Meşgul, 4 = Belirsiz, 5 = Kaçırıldı.
resultNamestringHayırÇağrı sonucunun metinsel karşılığı.
hangupDirectionIdintHayırÇağrıyı kim kapattı bilgisinin id'si.
hangupDirectionNamestringHayırKapanış yönünün metinsel karşılığı.
endTimedatetimeHayırÇağrının bitiş zamanı. Yoksa null döner.
answerTimedatetimeHayırÇağrının cevaplanma zamanı. Cevaplanmadıysa null döner.
callDurationSecondsdoubleHayırÇağrı süresi (saniye). Yoksa null döner.
queueWaitSecondsintHayırKuyrukta bekleme süresi (saniye).
personnelIdstringHayırÇağrıyla ilgilenen personelin kimliği. Yoksa null döner.
personnelNamestringHayırÇağrıyla ilgilenen personelin adı.
agentIdstringHayırÇağrıyı işleyen yapay zeka ajanının kimliği. Yoksa null döner.
agentNamestringHayırÇağrıyı işleyen yapay zeka ajanının adı.
analysisarrayHayırGenişletilmiş analiz parametreleri; her zaman doludur. Her öğe { key (snake_case), friendlyName (etiket), value (değer) } biçimindedir.
metadataobjectHayırÇağrıyı başlatan Çağrı Başlat isteğiyle gönderilen metadata'nın aynen geri dönüşü. Metadata gönderilmemişse null.
⚠️

Yukarıdaki alanlar sabit bir sözleşmedir; sağlayıcıya göre değişmez (Çağrı Kayıtları / call-log endpoint'inin aksine). hangupDirectionId/hangupDirectionName ve resultId/resultName dışındaki serbest metin alanları (summary, title vb.) boş gelebilir.

metadata alanı, çağrı başlatılırken gönderdiğiniz tüm özel alanları aynen içerir. Kendi sisteminizle çağrıyı eşleştirmek için örn. ref_id gibi bir alan göndermeniz önerilir.

Çağrı KayıtlarıHata Kodları