Sorgulamayı bırakın, olaylar size gelsin
Mesajınız operatöre iletildiğinde, teslim edildiğinde veya numaranıza bir SMS geldiğinde TurkeySMS belirlediğiniz adrese bildirim gönderir.
Gereksiz Sorgulamaları Azaltın
SMS durumlarını öğrenmek için sürekli API sorgusu göndermek yerine, desteklenen olayları Webhook üzerinden alın.
İş Akışlarınızı Otomatikleştirin
Gelen olay bildirimlerini kendi sisteminizde işleyerek raporları, kayıtları ve ilgili süreçleri güncelleyin.
Gelişmeleri Takip Edin
SMS gönderimlerinin durum değişikliklerini ve gelen SMS'leri, sisteminize iletilen olay bildirimleriyle takip edin.
Bir olay, dört adım
SMS Gönderimi veya Gelen SMS
SMS gönderiminizi TurkeySMS üzerinden başlatırsınız veya 0850 numaranıza bir SMS gelir.
Olay Kaydı
Desteklenen bir olay oluştuğunda sistem olay kaydını hazırlar; secret tanımlıysa bildirimi imzalar.
Webhook Bildirimi
Olay bildirimi, tanımladığınız HTTPS adresine POST ile gönderilir.
Sisteminizde İşleme
Uygulamanız bildirimi doğrular, 2xx yanıt döner ve gerekli işlemleri gerçekleştirir.
Şema bilgilendirme amaçlıdır; bir süre taahhüdü değildir. Olayın sisteminizde nasıl işleneceği kendi entegrasyonunuza bağlıdır.
Hangi olayları alabilirsiniz?
Almak istediğiniz olayları webhook ayarlarınızda seçersiniz.
sms.sent
Kullanıma AçıkMesajınız operatöre iletildiğinde.
sms.delivered
Kullanıma AçıkOperatörden başarılı teslim raporu geldiğinde.
sms.received
Kullanıma Açık0850 numaranıza bir SMS geldiğinde. Mesaj metni içerdiği için yalnızca ayarlarda açıkça seçerseniz gönderilir.
inbound.matched
Kullanıma AçıkGelen SMS otomasyon kurallarınızdan birinde "Webhook Tetikle" işlemi çalıştığında. Hesabınızdaki ilk etkin webhook'a gönderilir. Gelen SMS
key.test
Kullanıma AçıkPaneldeki Test düğmesine bastığınızda; bağlantınızı denemek içindir.
Giden mesaj olaylarında mesaj metni gönderilmez; gelen SMS olaylarında mesaj metni ve gönderen numara yer alır.
Bildirimin içini görün
Bir olay seçin; gelen isteğin başlıklarını ve JSON gövdesini inceleyin. İmzanın nasıl oluştuğunu deneyerek görün.
Örnek veriler temsilidir. Bu demo tarayıcınızda çalışır; hiçbir istek gönderilmez.
{
"id": "27f38025030d060f3e3b760b318b406e",
"event": "sms.delivered",
"created_at": "2026-10-01T15:30:03+03:00",
"timestamp": 1790857803,
"data": {
"message_id": 518431556,
"bulk_id": "1259383818",
"to": "905xxxxxxxxx",
"sender_id": "BASLIGIM",
"parts": 1,
"source": "api",
"key_id": 1001,
"sent_at": "2026-10-01T15:28:31+03:00",
"done_at": "2026-10-01T15:28:33+03:00",
"operator_status": "Message delivered to handset",
"status": "delivered"
}
}Hesabınızdaki secret (bildirimi imzalayan): demo-secret
Hesaplanıyor…
Bu demo zaman penceresini (300 sn) kontrol etmez; gerçek alıcınız imzadaki t= değerini de kontrol etmelidir.
- İstek gövdesini ham hâliyle okuyun.
- X-TurkeySMS-Signature-V2 değerinden t (zaman) ve v1 (imza) değerlerini ayırın.
- Secret anahtarınızla HMAC(t + "." + gövde) değerini hesaplayın.
- Sonucu imzayla sabit zamanlı karşılaştırın ve t değerinin güncel olduğunu (300 sn) kontrol edin; eşleşmezse 401 dönün.
Not: HTTP 2xx yanıtı olayın alındığını gösterir; iş sürecinizin başarıyla tamamlandığını değil. Olayları teslim kimliğine göre bir kez işleyin.
İmzalı, doğrulanabilir bildirimler
HMAC İmzası
Secret anahtar tanımladığınızda bildirimler SHA-256 veya SHA-512 HMAC ile imzalanır. Secret tanımlı değilse imza başlıkları gönderilmez.
Zaman Damgalı İmza (V2)
X-TurkeySMS-Signature-V2 imzası zaman damgasını da kapsar. Alıcınız imzadaki zamanı kontrol ederek eski isteklerin yeniden kullanılmasını engelleyebilir.
Teslim Kimliği
Her olayın kimliği yeniden denemelerde değişmez; tekrarları bu kimlikle ayıklarsınız.
Yerel Adreslere Gönderim Yok
localhost ve özel ağ adresleri webhook adresi olarak kabul edilmez.
Sunucunuz yanıt vermezse ne olur?
Hata yanıtında yeniden deneme
400 yanıtında durur
Duraklatma
Aynı olay birden fazla kez iletilebilir. Tekrarlanan bildirimleri güvenli şekilde işlemek için olay kimliğini kullanın. Önce yanıt verin, sonra işleyin: olayı kaydedip hemen 2xx dönün; sunucunuzun yaklaşık 10 saniye içinde yanıt vermesi gerekir.
Her bildirimi panelden izleyin
Gönderilen Webhook bildirimlerini, yanıt durumlarını ve yeniden deneme kayıtlarını panelinizden takip edin.
Webhook ile neler yapabilirsiniz?
CRM Entegrasyonu
SMS teslimat durumlarını müşteri kayıtlarınızla ilişkilendirin.
sms.deliveredSipariş Bildirimleri
Mesaj durumlarını sipariş süreçlerinizde takip edin.
sms.sentsms.deliveredRaporlama
SMS durum olaylarını kendi raporlama sisteminize aktarın.
sms.sentsms.deliveredGelen SMS Takibi
Müşteri yanıtlarını destek veya talep sisteminize kayıt olarak aktarın. Gelen SMS
sms.receivedÜç adımda bağlayın
API anahtarınızı hazırlayın
Webhook, hesabınızdaki bir API anahtarına bağlı tanımlanır.
Adresinizi ve olayları girin
Hesabım → API Merkezi → Güvenlik & IP → Webhook: herkese açık HTTPS adresiniz, secret anahtarınız ve almak istediğiniz olaylar.
Test edin ve izleyin
Test düğmesiyle bağlantıyı deneyin; teslimleri Webhook Merkezi'nden takip edin.
Başlamak için ne gerekir?
Hesap
API anahtarı ve secret
Herkese açık adres
Webhook
Olay kaynağı
Kurulum için destek mi gerekiyor? Sizi Arayalım
Sıkça Sorulan Sorular
Webhook nedir, SMS API'den farkı nedir?
SMS API ile siz TurkeySMS'e istek gönderirsiniz (ör. mesaj gönderimi veya durum sorgusu). Webhook'ta ise yön tersinedir: bir olay gerçekleştiğinde TurkeySMS, belirlediğiniz adrese bildirim gönderir. Böylece durumu öğrenmek için API'yi sürekli sorgulamanız gerekmez.
Hangi SMS olayları için bildirim alabilirim?
sms.sent (mesaj operatöre iletildiğinde), sms.delivered (teslim raporu geldiğinde), sms.received (0850 numaranıza SMS geldiğinde; açıkça seçilirse), inbound.matched (Gelen SMS otomasyonunda "Webhook Tetikle" çalıştığında) ve key.test (Test düğmesi).
Webhook bildirimleri ne zaman gönderilir?
Olay oluştuktan sonra kuyruğa alınır ve adresinize gönderilir. Bildirimin ne zaman ulaşacağı için bir süre taahhüdü verilmez; operatör raporu, yeniden denemeler ve sunucunuzun yanıtı süreyi etkiler. Mesajın son durumunu her zaman SMS raporlarından görebilirsiniz.
Sunucum yanıt vermezse ne olur?
Sunucunuz 5xx yanıtı döner veya zaman aşımına uğrarsa olay artan aralıklarla yeniden gönderilir. 400 yanıtı kalıcı hata sayılır ve olay yeniden gönderilmez. Sunucunuzun yaklaşık 10 saniye içinde yanıt vermesi gerekir.
Aynı olay iki kez gelebilir mi?
Evet, örneğin zaman aşımından sonra yapılan yeniden denemede. Her olayın kimliği (X-TurkeySMS-Delivery) yeniden denemelerde aynıdır; daha önce işlediğiniz bir kimlik gelirse tekrar işlemeden 2xx dönün.
Webhook imzasını nasıl doğrularım?
Secret tanımladığınızda her istek X-TurkeySMS-Signature-V2 başlığıyla gelir; secret tanımlı değilse imza başlıkları gönderilmez. HMAC değerini ham gövde ve imzadaki zaman damgasıyla hesaplayıp karşılaştırın; ayrıntılar ve örnek kodlar API dokümantasyonundadır.
Webhook entegrasyonumu nasıl test edebilirim?
Hesabım → API Merkezi → Güvenlik & IP → Webhook sayfasındaki Test düğmesini kullanın: key.test olayını gönderir, HTTP kodunu ve süreyi gösterir. Webhook Simulator ise seçtiğiniz olayı gerçek imzayla ve "simulated": true işaretiyle gönderir. Ardından teslim kayıtlarını Webhook Merkezi'nden kontrol edin.
Webhook kullanımı için ek ücret var mı?
Hayır, webhook kullanımı için ek ücret yoktur. Gönderim olayları için SMS gönderimi (SMS paketi), gelen SMS olayları için hesabınıza tahsisli 0850 numarası gerekir.
Webhook'u duraklatırsam olaylar kaybolur mu?
Duraklatılan webhook'a olay gönderilmez. Yeniden açtığınızda kapalı dönemdeki olaylar gönderilmez; bu dönemin durumlarını SMS raporlarından görebilirsiniz.
"Webhook Tetikle" işlemi hangi adrese gönderir?
Gelen SMS otomasyonundaki "Webhook Tetikle" işlemi, "inbound.matched" olayını hesabınızdaki ilk etkin webhook'a gönderir.
Mesaj metni webhook ile gelir mi?
Giden mesaj olaylarında (sms.sent, sms.delivered) mesaj metni gönderilmez. Gelen SMS olaylarında (sms.received, inbound.matched) mesaj metni ve gönderen numara yer alır; bu verileri KVKK kapsamında saklayın.
SMS olaylarını sisteminizde takip etmeye başlayın
TurkeySMS Webhook entegrasyonunu inceleyin, bildirim adresinizi yapılandırın ve desteklenen SMS olaylarını uygulamanıza aktarın. Hesap oluşturmak ücretsizdir.