- Webhook uç noktaları,
aşağıda belgelenen kararlı yük, her teslimat için bir
event_id, 30 sn zaman aşımı ve 24 saate kadar yeniden denemelerletelephony.complete(telefon çağrıları) veyaweb.complete(web çağrıları ve oluşturucu mikrofon test çağrıları) alır. - Eski tek URL webhook’u biraz farklı bir yükle tek bir eşzamanlı deneme alır (10 sn zaman aşımı, yeniden deneme yok) — bkz. Eski yük farklılıkları.
İstek yükü (uç nokta teslimatları)
Bitiş nedenleri
Transkript biçimi
transcripts içindeki her giriş, tek bir konuşma turudur. Roller
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ı) şeklindedir.
Tam yapılandırılmış tur 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’li 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:
- Tur dizisi
transcriptsyerinehistoryaltında bulunur (yukarıdakiyle aynı tur şeması). - Alan kümesi ham çağrı sonu raporudur ve yukarıdaki tablonun ötesinde ek dahili alanlar içerebilir — bilinmeyen alanları bilgi amaçlı kabul edin.
- Web çağrıları (
direction: "web")from_number/to_numberalanlarını içermez veorigin_domainekler. - Builder mikrofon test çağrıları, eski yolda
telephony.completeolarak raporlanır (uç nokta sistemi bunlarıweb.completeolarak 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 henüz
hazır olmadığını belirtmek için
{"transfer_ready": false}yanıtını verebilir. Diğer tüm yanıtlar (veya eski webhook bulunmaması), aktarımın devam etmesine izin verir. Uç nokta teslimatları bunun için hiçbir zaman dikkate alınmaz.
Ö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şlem hattına aktarın.
Kalite incelemesi
Aramaları insan incelemesi için bir QA aracında açın veya kendi değerlendirme modelinizden geçirin.
Bildirimler
Aktarma / başarısızlık durumunda bir ekip arkadaşınızı tetikleyin.
İlgili içerikler
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 / yeniden oynatma için REST üzerinden erişilebilen aynı veriler.