GELEN WEBHOOK'LAR

Dış dünyanın olayları, panelinizde tetikleyiciye dönüşür.

Ödeme onayı, yeni sipariş, çağrı durumu, release — sağlayıcılarınızın webhook'ları tek adreste toplanır. SendNomi imzayı doğrular, olayı kendi endpoint'inize temiz iletir; ulaşmayanı kuyruğa alır, tek tıkla geri gönderirsiniz. Webhook handler'ını elde yazma devri bugün kapanır.

6 kaynak
ödeme · CI · telefoni · e-ticaret · CRM · özel HMAC
HMAC + replay
SHA-256/SHA-1 imza, timestamp + nonce koruması
Dead-letter
ulaşmayan olay kuyruğa iner, tek tıkla geri döner
Delivery tester
test olayı gönderin, yanıtı satır içinde görün
01 / Bağlayın

Altı kaynak kategorisi, tek alıcı adresi.

Panelde bir alıcı oluşturursunuz: kaynak tipini seçer, sağlayıcınızın shared secret'ını yapıştırırsınız. Size üretilen SendNomi adresini sağlayıcının webhook ayarına girdiğinizde bağlantı tamamdır. Ödeme, kod hosting, telefoni, e-ticaret ve CRM için en yaygın imza şemaları yerleşiktir; listede olmayan servisi kendi secret'ınız ve header adınızla, özel HMAC tanımıyla bağlarsınız.

KAYNAK KATEGORİLERİ
  • Ödeme & faturalama HMAC-SHA256
    Ödeme başarılı/başarısız, abonelik yaşam döngüsü, fatura kesimi.
  • Kod hosting & CI HMAC-SHA256
    Push, pull request, issue, release.
  • Telefoni & SMS HMAC (URL-aware)
    SMS iletim raporu (DLR), çağrı durumu, mesaj uyarıları.
  • E-ticaret platformları HMAC-SHA256
    Sipariş oluşturma, müşteri güncelleme, fulfillment.
  • CRM & saha araçları HMAC veya OAuth bearer
    Fırsat, anlaşma, destek kaydı, müşteri yaşam döngüsü.
  • Özel HMAC kendi secret’ınız
    Listede olmayan servis: kendi shared secret + header adınız.
Spesifik sağlayıcı sorunuzu destek hattı 1 iş günü içinde doğrular.
02 / Doğrulayın

Sahte payload 401'de kalır; imzasız olay içeri giremez.

Her sağlayıcının kendi HMAC şeması vardır; imzayı sizin yerinize SendNomi doğrular. SHA-256 ve SHA-1 imzaları desteklenir; timestamp + nonce denetimi, aynı isteğin yeniden oynatılmasını (replay) engeller. Doğrulanamayan istek 401 ile reddedilir ve her olay — kabul ya da ret — log'a işlenir. Payload yalnız imza geçtiğinde yola devam eder.

# İmzalı test olayı gönderin — doğrulamayı canlı izleyin
curl -X POST https://app.sendnomi.com/api/webhooks/inbound/<hesap-id>/test \
  -H "Content-Type: application/json" \
  -H "X-Signature: sha256=<imza>" \
  -d '{"event":"test","payload":{...}}'

# 200 OK → imza geçerli, olay kabul edildi
# 401    → imza geçersiz ya da yeniden oynatılmış (replay) istek
SHA-256SHA-1timestamp + nonce
03 / İşleyin

Doğrulanan olay, kendi endpoint'inize temiz iletilir.

Header'lar normalleştirilir, payload istenirse dönüştürülür ve kendi endpoint URL'inize iletilir. Endpoint'iniz o an yanıt veremezse SendNomi 3 deneme + eksponansiyel backoff ve jitter ile tekrar dener; her deneme 30 saniyelik zaman aşımına bağlıdır. Aynı olay kimliği iki kez gelirse 24 saatlik dedup penceresi sayesinde bir kez işlenir — müşteriniz mükerrer e-posta ya da kayıt görmez.

OLAY YOLU · KAYNAKTAN ENDPOINT’E
  1. Kaynak olayı
  2. İmza doğrulama
  3. Normalleştirme
  4. Sizin endpoint’iniz
Yeniden deneme
3 deneme
Backoff
eksponansiyel + jitter
Zaman aşımı
30 saniye
Dedup penceresi
24 saat — event ID veya sha(payload)
Aynı olay kimliği iki kez gelirse bir kez işlenir — mükerrer kayıt oluşmaz.
Üç sık iş akışı — olay gelir, aksiyon kendiliğinden çıkar

Ödeme başarılı → fatura e-postası

  1. checkout-completed olayı SendNomi adresinize düşer
  2. İmza doğrulanır, olay kabul edilir
  3. Otomasyon, fatura şablonuyla işlemsel e-postayı gönderir
  4. Müşteri faturasını saniyeler içinde gelen kutusunda bulur

Yeni sipariş → hoş geldin serisi

  1. order-created olayı e-ticaret platformunuzdan gelir
  2. Kişi kaydı kendiliğinden açılır ya da güncellenir
  3. İlk siparişse kişi "first_purchase" segmentine eklenir
  4. 3 e-postalık hoş geldin serisi kendiliğinden başlar

Yeni release → changelog duyurusu

  1. Kod hosting / CI release olayını gönderir
  2. Release gövdesi Markdown’dan HTML’e çevrilir
  3. Changelog aboneleri segmentine kampanya çıkar
  4. Tek tık abonelik iptali (RFC 8058) hazırdır
04 / İzleyin

Düşen iletim kaybolmaz: kuyruğa iner, geri döner.

Canlı olay akışı her webhook'u durumuyla listeler: kabul, ret, iletim, yeniden deneme. Delivery tester ile endpoint'inize panelden test olayı gönderir, yanıtı satır içinde görürsünüz. Tüm denemelere rağmen ulaşmayan olay dead-letter kuyruğuna düşer; sorunu giderdiğinizde tek tıkla yeniden gönderirsiniz. Hiçbir olay sessizce kaybolmaz.

CANLI OLAY AKIŞI · ÖRNEK GÖRÜNÜM
  • 14:32:07 payment.checkout_completed 200 · iletildi
  • 14:31:52 order.created 200 · iletildi
  • 14:31:40 call.status_changed yeniden deneme 2/3
  • 14:31:05 release.published dead-letter Yeniden gönder
  • 14:30:48 unknown.source 401 · imza geçersiz
Delivery tester: endpoint’inize panelden test olayı gönderin, yanıtı satır içinde görün.
BAŞLAYIN

İlk gönderiminiz dakikalar içinde.

Ücretsiz hesabınızı oluşturun — ayda 500 gönderim, süresiz.