Webhook mesej

Kandungan payload

Satu atau lebih mesej dalam satu penghantaran, setiap satunya dengan pengirim, id dan jenis. Jenis tersebut menentukan key lain yang tersedia.

• Nombor telefon pengirim dan phone number id bagi nombor yang mereka hubungi.
• wamid message id, yang menjadi asas pencegahan pendua.
• Cap masa unix.
• Jenis: text, image, audio, video, document, sticker, location, contacts, reaction, button atau interactive.
• Bagi jenis media, media id untuk diambil, bukannya bait media itu sendiri.

Sebab ia tidak sampai kepada kami pada nombor yang dihalakan

Kerana override memindahkan field ini, bersama-sama smb_message_echoes, ke destinasi yang anda tentukan.

Meta membenarkan aplikasi mengatasi lokasi penghantaran webhook bagi WhatsApp Business Account. Kami menetapkan override itu kepada URL anda, lalu laluan mesej dikeluarkan sepenuhnya daripada infrastruktur kami. Tiada salinan, baris gilir atau penyimpanan di pihak kami kerana penghantaran itu tidak pernah sampai ke sana.

Apabila tiada destinasi ditetapkan, peristiwa ini kembali kepada callback lalai kami, yang menggugurkannya tanpa menyimpannya. Itulah perbezaan antara dakwaan tentang penyimpanan dengan laluan kod: tiada tempat untuk kandungan perbualan pergi.

Cara mengaku penerimaan dengan betul

Kembalikan 200 sebelum anda menjalankan kerja, bukan selepasnya.

Meta menganggap respons lambat sebagai ralat dan akan mencuba semula, menyebabkan pengendali yang memproses secara sebaris melihat mesej yang sama lebih daripada sekali. Beri respons serta-merta, letakkan payload pada baris gilir atau tugas latar belakang, dan jalankan kerja di luar permintaan.

Pada serverless, ini bukan pilihan. Fungsi yang telah kembali tetapi terus bekerja mungkin dibekukan sebaik sahaja ia memberi respons, jadi pengakuan penerimaan dan pemprosesan mesti benar-benar berasingan.

Mengelakkan pendua

Sentiasa gunakan wamid kerana percubaan semula ialah perkara biasa, bukan pengecualian.

Mesej yang sama boleh tiba dua kali atas sebab yang tiada kaitan dengan ralat di pihak anda: respons lambat, tamat masa rangkaian atau deploy yang berlaku ketika penghantaran. Menyimpan id yang telah dilihat dan melangkau pengulangan hanya memerlukan beberapa baris, tetapi membezakan antara pelanggan yang dijawab sekali dengan pelanggan yang dijawab dua kali.

Pada nombor Coexistence, perkara ini lebih penting kerana smb_message_echoes tiba melalui laluan yang sama. Pengendali yang menganggap setiap peristiwa sebagai baharu akan membalas di atas jawapan manusia yang telah diberikan.

Kesilapan biasa

• Memproses sebelum mengembalikan 200. Meta mencuba semula respons lambat dan anda mengendalikan mesej itu dua kali.
• Melangkau pencegahan pendua. Percubaan semula memang direka begitu, bukan kes terpencil.
• Menjangkakan bait media dalam payload. Payload membawa media id untuk diambil.

Soalan lazim

Teruskan membaca