Wespoke
Dokümantasyon

Webhook Olayları

Wespoke platformunda gerçekleşen önemli olaylar için webhook bildirimleri alın

Genel Bakış

Wespoke, platformunuzda gerçekleşen önemli olaylar hakkında sizi bilgilendirmek için webhook bildirimleri gönderir. Webhook'lar, asistan aramaları, araç çalıştırmaları ve diğer kritik olaylar için gerçek zamanlı güncellemeler almanızı sağlar.

Webhook Yapılandırması:

Webhook URL'lerinizi kontrol panelinde Ayarlar → Webhooks bölümünden yapılandırabilirsiniz.

Mevcut Olaylar

call.started

Bir asistan araması başlatıldığında tetiklenir.

Veri: Call nesnesi

call.ended

Bir asistan araması sonlandırıldığında tetiklenir.

Veri: Call nesnesi + süre bilgisi

call.failed

Bir arama başarısız olduğunda tetiklenir.

Veri: Call nesnesi + hata bilgisi

tool.executed

Bir araç başarıyla çalıştırıldığında tetiklenir.

Veri: Tool execution nesnesi

tool.failed

Bir araç çalıştırması başarısız olduğunda tetiklenir.

Veri: Tool execution nesnesi + hata bilgisi

assistant.updated

Bir asistan yapılandırması güncellendiğinde tetiklenir.

Veri: Assistant nesnesi

campaign.started

Bir kampanya başlatıldığında veya devam ettirildiğinde tetiklenir.

Veri: Campaign nesnesi + istatistikler

campaign.paused

Bir kampanya duraklatıldığında tetiklenir (manuel veya yetersiz kredi nedeniyle).

Veri: Campaign nesnesi + duraklatma nedeni

campaign.completed

Bir kampanyadaki tüm kişiler işlendiğinde tetiklenir.

Veri: Campaign nesnesi + detaylı istatistikler

campaign.cancelled

Bir kampanya iptal edildiğinde tetiklenir.

Veri: Campaign nesnesi + iptal bilgisi

campaign.call.update

Kampanyadaki her bir arama sonlandığında tetiklenir. Gerçek zamanlı kampanya takibi için kullanılır.

Veri: Kişi bilgisi + arama detayları + canlı ilerleme

Webhook Gönderim Formatı

Tüm webhook bildirimleri aşağıdaki formatta POST isteği olarak gönderilir:

Webhook İstek Formatı
{
  "event": "call.started",
  "timestamp": "2025-10-08T12:34:56.789Z",
  "data": {
    // Olay türüne özgü veri
  },
  "webhookId": "webhook_123abc",
  "attemptNumber": 1
}

Yeniden Deneme Politikası

Webhook gönderimi başarısız olursa, Wespoke otomatik olarak yeniden deneme yapar:

  • İlk deneme: Hemen
  • 2. deneme: 1 dakika sonra
  • 3. deneme: 5 dakika sonra
  • 4. deneme: 15 dakika sonra
  • 5. deneme: 1 saat sonra

Not: Webhook endpoint'iniz 5 saniye içinde 2xx HTTP durum kodu döndürmelidir. Aksi takdirde istek başarısız sayılır ve yeniden deneme mekanizması devreye girer.

Webhook İmza Doğrulama

Güvenlik için tüm webhook istekleri imzalanır. İmza doğrulama hakkında detaylı bilgi içinİmza Doğrulama sayfasına bakın.

Webhooks Genel Bakışİmza Doğrulama