Medan webhook WhatsApp dan tujuan setiap satunya

Apakah kandungan setiap medan?

messages membawa semua yang dihantar pelanggan ke nombor tersebut: teks, rujukan media, balasan dan reaksi. smb_message_echoes membawa perkara yang dihantar oleh pasukan anda daripada aplikasi WhatsApp Business. Medan ini hanya wujud pada nombor Coexistence dan membolehkan perisian melihat balasan manusia.

account_update membawa keadaan sambungan: PARTNER_REMOVED apabila aplikasi dinyahpasang daripada akaun, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED, serta peristiwa sekatan atau pelanggaran. phone_number_quality_update membawa perubahan penarafan kualiti dan throughput. account_alerts membawa amaran yang dibangkitkan Meta terhadap akaun, manakala account_review_update membawa keputusan semakan.

business_capability_update membawa perubahan had dan keupayaan pemesejan, manakala phone_number_name_update membawa kelulusan dan penolakan nama paparan.

Mengapa pembahagian ini penting dari segi seni bina?

Kerana pembahagian ini menentukan sama ada kandungan perbualan sampai kepada penyedia.

Override menghantar dua medan mesej terus daripada Meta ke endpoint anda. Enam medan operasi terus dihantar kepada penyedia, lalu membolehkan dashboard dan amaran tanpa sesiapa memegang mesej.

Sebab itu dakwaan bahawa mesej tidak disimpan boleh berpunca daripada struktur, bukan dasar. Jika medan mesej dihantar ke tempat lain, tiada laluan kod yang boleh menyimpannya. Dalam kes kami, akaun tanpa override kembali kepada callback lalai, dan pengendali membuang peristiwa tersebut tanpa menyimpannya.

Apakah medan yang patut dijangka oleh pengendali anda?

Hanya dua medan mesej jika override ditetapkan. Pengendali juga wajar mengabaikan perkara lain dan bukannya gagal apabila menerimanya.

Meta menambah medan dari semasa ke semasa, dan bentuk payload boleh mendapat kunci baharu tanpa notis. Pengendali yang memilih tindakan berdasarkan nama medan dan mengabaikan perkara yang tidak dikenalinya akan terus berfungsi. Pengendali yang menganggap bentuk tertentu akan gagal pada peristiwa pertama yang tidak dikenali.

Anda juga wajar mengendalikan smb_message_echoes secara jelas dan bukannya menganggapnya sebagai gangguan. Tanpanya, perisian tidak tahu bahawa manusia sudah menjawab, lalu pelanggan mungkin menerima dua balasan kepada soalan yang sama.

Kesilapan biasa

• Menganggap payload umum. Setiap peristiwa menamakan medannya, dan pengendali patut memilih tindakan berdasarkan nama itu.
• Mengabaikan smb_message_echoes. Tanpanya, perisian membalas selepas manusia sudah menjawab.
• Gagal apabila menerima medan yang tidak dikenali dan bukannya melangkauinya. Meta menambah medan tanpa meminta kebenaran.

Soalan lazim

Teruskan membaca