Webhooks
Kendi sisteminize olay gönderme
Selwise olaylarını kendi sisteminize HTTP isteğiyle gönderir.
Panelde nerede
Integrations → Webhooks.
Ne için kullanılır
| Amaç | Örnek |
|---|---|
| Bülten kayıtlarını kendi e-posta sisteminize akıtmak | Kayıt olayını Mailchimp'e |
| Kendi veri ambarınıza olay yazmak | Tüm olayları kendi API'nize |
| İç sistemlerinizi tetiklemek | Sipariş olayında CRM güncellemesi |
Bülten kayıtları için en yaygın kullanım budur: Selwise e-posta göndermez, adresleri toplar; webhook onları kendi sisteminize taşır.
Webhook tanımlama
| Alan | Açıklama |
|---|---|
| Name | Panelde görünen ad |
| URL | İsteğin gönderileceği adres |
| Events | Hangi olaylarda tetiklenecek |
| Auth type | Kimlik doğrulama yöntemi |
| Headers | Ek HTTP başlıkları |
| Retry policy | Başarısız istekte yeniden deneme |
| Active | Açık mı |
Kimlik doğrulama
Altı yöntem desteklenir:
| Tip | Nasıl çalışır |
|---|---|
none | Doğrulama yok |
bearer | Authorization: Bearer <token> |
basic | HTTP Basic |
hmac | Gövdenin imzası bir başlıkta gönderilir |
signature | İmza tabanlı doğrulama |
api_key | Anahtar bir başlıkta |
hmac en güvenlisi
hmac yöntemi, gövdenin paylaşılan bir gizli anahtarla imzasını gönderir. Alıcı tarafta aynı imzayı hesaplayıp karşılaştırırsınız; bu hem gönderenin Selwise olduğunu hem de gövdenin değişmediğini doğrular. Açık uçlu bir endpoint kuruyorsanız none kullanmayın.
Kimlik doğrulama yapılandırması şifrelenmiş olarak saklanır.
Yeniden deneme
Alıcınız hata dönerse istek yeniden denenir. Yeniden deneme politikasını yapılandırabilirsiniz.
Bunun bir sonucu vardır: aynı olay birden fazla kez gelebilir. Alıcı tarafınız aynı olayı iki kez işlemeye karşı dayanıklı olmalıdır — olay kimliğine göre tekilleştirin.
Teslimat istatistikleri
Her webhook için toplam, başarılı ve başarısız teslimat sayısı görünür. Başarısız oranı yükseliyorsa:
| Kontrol | Açıklama |
|---|---|
| Adres erişilebilir mi | Selwise sunucularından ulaşılmalı |
| Yanıt süresi | Yavaş yanıt zaman aşımına uğrar |
| Kimlik doğrulama | Anahtar değişmiş olabilir |
| Yanıt kodu | 2xx dışı her kod başarısız sayılır |
Alıcı tarafta
İyi bir webhook alıcısı:
- Hızlı yanıt verir (işi kuyruğa alıp hemen 200 döner).
- Aynı olayı iki kez işlemez.
- İmzayı doğrular.
- Bilmediği olay tiplerini sessizce yok sayar.
Son güncelleme: 9 Eylül 2026