- 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 denemeler iletelephony.complete(telefon aramaları) veyaweb.complete(web aramaları ve oluşturucu mikrofon test aramaları) 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 farkları.
İ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
transcriptsyerinehistoryaltı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_numberalanlarını atlayarakorigin_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 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.
