Skip to main content
Her arama sona erdikten sonra bir tamamlama olayı tetiklenir: gelen telefon, giden telefon, web araması veya test araması (oluşturucu mikrofon oturumu). Bu olay engelleyici değildir: herhangi bir 2xx ile yanıt verin. Olay her iki yola da iletilir:

İstek yükü (uç nokta teslimatları)

Bitiş nedenleri

Transkript biçimi

transcripts içindeki her kayıt, bir konuşma dönüşüdür. Roller şunlardır: user (arayanın konuşması), model (ajan konuşması ve araç çağrıları), tool (araç sonuçları) ve system (dil değişiklikleri gibi çağrı olayları).
Tam yapılandırılmış dönüş geçmişi için (kesinti işaretleri, onay istemleri ve ham konumlar dahil) GET /v1/calls/{call_id}/history kullanın.

Eski yük farkları

Eski tek URL webhook zarfı {"type": "telephony.complete" | "web.complete", "data": {…}} biçimindedir; event_id içermez ve data alanı uç nokta yükünden farklıdır:
  • Dönüş dizisi transcripts yerine history altındadır (yukarıdakiyle aynı dönüş şeması).
  • Alan kümesi, ham çağrı sonu raporudur ve yukarıdaki tablonun ötesinde ek dahili alanlar içerebilir — bilinmeyen alanları bilgilendirme amaçlı olarak değerlendirin.
  • Web çağrıları (direction: "web") from_number / to_number alanlarını atlayarak origin_domain ekler.
  • Builder mikrofon test çağrıları eski yolda telephony.complete olarak raporlanır (uç nokta sistemi bunları web.complete olarak eşler).
  • Aktarım koordinasyonu: Bir çağrı aktarımla sona erdiğinde, eski webhook eşzamanlı olarak çağrılır ve aktarım hedefinin hazır olmadığını belirtmek için {"transfer_ready": false} yanıtını verebilir. Başka herhangi bir yanıt (veya eski webhook’un olmaması), aktarımın devam etmesini sağlar. Uç nokta teslimatlarına bunun için hiçbir zaman başvurulmaz.

Örnek işleyici


Yaygın kullanım alanları

CRM entegrasyonu

Her aramanın transkriptini ve kayıt URL’sini müşteri kayıtlarınızla birlikte saklayın.

Analizler

Konu modelleme, CSAT sinyali çıkarma veya aktarma oranı izleme için transkriptleri bir işleme hattına aktarın.

Kalite incelemesi

İnsan incelemesi için aramaları bir kalite güvence aracında açın veya kendi değerlendirme modelinizden geçirin.

Bildirimler

Aktarma veya başarısızlık durumunda bir insan ekip arkadaşını tetikleyin.

İlgili

telephony.incoming / web.incoming

Arama başlangıcında çalışan engelleyici karşılığı.

Olay kataloğu

Abone olabileceğiniz diğer olay türleri.

Arama geçmişi API'si

Geri doldurma veya yeniden oynatma için REST üzerinden erişilebilen aynı veriler.