Tipe pesan WhatsApp yang tidak didukung

Beberapa pesan berfungsi di aplikasi WhatsApp tetapi tidak dapat dibaca melalui API. Bird mencatat pesan-pesan ini sebagai pesan diterima dengan field unsupported. Anda dapat melihat siapa yang mengirim pesan dan kapan, tetapi Anda tidak dapat membaca kontennya di dashboard atau melalui API. Minta pengirim untuk mengirim ulang informasi sebagai teks atau tipe pesan lain yang didukung.

Mengapa pesan yang diterima bisa memiliki error

Meta dapat menyertakan error 131051 dalam notifikasi pesan masuk ketika WhatsApp Cloud API tidak mendukung konten tersebut. Sebuah fitur dapat berfungsi di aplikasi WhatsApp tetapi tetap tidak tersedia melalui Cloud API.

Bird mencatat notifikasi tersebut dengan direction: inbound dan status: received. last_error pesan dapat berisi meta_error_code: "131051", meskipun Bird tidak mencoba mengirimnya. Dalam kasus ini, error menjelaskan konten masuk yang tidak tersedia. Ini bukan indikasi pengiriman keluar yang gagal.

last_error.code yang dinormalisasi dapat membaca undeliverable pada catatan penerimaan ini. Periksa direction, status, dan last_error.meta_error_code secara bersamaan sebelum memperlakukan catatan sebagai kegagalan pengiriman.

Meta juga menggunakan 131060 untuk pesan yang saat ini tidak tersedia. Ini dapat terjadi ketika seseorang pertama kali mengirim pesan ke bisnis menggunakan nomor aplikasi WhatsApp Business yang terhubung. Artinya berbeda dari error konten tidak didukung 131051. Lihat referensi pesan tidak didukung dari Meta untuk notifikasi ini.

Baca tipe pesan

Field unsupported.type mengidentifikasi konten seakurat yang dimungkinkan oleh notifikasi:

• Ketika Meta menyediakan unsupported.type, Bird mempertahankan nilainya, seperti poll_creation, pin, atau edit.
• Ketika Meta tidak menyertakan unsupported.type, Bird mempertahankan tipe level teratas pesan dalam kolom tersebut. Nilai seperti unsupported atau unknown tidak mengidentifikasi tindakan yang dilakukan pengirim.
• Ketika Meta menyediakan konten yang tidak dimodelkan oleh API Bird, Bird juga mencatat tipenya di sini, seperti order atau system.

Nama tipe tidak menyertakan konten yang hilang. Misalnya, poll_creation tidak memberikan pertanyaan atau pilihan, dan edit tidak memberikan teks pengganti. Simpan nilai tipe yang tidak dikenali saat menyimpan pesan agar integrasi Anda dapat menerima tipe baru.

Bird mendukung gambar, balasan tombol, balasan daftar, dan reaksi. Notifikasi tidak didukung dengan salah satu nama tersebut menjelaskan notifikasi tertentu itu; bukan berarti seluruh fitur tidak didukung. Lihat menerima gambar, balasan interaktif, dan webhook reaksi.

Menangani webhook yang diterima

Pesan tidak didukung mengirimkan whatsapp.received dengan data.unsupported.type. Webhook yang diterima tidak menyertakan last_error dari rekaman pesan; ambil pesan melalui API jika Anda memerlukan diagnostik tersebut.

Tangani unsupported secara eksplisit sebelum memproses konten. Tampilkan bahwa konten tidak tersedia, simpan tipenya, dan konfirmasi webhook dengan respons 2xx setelah Anda menanganinya. Mencoba ulang notifikasi yang sama tidak akan memulihkan konten yang hilang. Lihat pengiriman webhook untuk perilaku konfirmasi dan coba lagi.

Rekaman tetap terlihat di log WhatsApp. Bird menanganinya sebagai pesan masuk untuk jendela layanan pelanggan.

Contoh untuk dicoba

Berikut adalah contoh nilai unsupported.type. Jika aplikasi WhatsApp Anda menawarkan aksi yang sesuai dalam percakapan yang sedang Anda uji, Anda dapat mencobanya dan memeriksa rekaman yang dihasilkan:

Ketersediaan bergantung pada aplikasi, percakapan, dan akun. Anda mungkin menerima tipe generik, atau tidak menerima notifikasi pesan masuk untuk suatu tindakan. Bandingkan pengirim, stempel waktu, dan unsupported.type dengan tindakan yang Anda lakukan. Jika tipenya generik, Anda tidak dapat mengidentifikasi tindakan tersebut hanya dari rekaman itu.

Langkah selanjutnya

• Cara kerja penerimaan pesan: pesan masuk, media, dan webhook
• Menerima balasan interaktif: ketukan tombol dan pilihan daftar
• Log WhatsApp: periksa pesan di dashboard atau API