Webhook messages

Apa yang dibawa payload

Satu atau beberapa pesan dalam satu pengiriman, masing-masing berisi pengirim, id, dan type. type menentukan key lain yang tersedia.

• Nomor telepon pengirim dan phone_number_id dari nomor yang mereka kirimi pesan.
• Id pesan wamid, yang menjadi dasar penghapusan duplikasi.
• Stempel waktu unix.
• type: text, image, audio, video, document, sticker, location, contacts, reaction, button, atau interactive.
• Untuk type media, id media yang digunakan untuk mengambilnya, bukan byte medianya.

Mengapa pesan tidak pernah sampai kepada kami pada nomor yang dirutekan

Karena override memindahkan field ini, bersama smb_message_echoes, ke tujuan mana pun yang Anda tentukan.

Meta mengizinkan aplikasi mengganti tujuan pengiriman webhook WhatsApp Business Account. Kami menetapkan override tersebut ke URL Anda, sehingga jalur pesan sepenuhnya keluar dari infrastruktur kami. Tidak ada salinan, antrean, atau penyimpanan di sisi kami karena pengiriman tidak pernah tiba di sana.

Jika tujuan tidak ditetapkan, event ini kembali ke callback default kami, tempat handler membuangnya tanpa menyimpan data. Inilah perbedaan antara klaim tentang penyimpanan dan jalur kode: tidak ada tempat bagi isi percakapan untuk pergi.

Mengakui dengan benar

Kembalikan 200 sebelum melakukan pekerjaan, bukan sesudahnya.

Meta menganggap respons yang lambat sebagai kesalahan dan mencoba kembali, sehingga handler yang memproses secara inline akan melihat pesan yang sama lebih dari sekali. Segera kirim respons, masukkan payload ke antrean atau tugas latar belakang, lalu lakukan pekerjaan di luar permintaan.

Pada serverless, ini wajib. Fungsi yang mengembalikan respons lalu tetap bekerja dapat dibekukan saat merespons, sehingga pengakuan dan pemrosesan harus benar-benar dipisahkan.

Menghapus duplikasi

Selalu gunakan wamid, karena mencoba kembali adalah hal normal, bukan pengecualian.

Pesan yang sama dapat tiba dua kali karena alasan yang tidak berkaitan dengan bug di sisi Anda: respons lambat, waktu habis jaringan, atau deploy yang berlangsung di tengah pengiriman. Menyimpan id yang sudah dilihat dan melewati pengulangan hanya membutuhkan beberapa baris kode. Inilah perbedaan antara pelanggan yang dijawab sekali dan dua kali.

Pada nomor Coexistence, hal ini lebih penting karena smb_message_echoes tiba melalui jalur yang sama. Handler yang menganggap setiap event sebagai hal baru akan membalas di atas jawaban manusia yang sudah diberikan.

Kesalahan umum

• Memproses sebelum mengembalikan 200. Meta mencoba kembali saat respons lambat dan Anda menangani pesan dua kali.
• Melewati penghapusan duplikasi. Mencoba kembali memang dirancang demikian, bukan kasus yang jarang.
• Mengharapkan byte media di dalam payload. Payload membawa id media untuk digunakan saat mengambilnya.

Pertanyaan yang sering diajukan

Lanjut membaca