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

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