Webhook teslimatını kontrol etme
Olayı hangi uç noktanın alması gerektiğini kontrol edin
Şurayı açın: Settings → Integrations → Webhooks. Uç noktanın etkin ve gerekli olaya abone olduğunu doğrulayın. Hesap webhook izni tüm hesabın uç noktalarını, sırlarını ve teslimat günlüklerini kapsar; yalnızca CRM izni bu erişimi sağlamaz.
SMS için gönderici kimliği seçimini inceleyin. All Sender IDs hesabın abone olduğu tüm SMS olaylarını kapsar; seçili liste mesajın özgün göndericisiyle eşleştirilir. Diğer olay türleri etkilenmez.
Filtre değişikliği geçmişi yeniden oynatmaz
Gönderici seçimi tekrarlar dâhil her teslimat denemesinde kontrol edilir. Değişiklikler eski olayları yeniden göndermez veya zaten sıraya alınmış teslimatları başka yere yönlendirmez.
Teslimat denemesini inceleyin
Teslimat günlüğü zaman, durum, olay, uç nokta, HTTP yanıtı ve hatayı gösterir. İncelediğiniz denemeyi olay ve uç noktayla eşleştirip alıcı günlüklerinizle karşılaştırın.
Eşleşen deneme yok
Alıcı kodunu araştırmadan önce olay aboneliklerini, uç nokta durumunu ve SMS gönderici filtrelerini kontrol edin.
Başarısız deneme
İsteği reddeden veya alamayan alıcı katmanını HTTP yanıtı ya da ağ hatasıyla belirleyin.
Başarılı alındı bildirimi
Uygulama işlemesini ayrı kontrol edin. HTTP onayı, sonraki tüm işlemlerin tamamlandığını kanıtlamaz.
Güvenlik duvarı gelen istekleri kısıtlıyorsa hesap ayarlarındaki güncel teslimat IP listesini kullanın. IP izin listesi olsa bile imzaları doğrulayın.
Önce imza doğrulamasını kontrol edin
IllyVoIP JSON POST isteklerinde şu başlığı gönderir: Illyvoip-Signature. Olayı işlemeden webhook sırrı ve özgün ham istek gövdesiyle doğrulayın.
İmzalanan girdi zaman damgası, nokta ve ham gövdeden oluşur. Doğrulamadan önce JSON’u ayrıştırıp yeniden kodlamak girdiyi değiştirebilir. Kesin HMAC SHA-256 yöntemi için güncel referansa bakın.
Webhook imza sırrı müşteri API anahtarından ayrıdır. Sır döndürüldüyse alıcıyı normal kimlik bilgisi değiştirme sürecinizle güncelleyin. Destek günlüklerinde iki sırrı da açıklamayın.
HTTP yanıtını anlayın
Herhangi bir 2xx
Teslimatı onaylar. Boş bir 200 yanıtı yeterlidir.
Ağ hatası, yanıt yok, 408, 429 veya 5xx
Belgelenen yeniden deneme politikasına göre tekrar denenebilir.
3xx veya diğer 4xx
Teslimatı durdurur. Otomatik tekrar beklemek yerine yönlendirmeleri, erişim kurallarını ve alıcı doğrulamasını kontrol edin.
Geçerli olayları hızla onaylayın, yavaş işleri ayrı kuyruğa alın. Alıcı aynı olayın birden fazla kez alınmasını güvenle karşılayabilmelidir.
Yinelenen işi olay kimliğiyle önleyin
Gövdenin id alanını sabit tekilleştirme anahtarı olarak kaydedin. Illyvoip-Delivery başlığı teslimat işini tanımlar; olay kimliğinin yerine geçmez.
SMS eşleştirmesi için güncel gönderim yanıtı ve webhook belgelerini izleyin. Teslimat işi ve mesaj kimlikleri farklı amaçlara hizmet eder.
Yardım gerektiğinde olay kimliği, deneme zamanı ve saat dilimi, yanıt kodu ve hassas bilgileri temizlenmiş alıcı hatası sağlayın. İmza sırlarını, API anahtarlarını ve ilgisiz olay içeriklerini gizli tutun.
Uç nokta oluşturun, düzenleyin ve kullanımdan kaldırın
Integrations → Webhooks altında Add webhook seçin, alıcı HTTPS URL’sini girin ve yalnızca gereken olayları seçin. Varsa SMS gönderici filtrelerini inceleyip kaydedin. İmza sırrı gösterildiğinde güvenle saklayın; bu hesap API anahtarı değildir.
Doğru uç noktada Edit ile etiket, abonelik, filtre veya etkinliği değiştirin. URL salt okunurdur: farklı URL için yeni uç nokta oluşturun, alıcıdaki imza sırrını güncelleyin ve hazır olduğunda eskisini kaldırın. Testten önce kaydedilen satırı doğrulayın. Yinelenen uç noktalar aynı alıcıya ayrı bildirimler gönderebilir. Eski uç noktayı kaldırmadan hangi uygulamanın kullandığını kontrol edin; silmek işlenmiş olayları geri almaz.
İmza sırrı değişikliklerini koordine edin
Sırrı yalnızca alıcı uygulamayı güncellemeye hazır olduğunuzda döndürün. Onayı okuyun, yeni sırrı güvenle kaydedin ve sonraki teslimatlara güvenmeden alıcıyı güncelleyin. Eski sırrın sonsuza kadar çalışacağını veya döndürmenin geçmiş olayları tekrar göndereceğini varsaymayın. Teslimat günlüğü yakın dönem sorun giderme içindir, tam arşiv değildir; kendi güvenli olay ve işleme kayıtlarınızı tutun.