Webhook ve olaylar
Calleague çağrı yaşam döngüsü olaylarına abone olun ve gerçek zamanlı tepki verin; örnek bir yük ile.
Calleague, çağrılar gerçekleştikçe kendi sistemlerinizi bilgilendirebilir. API'yi sürekli sorgulamak yerine çağrı yaşam döngüsü olaylarına abone olur ve bir çağrı başlatıldığı, bağlandığı veya bittiği anda tepki verirsiniz. Bu sayfa nasıl abone olunacağını ve bir olay yükünün nasıl göründüğünü gösterir.
Abone olma
Servisinizin barındırdığı bir geri arama adresini — bir webhook uç noktasını — uygulamanın entegrasyonlar alanından kaydeder ve hangi olayların iletilmesini istediğinizi seçersiniz. Calleague ardından eşleşen her olay oluştuğunda bu adrese bir JSON yükü POST eder. İstekler, Calleague'den geldiklerini doğrulayabilmeniz için API anahtarınızı Bearer belirteci olarak taşır.
Authorization: Bearer <API_ANAHTARINIZ>Alabileceğiniz olaylar
| Olay | Ne zaman tetiklenir |
|---|---|
call.started | Bir çağrı yapıldığında veya alındığında. |
call.connected | Çağrı bağlandığında ve ses başladığında. |
call.ended | Çağrı, süresiyle birlikte sona erdiğinde. |
Örnek yük
Abone olunan bir olay tetiklendiğinde, Calleague uç noktanıza JSON POST eder:
{
"event": "call.ended",
"data": {
"callId": "<cagri-id>",
"assistantId": "<asistan-id>",
"direction": "inbound",
"durationSec": 42,
"endedAt": "2026-01-01T12:00:42.000Z"
}
}Uç noktanız, teslimi onaylamak için hızlıca bir 2xx durumuyla yanıt vermeli, ardından daha yavaş işleri eşzamansız olarak yapmalıdır.
Yukarıdaki olay adları ve yük alanları gösterim amaçlıdır — bunları sabit bir sözleşme değil, entegrasyonun şekli olarak değerlendirin. Hesabınızın gerçekte ilettiği olaylara göre geliştirin ve tanımadığınız alanları yok sayın; böylece yenileri güvenle eklenebilir.
Doğru deseni seçme
| İsteğiniz… | Kullanın |
|---|---|
| Bir çağrı olayı gerçekleştiği anda tepki vermek | Bir webhook aboneliği |
| Geçmiş çağrıları veya asistanları talep üzerine okumak | REST API |
İşleyicinizi idempotent yapın. Bir webhook ara sıra birden fazla kez teslim edilebilir; bu yüzden işleminizi callId + event üzerinden anahtarlayın ve tekrarı bir işlemsizlik olarak ele alın.