Webhook ve olaylar

Calleague, çağrılar ilerlerken neler olduğunu kendi sistemlerinize bildirebilir. REST API'ye sürekli "bitti mi?" diye sormak yerine çağrı yaşam döngüsü olaylarına abone olur ve bir çağrı başladığı, bağlandığı, bittiği ya da bir kayıt veya döküm hazır olduğu anda bir mesaj alırsınız. Bu sayfa bir webhook'u nasıl kaydedeceğinizi, alabileceğiniz olayları, yük yapısını, doğrulamayı ve yeniden denemeleri kapsar.

Bir bakışta

Nasıl çalışır

Bir webhook, hizmetinizin barındırdığı bir web adresidir. Bu adresi Calleague'e kaydeder ve önemsediğiniz olayları seçersiniz; ardından Calleague, eşleşen bir olay her tetiklendiğinde oraya bir JSON POST gönderir.

curl -s -X POST https://app.calleague.ai/api/core/webhook \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "url": "https://your-app.example.com/hooks/calleague",
        "events": ["call.started", "call.completed", "recording.ready"]
      }'

Her teslim API anahtarınızı taşır; böylece gerçekten Calleague'den geldiğini doğrulayabilirsiniz:

Authorization: Bearer $TOKEN

Alabileceğiniz olaylar

Örnek yük

Abone olduğunuz bir olay tetiklendiğinde Calleague uç noktanıza JSON gönderir:

{
  "event": "call.completed",
  "deliveryId": "dl_4c19",
  "occurredAt": "2026-01-01T12:01:24.000Z",
  "data": {
    "callId": "cl_8f2a",
    "agentId": "ag_123",
    "direction": "inbound",
    "durationSec": 84,
    "endedReason": "completed",
    "language": "tr",
    "metadata": { "orderId": "A-1042" }
  }
}

Çağrıyı başlatırken geçtiğiniz metadata burada geri yansıtılır; böylece olayı kendi kaydınızla ikinci bir aramaya gerek kalmadan eşleştirirsiniz.

Hızlı yanıtlayın — uç noktanız ağır işlere başlamadan önce onaylamalıdır:

HTTP/1.1 200 OK

Doğrulama

Yeniden denemeler ve güvenilirlik

Uç noktanız 2xx yanıtlamazsa (hata verir, zaman aşımına uğrar veya erişilemezse), Calleague teslimi sınırlı bir pencere boyunca artan bir bekleyişle yeniden dener. Yeniden denemeler altında doğru kalmak için:

• Tekrarlanabilir olun. İşlemenizi deliveryId (veya callId + olay) üzerine kurun ve tekrarı bir işlem yapmama olarak ele alın.
• Önce onaylayın, sonra çalışın. Hemen 2xx yanıtlayın, sonra ağır işi kuyruğa alın.
• Engellemeyin. Yavaş bir işleyici zaman aşımına yol açar, bu da daha çok yeniden denemeyi tetikler.
• Sırasız teslime tolerans gösterin. Önceki bir olayın yeniden denemesi, sonraki birinden sonra gelebilir.

Bir şey farklı görünüyorsa

Webhook ile REST karşılaştırması

Sık sorulan sorular

Sırada ne var