SMS, aramalar, WhatsApp ve e-postayı kesin olay adlarıyla kapsayın.
WEBHOOK V2 · HER MOBİL OLAY, YAZILIMINIZA ULAŞTIRILIR
Bağlı mobil cihazınızdaki her olayı anında bir eyleme dönüştürün.
SMSMobileAPI Webhook V2 uygulamalarınıza, bir SMS gönderim talebi oluşturulduğunda, gönderildiğinde, başarısız olduğunda veya alındığında; bir mobil arama kaçırıldığında, gelen veya giden olduğunda; ve desteklenen WhatsApp veya e-posta etkinliği gerçekleştiğinde yapılandırılmış HTTPS olaylar gönderir. Gösterge panelinizden her şeyi görsel olarak yapılandırın—polling döngüsüne gerek yok.
API dökümantasyonunu okuyunHer hedefin hangi olayları alacağını seçin. Bir çalışma alanından test edin, duraklatın, izleyin ve imzalama gizli anahtarını döndürün.
SMSAramaWA WAE-posta
imzalı JSON
SMSMobileAPIWebhookV2Kalıcı olay kuyruğu
Canlı
HTTPS POST
CRM CRMDestekOtomasyonAnalitikler
Farklı olay gruplarını farklı HTTPS hedeflerine gönderin.
Her isteği HMAC-SHA256 imzası ve zaman damgası kullanarak doğrulayın.
Geçici hedef hataları, diğer hesapları engellemeden yeniden denenir.
Webhook V2 nasıl çalışır
Gerçek bir mobil olayın uygulamanıza üç net adımda ulaşması.
Bağlı mobil cihazınız ve SMSMobileAPI hizmetleri operasyonel olaylar üretir. Webhook V2, her uygun olayı kalıcı bir teslimat kuyruğuna ekler ve seçtiğiniz HTTPS URL'a imzalı bir JSON yükü gönderir.
- 1
Bir olay gerçekleşir
Bir mesaj gönderim talebi oluşturulur, bir mobil cihaz bir SMS gönderir veya alır, bir arama durumu değiştirir ya da desteklenen WhatsApp ve e-posta etkinlikleri kaydedilir.
- 2
Webhook V2 bunu yönlendirir
SMSMobileAPI, tek bir sabit olay kimliği oluşturur ve teslimatı yalnızca o olay türüne abone olan hedefler için kuyruklar.
- 3
Yazılımınız tepki verir
Genel erişimli HTTPS uç noktanız imzayı doğrular, olay kimliğini depolar ve CRM, destek, uyarı veya otomasyon iş akışınızı başlatır.
15 kesin olay türü
İş akışınızın ihtiyaç duyduğu mobil olaylara abone olun.
Bir hedef her şeyi alabilir ya da üretim sistemlerini, analizleri ve operasyonel uyarıları ayırabilirsiniz. Her olayın kesin bir adı vardır, böylece uygulamanız onu öngörülebilir şekilde işleyebilir.
SMS
5sms.api.submittedSMS API üzerinden gönderim talebi oluşturuldu
API isteği bir SMS gönderme işi oluşturdu. İsteğin platforma girdiğini onaylamak için yararlıdır.
sms.sentSMS gönderildi
Bağlı mobil cihaz, SMS gönderme işlemini onayladı.
sms.failedSMS başarısız oldu
Bağlı mobil cihaz bir SMS gönderme hatası döndürdü.
sms.receivedSMS alındı
Bağlı bir mobil cihaz gelen bir SMS'u senkronize etti.
sms.mobile.sentSMS mobil cihazdan gönderildi
Bağlı mobil cihazdan manuel olarak bir SMS gönderildi.
Aramalar
3call.missedCevapsız çağrı
Bağlı bir mobil cihazdan bir cevapsız çağrı senkronize edildi.
call.incomingGelen arama
Bağlı bir mobil cihazdan bir gelen arama senkronize edildi.
call.outgoingGiden arama
Bağlı bir mobil cihazdan bir giden arama senkronize edildi.
whatsapp.submittedWhatsApp gönderim talebi oluşturuldu
Bir WhatsApp gönderim işi oluşturuldu.
whatsapp.sentWhatsApp gönderildi
Bağlı WhatsApp ortamı mesajın gönderildiğini doğruladı.
whatsapp.failedWhatsApp başarısız oldu
WhatsApp gönderme işlemi başarısız oldu.
whatsapp.receivedWhatsApp alındı
Hesap senkronizasyon talep ettikten sonra bir WhatsApp mesajı alındı.
whatsapp.voice.transcribedSesli mesaj yazıya döküldü
Uygun bir alınmış WhatsApp sesli mesaj kullanılabilir metne dönüştürüldü.
E-posta
2email.sentE-posta gönderildi
SMSMobileAPI tarafından bir e-posta gönderme isteği oluşturuldu.
email.receivedE-posta alındı
Bağlı bir posta kutusu bir e-posta aldı.
HER ŞEYİ GÖRSEL OLARAK YAPILANDIRIN
Yapılandırma dosyalarını düzenlemeden profesyonel webhook yönetimi.
SMSMobileAPI kontrol panelinde Webhook V2'i açın, bir hedef adı ve genel HTTPS URL ekleyin, etkinlikleri seçin ve kaydedin. Kontrol paneli günlük işletme ve sorun giderme için gerekli kontrolleri sağlar.
Birden çok hedef
CRM, izleme, analitik veya müşteri uygulamalarınız için özel hedefler oluşturun.
Etkinlik filtreleri
Her URL'in hangi SMS, arama, WhatsApp ve e-posta etkinliklerini alacağını tam olarak seçin.
Teslimatı test et
Üretim ortamında hedefe güvenmeden önce kontrollü bir test etkinliği gönderin.
Duraklat ve yeniden etkinleştir
Bir hedefi yapılandırmasını silmeden anında durdurun.
Gizli anahtar yenileme
Güvenlik süreçleriniz gerektirdiğinde yeni bir imzalama sırrı oluşturun.
Teslimat etkinliği
Kuyruktaki, teslim edilen, yeniden denenen ve başarısız teslimatları deneme sayısı ve HTTP durum bilgileriyle inceleyin.
Webhook V23 aktif
CRM üretim
https://crm.example.com/hooks/mobileAKTİFsms.receivedcall.missedwhatsapp.received
Operasyon uyarıları
https://ops.example.com/eventsAKTİFsms.failedwhatsapp.failed
Tasarımda Güvenilirlik
Güvenilir ve bağımsız teslimat için tasarlandı.
Webhook teslimatı asenkroniktir. Mobil iş akışınız üçüncü taraf URL'nin yanıtını beklemez ve bir hedefin başarısız olması başka bir müşteriyi veya hedefi engellemez.
Dayanıklı kuyruk
Teslimattan önce uygun etkinlikler saklanır, böylece alıcının geçici kesintisi etkinliği silmez.
En az bir kez teslim
Teslimat tekrar denenebilir. Etkinlik kimliğini saklayın ve kendi uygulamanızda yalnızca bir kez işleyin.
Kademeli yeniden denemeler
Geçici hatalar, platformun yeniden deneme sınırına kadar artan gecikmelerle yeniden denenir.
Hata izolasyonu
Yavaş veya kullanılamayan bir uç nokta, alakasız hedeflere teslimatı engelleyemez.
Otomatik koruma
Sürekli başarısızlık gösteren bir hedef, kuyruğu ve altyapınızı korumak için duraklatılabilir.
Operasyonel görünürlük
Gösterge paneli ve web yöneticisi izleme; kuyruk sağlığını, sonuçları ve son teslimat hatalarını gösterir.
İmzalı ve doğrulanabilir
Olayı güvenilir kabul etmeden önce isteği doğrulayın.
Her teslimatta bir zaman damgası, teslimat tanımlayıcısı, olay türü, sabit idempotans anahtarı ve HMAC-SHA256 imzası bulunur. İmza gizli anahtarını sunucunuzda saklayın, imzayı ham istek gövdesinden hesaplayın ve geçersiz veya süresi geçmiş istekleri reddedin.
X-SMSMobileAPI-EventOlay türü; örneğin sms.received.X-SMSMobileAPI-DeliveryBu hedef için benzersiz teslimat tanımlayıcısı.X-SMSMobileAPI-Timestampİmza doğrulaması sırasında kullanılan Unix zaman damgası.X-SMSMobileAPI-SignatureHMAC-SHA256 imzası (güvenli karşılaştırma için).Idempotency-KeyYinelenen işleme engel olmak için kullanılan sabit etkinlik UUID'si.Tutarlı etkinlik zarfı
Her kanal için tek, tutarlı bir JSON zarfı.
Zarf, SMS, aramalar, WhatsApp ve e-posta genelinde öngörülebilir kalır. data nesnesi olay türüyle ilgili alanları içerirken, üst düzey tanımlayıcılar her teslimatı yönlendirmenize ve tekrarlardan kaçınmanıza olanak verir.
id— sabit etkinlik tanımlayıcısıtype— tam olay türüoccurred_at— etkinliğin ne zaman gerçekleştiğidata— kanala özel bilgiler
{
"id": "whv2_01J...",
"type": "sms.received",
"api_version": "2026-09-22",
"created_at": "2026-09-22T12:00:00Z",
"occurred_at": "2026-09-22T11:59:58Z",
"data": {
"guid": "...",
"from": "+32...",
"message": "Can you call me back?"
}
}Olaydan İş Sonucuna
Mobil iletişimi sonraki iş adımını tetiklemek için kullanın.
CRM görüşmeleri
Alınan bir SMS veya WhatsApp mesajını doğru kişiye ekleyin ve atanan sorumluyu uyarın.
Kaçırılan araları telafi etme
Kaçırılan aramadan sonra bir geri arama görevi oluşturun, takip eden bir SMS gönderin veya nöbetçi ekibi bilgilendirin.
Müşteri desteği
Bir müşteri mobil cihazından yanıt verdiğinde destek bileti açın veya güncelleyin.
E-ticaret operasyonları
Mobil mesaj gönderildikten, onaylandıktan veya başarısız olduktan sonra sipariş iletişim iş akışlarını güncelleyin.
İzleme ve uyarılar
Teslimat hatalarını veya olağandışı çağrı etkinliklerini gözlemlenebilirlik ve olay yönetimi araçlarınıza gönderin.
Yapay zeka ve veri iş akışları
Yetkilendirilmiş olayları sınıflandırma, raporlama veya yardım iş akışlarına API'u tekrar tekrar sorgulamadan besleyin.
Değişiklikleri sorgulamayı durdurun
Sorgulama (polling) tekrar tekrar istek gönderir. Webhook'lar bir değişiklik olduğunda yazılımınızı bilgilendirir.
Sorgulama hiçbir şey olmadığında bile istek tüketir ve kontroller arasında gecikme ekler. Webhook V2 ilgili olayı uç noktanıza ileterek otomasyonu daha hızlı, daha basit ve ölçeklenmesi daha kolay hale getirir.
Yeni bir olay var mı?Tekrarlayan istekler · ek gecikme
Olay
Gerçekleştiğinde beni bilgilendir.İlgili olay · anında iş akışıWebhook V2 SSS
Uç noktanızı bağlamadan önceki sorular.
Bir sorgulama döngüsü oluşturmalı mıyım?＋
Hayır. Webhook V2 abone olunan olayları genel HTTPS uç noktanıza gönderir. Geçmişi veya ayrıntıları sorgulamanız gerektiğinde yine API'leri kullanabilirsiniz.
Birden fazla webhook URL'si yapılandırabilir miyim?＋
Evet. Birden fazla hedef oluşturabilir ve her biri için farklı bir olay kümesi seçebilirsiniz; bu, kontrol panelinde gösterilen hesap limitleri dahilindedir.
SMS'un gerçekten gönderildiğini nasıl anlarım?＋
İşin oluşturulduğunu bilmek için sms.api.submitted'i, bağlı mobil tarafından bildirilen onay için ise sms.sent'i kullanın. Bunları iki farklı operasyonel aşama olarak değerlendirin.
Bir webhook birden fazla kez teslim edilebilir mi?＋
Evet. Webhook V2 en az bir kez teslimatı kullanır. Kararlı olay kimliğini veya Idempotency-Key'ı kaydedin ve zaten işlediğiniz bir teslimatı yok sayın.
Uç noktam ne döndürmeli?＋
Olayı güvenli şekilde kabul ettikten sonra HTTP 2xx yanıtı döndürün. İşleme uygulamanız içerisinde eşzamansız olarak devam edebilir.
Alınan WhatsApp olayları sürekli toplanıyor mu?＋
Hayır. WhatsApp alınan mesajların çekilmesi için kendi onay tabanlı senkronizasyon sürecini izler. Uygun bir mesaj alındıktan sonra whatsapp.received olayı kullanılabilir olur.
Mobil etkinlikleriniz. Yazılımınız. Eylemleriniz.
Yazılımınızı gerçek mobil cihazınızın etkinliklerine şimdi bağlayın.
Hesabınızı oluşturun ya da giriş yapın, Webhook V2'u açın, genel bir HTTPS hedefi ekleyin ve iş akışınıza uygun olayları seçin. Test olayı gönderin, imzasını doğrulayın ve entegrasyonunuzu etkinleştirin.
