Webhook’lar, mesajlarınızın durum değişikliklerini (Documentation Index
Fetch the complete documentation index at: https://docs.iletiniz.com/llms.txt
Use this file to discover all available pages before exploring further.
sent, delivered, failed) sunucunuza HTTP POST olarak iletir. Bu sayede GET /v1/messages/{job_id} ile poll etmenize gerek kalmaz.
Kurulum
- Kontrol Paneli → Webhook’lar.
- Yeni Endpoint → public erişilebilir bir HTTPS URL girin (örn.
https://app.firma.com/iletiniz/webhook). - Abone olmak istediğiniz event tiplerini seçin (boş bırakırsanız hepsi).
- Kaydet → modal ekranda secret’i kopyalayın. Bu değer bir kez gösterilir.
Sınırlamalar
- Workspace başına 1 aktif endpoint.
- URL maksimum 2048 karakter.
- Secret 8 karakterlik bir prefix ile dashboard’da gösterilir; tam plaintext gizlenir.
- Endpoint timeout’u 10 saniye.
Endpoint Yanıt Sözleşmesi
Endpoint’inizin 2xx HTTP koduyla yanıt vermesi gerekir. Yanıt gövdesi yok sayılır.| Durum | İletiniz davranışı |
|---|---|
2xx | Başarılı kabul edilir. |
3xx | Kalıcı hata. Redirect takip edilmez. URL’inizi 200 dönecek şekilde güncelleyin. |
4xx | Kalıcı hata. Retry yok. Endpoint kontrat ihlali; logları inceleyin. |
5xx | Geçici. Retry politikasına göre yeniden denenir. |
| Timeout / DNS | Geçici. Yeniden denenir. |
Otomatik Deaktivasyon
Bir endpoint, ardışık 50 başarısız teslimattan sonra otomatik olarak deaktif edilir. Tek bir başarılı teslimat sayacı sıfırlar. Deaktif olmuş endpoint:- Dashboard’da uyarı banner’ı ile gösterilir.
- Yeni event’ler bu endpoint’e iletilmez.
- Dashboard’dan Aktive Et butonuyla yeniden açılana kadar bekler.
Mesajdan Webhook’a Kadar Tipik Gecikme
| Kanal | sent → delivered (ortalama) | Webhook fırlatma gecikmesi |
|---|---|---|
| SMS | 2–8 saniye | < 1 saniye |
| Telegram | < 1 saniye | < 1 saniye |
| 1–3 saniye | < 1 saniye |
İlgili Sayfalar
- Event tipleri — birebir payload örnekleri
- İmza Doğrulama — HMAC verification
- Retry Politikası — backoff, idempotency, deaktivasyon