WhatsApp webhook uç noktasını doğrulama
Herhangi bir olayı teslim etmeden önce Meta, hub.mode, hub.verify_token ve hub.challenge taşıyan bir GET ile uç noktanızı çağırır. Uç noktanız token'ı karşılaştırmalı ve challenge değerini ham gövde olarak döndürmelidir. Bunun dışındaki her durumda teslimat başlamaz.
Yanıt gövdesi olarak geri döndürülmesi gereken değer.
Doğrulama isteğindeki hub.mode değeri.
Meta'nın doğrulayacağı tek şema. HTTP, çağrı yapılmadan önce reddedilir.
Meta tam olarak ne gönderir?
URL'nize üç sorgu parametresi içeren bir GET isteği gönderir. hub.mode, subscribe olarak ayarlanır. hub.verify_token, hedefi ayarlarken yapılandırdığınız token'dır. hub.challenge, Meta'nın bu deneme için oluşturduğu bir değerdir.
Uç noktanız hub.verify_token değerini seçtiğiniz token ile karşılaştırmalı ve eşleşirse hub.challenge değerinin tamamını yanıt gövdesi olarak kullanarak 200 döndürmelidir. JSON içine sarmalanmamalı, çevresinde tırnak olmamalı ve bazı çerçevelerin varsayılan olarak eklediği satır sonunu içermemelidir.
Token eşleşmezse 403 döndürün. Protokolün tamamı budur ve bilerek küçük tutulmuştur.
Yanlış yanıt neden sessizce başarısız olur?
Çünkü doğrulamanın başarısız olması sisteminizde bir hata değil, Meta'nın sisteminde bir eksikliktir.
Challenge doğru şekilde geri döndürülmediğinde Meta, bu hedefe teslimata başlamaz. Sunucunuz doğrulama isteğine 200 döndürür, log'larınız bir isteğin geldiğini gösterir ve hiçbir panel sorun bildirmez. Tek belirti, mesajların hiç gelmemesidir. Çoğu kişi bunu el sıkışma sorunu yerine Coexistence sorunu olarak teşhis eder.
Bu nedenle çağrıdan önce doğrulama yapmak önemlidir. Graph isteğini göndermeden önce URL'nin HTTPS olduğunu ve bir doğrulama token'ı sağlandığını kontrol ederiz. Böylece hatalı bir hedef hemen başarısız olur ve bağlıymış gibi görünmez.
Doğrulamayı başka neler engelleyebilir?
Kodla ilgisi olmayan üç şey.
Uç noktanın önündeki kimlik doğrulama. Bir ağ geçidi, temel kimlik doğrulama katmanı veya IP izin listesi Meta'nın isteğini reddeder; Meta'nın sunacağı kimlik bilgileri yoktur. Doğrulama yolu bunlar olmadan erişilebilir olmalıdır.
Yönlendirme. Meta, verdiğiniz URL'yi çağırır ve standart bir ana bilgisayara yapılan 301 yönlendirmesi, el sıkışmayı tamamlayacak şekilde izlenmez. Son URL'yi verin.
Yanıtı serileştiren bir çerçeve. Her şeyi JSON içine saran bir işleyiciden dize döndürmek, challenge değerinin çevresinde tırnak bulunan bir gövde oluşturur ve bu eşleşmez.
Yaygın hatalar
- JSON döndürmek. Gövde, çevresinde hiçbir şey olmayan ham challenge değeri olmalıdır.
- Uç noktayı kimlik doğrulamasının arkasına koymak. Meta'nın kimlik bilgileri yoktur ve istek reddedilir.
- Meta'ya yönlendirme yapan bir URL vermek. Son URL'yi kullanın.
EasyCoexistence, Meta'yı çağırmadan önce hedefin HTTPS kullandığını ve doğrulama token'ı içerdiğini kontrol eder; başarısız el sıkışmayı hedefi silmek yerine bağlantı zaman çizelgesine kaydeder.
Sık sorulan sorular
Hangi token'ı kullanmalıyım?
Seçtiğiniz herhangi bir dizeyi kullanabilirsiniz. Bu token, uç noktanızın Meta'nın isteğini URL'yi öğrenen başka kişilerin isteklerinden ayırt etmesini sağlar.
Doğrulama ne sıklıkla yapılır?
Kurulum sırasında ve hedef her ayarlandığında yapılır. Çalışan bir uç nokta her olayda yeniden doğrulanmaz.
Kendim test edebilir miyim?
Evet. Kendi uç noktanızı üç parametreyle çağırın ve gövdenin tam olarak challenge değeri olarak geri geldiğini kontrol edin.
Doğrulama sırasında sunucum kapalıysa ne olur?
El sıkışma başarısız olur ve hedef etkinleşmez. Hedefi yeniden kaydetmek doğrulamayı tekrar çalıştırır.
Okumaya devam edin
Başlamaya hazır mısınız?
WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.
Ücretsiz denemeyi başlatınDoğrulama tarihi