Field webhook WhatsApp dan penggunaannya

Apa yang dibawa setiap field?

messages membawa semua yang dikirim pelanggan ke nomor tersebut: teks, referensi media, balasan, dan reaksi. smb_message_echoes membawa pesan yang dikirim tim Anda dari aplikasi WhatsApp Business, yang hanya ada pada nomor Coexistence dan memungkinkan software melihat balasan manusia.

account_update membawa status koneksi: PARTNER_REMOVED saat aplikasi dihapus dari akun, ACCOUNT_OFFBOARDED, ACCOUNT_RECONNECTED, serta event pembatasan atau pelanggaran. phone_number_quality_update membawa perubahan peringkat kualitas dan throughput. account_alerts membawa notifikasi yang dibuat Meta untuk akun tersebut, sedangkan account_review_update membawa hasil peninjauan.

business_capability_update membawa perubahan batas dan kemampuan pengiriman pesan, sedangkan phone_number_name_update membawa persetujuan dan penolakan nama tampilan.

Mengapa pemisahan ini penting secara arsitektur?

Karena pemisahan ini menentukan apakah konten percakapan pernah sampai ke penyedia.

Pengaturan override mengirimkan dua field pesan langsung dari Meta ke endpoint Anda. Enam field operasional tetap diteruskan ke penyedia, sehingga dashboard dan notifikasi dapat berfungsi tanpa ada pihak yang memegang pesan.

Inilah sebabnya klaim tentang tidak menyimpan pesan dapat bersifat struktural, bukan sekadar kebijakan. Jika field pesan dikirim ke tempat lain, tidak ada jalur kode yang dapat menyimpannya. Dalam kasus kami, akun tanpa override kembali menggunakan callback default, dan handler membuang event tersebut tanpa menyimpannya.

Field apa yang harus diharapkan handler Anda?

Hanya dua field pesan jika override telah diatur. Sebaiknya handler mengabaikan hal lain, bukan gagal saat menemukannya.

Meta menambahkan field dari waktu ke waktu, dan struktur payload dapat memperoleh kunci baru tanpa pemberitahuan. Handler yang memilih berdasarkan nama field lalu mengabaikan hal yang tidak dikenali akan tetap berfungsi. Handler yang mengasumsikan struktur tertentu akan gagal saat menerima event yang belum dikenal.

Anda juga sebaiknya menangani smb_message_echoes secara eksplisit, bukan menganggapnya sebagai gangguan. Tanpanya, software tidak tahu bahwa manusia sudah menjawab, sehingga pelanggan bisa menerima dua balasan untuk pertanyaan yang sama.

Kesalahan umum

• Menganggap payload bersifat generik. Setiap event menyebutkan field-nya, dan handler harus memilih berdasarkan field tersebut.
• Mengabaikan smb_message_echoes. Tanpanya, software membalas di atas balasan manusia yang sudah diberikan.
• Gagal saat menemukan field yang tidak dikenali, bukan melewatinya. Meta dapat menambahkan field tanpa meminta persetujuan.

Pertanyaan yang sering diajukan

Lanjut membaca