messages webhook'u

Payload ne taşır?

Tek bir teslimatta bir veya daha fazla mesaj bulunabilir; her birinde gönderen, bir id ve bir type vardır. type, hangi diğer anahtarların bulunacağını belirler.

• Gönderenin telefon numarası ve yazdığı numaranın phone number id değeri.
• Tekilleştirmenin üzerine kurulduğu wamid message id değeri.
• Bir unix zaman damgası.
• Bir type: text, image, audio, video, document, sticker, location, contacts, reaction, button veya interactive.
• Medya türlerinde, baytların kendisi yerine alınacak bir media id değeri.

Yönlendirilmiş numarada neden bize ulaşmaz?

Çünkü geçersiz kılma, bu alanı smb_message_echoes ile birlikte belirlediğiniz hedefe taşır.

Meta, bir WhatsApp Business Account hesabının webhook'larını nereye teslim edeceğini bir uygulamanın geçersiz kılmasına izin verir. Bu geçersiz kılmayı URL'nize ayarlıyoruz; böylece mesaj yolu tamamen altyapımızın dışına çıkar. Teslimat bize hiç ulaşmadığı için bizim tarafımızda kopya, kuyruk veya saklama yoktur.

Hedef belirlenmediğinde bu olaylar, işleyicinin kalıcı olarak kaydetmeden attığı varsayılan geri çağrıya gider. Depolamayla ilgili bir iddia ile kod yolu arasındaki fark budur: konuşma içeriğinin gidebileceği hiçbir yer yoktur.

Doğru şekilde nasıl yanıtlanır?

İşi yapmadan önce, iş bittikten sonra değil, 200 döndürün.

Meta, yavaş yanıtı hata sayar ve yeniden dener. Bu nedenle isteği doğrudan işleyen bir işleyici aynı mesajı birden fazla kez görebilir. Hemen yanıt verin, payload'u bir kuyruğa veya arka plan görevine koyun ve işlemi isteğin dışında gerçekleştirin.

Sunucusuz yapılarda bu isteğe bağlı değildir. Yanıt döndürdükten sonra çalışmayı sürdüren bir işlev, yanıt verdiği anda dondurulabilir. Bu nedenle yanıt ve işlem gerçekten ayrı olmalıdır.

Tekilleştirme

Her zaman wamid üzerinden yapın; çünkü yeniden denemeler istisna değil, normaldir.

Aynı mesaj, sizin tarafınızdaki bir hatayla ilgisi olmayan nedenlerle iki kez gelebilir: yavaş yanıt, ağ zaman aşımı veya teslimat sırasında gerçekleşen bir dağıtım. Görülen id değerlerini saklayıp tekrarları atlamak birkaç satır sürer ve müşterinin bir kez mi, iki kez mi yanıt alacağını belirler.

Coexistence numarasında bu daha da önemlidir; çünkü smb_message_echoes aynı yoldan gelir. Her olayı yeni kabul eden bir işleyici, ekibinizin zaten yanıt verdiği bir müşteriye yeniden yanıt verebilir.

Yaygın hatalar

• 200 döndürmeden önce işlem yapmak. Meta, yavaş yanıtı yeniden dener ve mesajı iki kez işlersiniz.
• Tekilleştirmeyi atlamak. Yeniden denemeler tasarım gereğidir, uç durum değildir.
• Payload'da medya baytlarını beklemek. Payload, alınacak bir media id taşır.

Sık sorulan sorular

Okumaya devam edin