Webhook WhatsApp: merutekan pesan langsung ke server Anda

Apa yang sebenarnya dikirim Meta ke webhook?

Event dikirim dalam beberapa kategori, dan perbedaan di antaranya menentukan arsitektur Anda.

Jalur pesan membawa pesan yang dikirim pelanggan dan, pada nomor Coexistence, salinan pesan yang dikirim tim Anda dari aplikasi WhatsApp Business. Field-nya adalah messages dan smb_message_echoes, dan keduanya berisi konten percakapan.

Jalur operasional membawa hal lainnya: account_update saat status koneksi berubah, phone_number_quality_update saat kualitas atau throughput berubah, account_alerts, account_review_update, business_capability_update, dan phone_number_name_update. Event-event ini tidak berisi konten percakapan dan menjadi dasar pemantauan.

Penyedia yang menempatkan dirinya di jalur pesan menerima kelompok pertama. Penyedia yang tidak melakukannya tidak menerima kelompok tersebut.

Bagaimana Meta memverifikasi endpoint?

Dengan permintaan GET sebelum mengirim apa pun, dan kegagalan pada tahap ini adalah alasan paling umum mengapa setup yang terlihat selesai tidak pernah menerima pesan.

Meta memanggil URL Anda dengan hub.mode berisi subscribe, hub.verify_token milik Anda, dan nilai hub.challenge. Endpoint Anda harus mengembalikan challenge tersebut sebagai isi respons mentah, bukan dalam JSON dan tanpa tambahan apa pun. Jika tidak, Meta tidak pernah mulai mengirim event, dan tidak ada dashboard yang akan memberitahukannya.

Endpoint juga harus menggunakan HTTPS. Endpoint yang mengembalikan 404 tanpa isi, atau berada di balik lapisan autentikasi yang menolak Meta, terlihat sama seperti setup yang berfungsi hingga pesan pertama tidak pernah tiba.

Bisakah tujuan diarahkan ke server Anda sendiri?

Bisa, dan inilah bagian yang berbeda di antara penyedia.

Meta mengizinkan aplikasi mengubah tujuan pengiriman webhook untuk WhatsApp Business Account tertentu. Kami mengatur override tersebut ke URL Anda, sehingga event jalur pesan berpindah dari callback kami ke endpoint Anda. Kami tetap menyimpan event operasional, karena dashboard dan sistem peringatan dibangun dari event tersebut.

Konsekuensinya bersifat arsitektural, bukan kebijakan yang kami publikasikan. Konten percakapan tidak memiliki tempat untuk disimpan di sisi kami karena tidak pernah dikirim kepada kami. Akun tanpa override akan kembali ke callback default kami, tempat handler membuang event tersebut tanpa menyimpannya.

Apa yang terjadi pada tujuan saat nomor tersambung kembali?

Tujuan tersebut dihapus, dan ini adalah kegagalan yang hampir tidak pernah direncanakan.

Tujuan bukan properti nomor telepon. Tujuan adalah override pada subscription aplikasi kami ke WhatsApp Business Account. Saat koneksi dihapus, baik karena aturan tidak aktif selama empat belas hari dari Meta maupun karena alasan lain, aplikasi dihapus dari akun tersebut dan override ikut terhapus.

Menyambungkan kembali memulihkan pengiriman dan pemantauan. Namun, tindakan ini tidak memulihkan pengiriman ke server Anda, dan tidak ada yang melaporkan kesalahan. Tanda pertama biasanya pelanggan mengatakan tidak ada yang membalas. Kami menerapkan kembali override setiap kali koneksi dibuat ulang karena hal ini pernah terjadi pada nomor nyata yang berhasil tersambung kembali, tetapi kemudian tidak mengirim apa pun.

Kesalahan umum

• Mengembalikan JSON dari GET verifikasi. Meta menginginkan nilai hub.challenge mentah dan tidak ada yang lain.
• Menggunakan URL sementara atau URL pengujian. Meta akan terus mengirim ke sana setelah tool yang membuatnya berhenti mendengarkan.
• Menganggap tujuan tetap ada setelah koneksi dibuat ulang. Tujuan berada pada subscription aplikasi dan ikut dihapus bersamanya.
• Menempatkan endpoint di balik autentikasi yang menolak permintaan Meta.

Pertanyaan yang sering diajukan

Lanjut membaca