WhatsApp webhook'ları: mesajları doğrudan sunucunuza yönlendirme
WhatsApp webhook'u, belirlediğiniz bir HTTPS uç noktasıdır ve Meta olayları buraya gönderir: gelen mesajlar, teslimat durumları, kalite değişiklikleri ve hesap güncellemeleri. Coexistence numarasında hedef kendi sunucunuz olarak ayarlanabilir; böylece konuşmalar hiçbir sağlayıcıdan geçmez.
- Meta olayları doğrudan URL'nize gönderir
- Sağlayıcı paneli değil, sizin uç noktanız
- WhatsApp Business hesabı başına bir geçersiz kılma
7 gün boyunca hiçbir ücret alınmaz. İstediğiniz zaman iptal edin.
Entegrasyonun tamamı: hesap başına bir HTTPS hedefi.
Size yönlendirilen mesaj yolu olayları: messages ve smb_message_echoes.
GET el sıkışmasında Meta'nın gönderdiği ve uç noktanızın aynen döndürmesi gereken değer.
Meta webhook'a tam olarak ne gönderir?
Olayları kategoriler halinde gönderir ve aralarındaki ayrım mimarinizi belirler.
Mesaj yolu, müşterilerin gönderdiklerini ve Coexistence numarasında ekibinizin WhatsApp Business uygulamasından gönderdiklerinin yankılarını taşır. Bunlar messages ve smb_message_echoes alanlarıdır ve konuşma içeriğini barındıran olaylar bunlardır.
Operasyon yolu diğer her şeyi taşır: bağlantı durumu değiştiğinde account_update, kalite veya aktarım hızı değiştiğinde phone_number_quality_update, account_alerts, account_review_update, business_capability_update ve phone_number_name_update. Bunlar konuşma içeriği taşımaz; izleme bunlardan oluşturulur.
Mesaj yoluna kendini yerleştiren bir sağlayıcı ilk grubu alır. Bunu yapmayan almaz.
Meta bir uç noktayı nasıl doğrular?
Herhangi bir şeyi teslim etmeden önce GET isteğiyle doğrular. Bu adımın başarısız olması, tamamlanmış görünen bir kurulumun hiç mesaj almamasının en yaygın nedenidir.
Meta URL'nizi hub.mode değeri subscribe, hub.verify_token değeriniz ve hub.challenge değeriyle çağırır. Uç noktanız bu challenge değerini JSON içine koymadan ve hiçbir şey eklemeden ham yanıt gövdesi olarak döndürmelidir. Döndürmezse Meta teslimata hiç başlamaz ve hiçbir panel bunu göstermez.
Uç nokta ayrıca HTTPS kullanmalıdır. Sessizce 404 döndüren veya Meta'yı reddeden bir kimlik doğrulama katmanının arkasındaki uç nokta, ilk mesaj gelmeyene kadar çalışan bir kurulumla aynı görünür.
Hedef kendi sunucunuza yönlendirilebilir mi?
Evet ve sağlayıcılar arasındaki fark burada ortaya çıkar.
Meta, belirli bir WhatsApp Business hesabının webhook'larını nereye teslim edeceğini uygulama üzerinden geçersiz kılmanıza izin verir. Bu geçersiz kılmayı URL'nize ayarlarız ve mesaj yolu olaylarını bizim geri çağırmamızdan sizin uç noktanıza taşırız. Panel ve uyarılar bu olaylardan oluştuğu için operasyon olaylarını bizde tutarız.
Sonuç, yayımladığımız bir politikadan çok mimariyle ilgilidir. Konuşma içeriği bize hiç teslim edilmediği için tarafımızda depolanacağı bir yer yoktur. Geçersiz kılma ayarlanmamış bir hesap, olayları kalıcı olarak kaydetmeden atan işleyicinin düşürdüğü varsayılan geri çağırmamıza döner.
Bir numara yeniden bağlandığında hedefe ne olur?
Kaldırılır. Neredeyse hiç kimsenin planlamadığı hata budur.
Hedef, telefon numarasının bir özelliği değildir. Uygulamamızın WhatsApp Business hesabı aboneliğindeki bir geçersiz kılmadır. Bir bağlantı Meta'nın on dört günlük etkinliksizlik kuralı nedeniyle veya başka bir sebeple kaldırıldığında uygulama o hesaptan kaldırılır ve geçersiz kılma da onunla birlikte gider.
Yeniden bağlanmak gönderimi ve izlemeyi geri getirir. Sunucunuza teslimatı geri getirmez ve hiçbir şey hata bildirmez. Bu nedenle ilk belirti, bir müşterinin kimsenin yanıt vermediğini söylemesidir. Bu durum temiz biçimde yeniden bağlanan ve sessiz kalan gerçek bir numaranın başına geldiği için her yeniden bağlantıda geçersiz kılmayı yeniden uygularız.
Yaygın hatalar
- Doğrulama GET isteğinden JSON döndürmek. Meta yalnızca ham hub.challenge değerini ve başka hiçbir şeyi istemez.
- Geçici veya test URL'si kullanmak. URL'yi oluşturan araç dinlemeyi bıraktıktan sonra Meta buraya teslimat yapmayı sürdürür.
- Hedefin yeniden bağlantıdan sonra da kalacağını varsaymak. Hedef bir uygulama aboneliğinde yaşar ve abonelikle birlikte kaldırılır.
- Uç noktayı Meta'nın isteğini reddeden kimlik doğrulamanın arkasına koymak.
EasyCoexistence webhook geçersiz kılmasını uç noktanıza ayarlar, aramadan önce doğrular ve her yeniden bağlantıdan sonra otomatik olarak yeniden uygular. Numara başına aylık US$ 9'dan başlayan fiyat, yüksek hacimde US$ 2'ye iner; ilk 7 gün ücretsizdir.
Sık sorulan sorular
Mesajlarım EasyCoexistence'tan geçiyor mu?
Hayır. Geçersiz kılma, mesaj yolu olaylarını Meta'dan doğrudan uç noktanıza gönderir. Geçersiz kılma olmayan hesapların olayları varsayılan geri çağırmamıza döner ve kalıcı olarak kaydedilmeden düşürülür.
Hedefi daha sonra değiştirebilir miyim?
Evet, istediğiniz zaman panelden veya MCP bağlayıcısı üzerinden değiştirebilirsiniz. null göndermek hedefi varsayılan ayarımıza döndürür.
Meta teslimat yaptığında sunucum kapalıysa ne olur?
Meta bir süre yeniden dener ve ardından durur. Mesajlar telefondaki WhatsApp Business uygulamasına yine gelir; bu nedenle entegrasyon çalışmasa bile işletme hiçbir şey kaybetmez.
Birkaç numara için tek webhook yeterli mi?
Evet. Her numarayı aynı uç noktaya yönlendirin ve payload içindeki phone number id alanına göre dallandırın.
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ın7 gün boyunca hiçbir ücret alınmaz. İstediğiniz zaman iptal edin.Doğrulama tarihi