WhatsApp webhook alanları ve hangilerinin nereye gittiği
Bir WhatsApp Business Hesabı, olayları adlandırılmış alanlar olarak iletir. İkisi konuşma içeriği taşır ve uç noktanıza yönlendirilir. Altısı operasyonel durum taşır ve izleme bunlardan oluşturulur. Hangisinin ne olduğunu bilmek mimarinizi belirler.
- İki mesaj alanı, altı operasyonel alan
- Yönlendirme hesap başına ayarlanır
- Genel payload değil, adlandırılmış alanlar
7 gün boyunca hiçbir ücret alınmaz. İstediğiniz zaman iptal edin.
Mesaj yolu alanları: messages ve smb_message_echoes.
İzleme için tutulan operasyonel alanlar.
Bunları ayıran ayar, WhatsApp Business Hesabı başına geçersiz kılınabilir.
Her alan ne taşır?
messages, müşterinin numaraya gönderdiği her şeyi taşır: metin, medya başvuruları, yanıtlar ve tepkiler. smb_message_echoes, ekibinizin WhatsApp Business uygulamasından gönderdiği içerikleri taşır. Bu alan yalnızca Coexistence numarasında bulunur ve yazılımın insan yanıtlarını görmesini sağlar.
account_update bağlantı durumunu taşır: uygulama hesaptan kaldırıldığında PARTNER_REMOVED, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED ve kısıtlama veya ihlal olayları. phone_number_quality_update kalite puanını ve iletişim hacmi değişikliklerini taşır. account_alerts, Meta'nın hesap için oluşturduğu uyarıları taşır; account_review_update ise inceleme sonucunu taşır.
business_capability_update mesajlaşma limiti ve yetenek değişikliklerini taşır; phone_number_name_update ise görünen ad onaylarını ve retlerini taşır.
Bu ayrım mimari açıdan neden önemlidir?
Çünkü konuşma içeriğinin bir sağlayıcıya ulaşıp ulaşmayacağını belirler.
Geçersiz kılma ayarı, iki mesaj alanını Meta'dan doğrudan uç noktanıza gönderir. Altı operasyonel alan sağlayıcıya gitmeye devam eder. Böylece hiç kimse bir mesajı elinde tutmadan panel ve uyarı sistemi oluşturulabilir.
Mesajları saklamama iddiasının neden bazen bir politika yerine yapısal bir özellik olduğunu da bu açıklar. Mesaj alanları başka yere gönderiliyorsa saklanabilecekleri bir kod yolu yoktur. Bizim durumumuzda geçersiz kılma ayarlanmamış bir hesap varsayılan geri çağrısına döner; işleyici bu olayları kalıcı olarak saklamadan bırakır.
İşleyiciniz hangi alanları beklemeli?
Geçersiz kılma ayarı yapılmışsa yalnızca iki mesaj alanını beklemelidir. Diğer her şeyi hata vermek yerine yok sayacak şekilde işleyici yazmanız faydalı olur.
Meta zaman içinde alanlar ekler ve bir payload biçimi haber vermeden yeni anahtarlar kazanabilir. Alan adına göre seçim yapan ve tanımadığı alanları yok sayan bir işleyici çalışmaya devam eder; belirli bir biçimi varsayan işleyici ise ilk bilinmeyen olayda hata verir.
smb_message_echoes alanını gürültü olarak değerlendirmek yerine açıkça ele almak da faydalıdır. Bu alan olmadan yazılım, bir insanın zaten yanıt verdiğini bilemez ve müşteri aynı soruya iki yanıt alabilir.
Yaygın hatalar
- Genel bir payload varsaymak. Her olay kendi alanını belirtir ve işleyici buna göre seçim yapmalıdır.
- smb_message_echoes alanını yok saymak. Bu olmadan yazılım, zaten yanıt vermiş bir insanın üzerine yanıt gönderir.
- Tanımadığı alanlarda hata vermek yerine onları atlamamak. Meta, sormadan alan ekler.
EasyCoexistence, operasyonel alanlara izleme için abone olur ve iki mesaj alanını uç noktanıza yönlendirir. Uç nokta ayarlamadıysanız bunları kalıcı olarak saklamadan bırakır.
Sık sorulan sorular
Yalnızca bazı alanları alabilir miyim?
Geçersiz kılma ayarı mesaj yolunu size taşır. Operasyonel ayrım sabittir, çünkü izleme bunun üzerinden oluşturulur.
smb_message_echoes normal bir Cloud API numarasında bulunur mu?
Hayır. Coexistence numarasından hem bir insan uygulama üzerinden hem de yazılım API üzerinden gönderim yaptığı için bulunur.
Hedef belirlemezsem mesaj olaylarına ne olur?
Varsayılan geri çağrımıza ulaşır ve kalıcı olarak saklanmadan bırakılır.
Alan adları Meta'nın mı, sizin mi?
Meta'nın. Buradaki adların hiçbirini biz uydurmadık; bu nedenle bir kez öğrenmeye değerler.
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