Webhook WhatsApp: menghala mesej terus ke pelayan anda
Webhook WhatsApp ialah endpoint HTTPS yang anda tetapkan, dan Meta menghantar peristiwa kepadanya: mesej masuk, status penghantaran, perubahan penarafan kualiti dan kemas kini akaun. Pada nombor Coexistence, destinasi boleh ditetapkan kepada pelayan anda sendiri, jadi perbualan tidak melalui penyedia sama sekali.
- Meta menghantar peristiwa terus ke URL anda
- Endpoint anda, bukan platform penyedia
- Satu penggantian bagi setiap WhatsApp Business Account
Tiada caj selama 7 hari. Batalkan pada bila-bila masa.
Keseluruhan integrasi: satu destinasi HTTPS bagi setiap akaun.
messages dan smb_message_echoes, iaitu peristiwa laluan mesej yang dihalakan kepada anda.
Nilai yang dihantar Meta dalam jabat tangan GET, yang mesti dipulangkan oleh endpoint anda.
Apakah yang sebenarnya dihantar Meta kepada webhook?
Peristiwa dihantar mengikut kategori, dan perbezaan antara kategori itu menentukan seni bina anda.
Laluan mesej membawa perkara yang dihantar pelanggan dan, pada nombor Coexistence, salinan perkara yang dihantar pasukan anda daripada aplikasi WhatsApp Business. Medan tersebut ialah messages dan smb_message_echoes, dan kedua-duanya mengandungi kandungan perbualan.
Laluan operasi membawa segala yang lain: account_update apabila keadaan sambungan berubah, phone_number_quality_update apabila kualiti atau throughput berubah, account_alerts, account_review_update, business_capability_update dan phone_number_name_update. Semua ini tidak mengandungi kandungan perbualan dan menjadi asas pemantauan.
Penyedia yang meletakkan dirinya dalam laluan mesej menerima kumpulan pertama. Penyedia yang tidak berbuat demikian tidak menerimanya.
Bagaimanakah Meta mengesahkan endpoint?
Dengan permintaan GET sebelum apa-apa dihantar, dan kegagalan di sini ialah sebab paling biasa persediaan yang kelihatan selesai tidak pernah menerima mesej.
Meta memanggil URL anda dengan hub.mode ditetapkan kepada subscribe, hub.verify_token anda dan nilai hub.challenge. Endpoint anda mesti memulangkan challenge itu sebagai badan respons mentah, bukan dalam JSON dan tanpa tambahan lain. Jika tidak, Meta tidak akan mula menghantar apa-apa, dan tiada dashboard akan memaklumkannya.
Endpoint itu juga mesti menggunakan HTTPS. Endpoint yang memulangkan 404 senyap, atau yang berada di sebalik lapisan pengesahan yang menolak Meta, kelihatan sama seperti persediaan yang berfungsi sehingga mesej pertama tidak tiba.
Bolehkah destinasi menunjuk kepada pelayan anda sendiri?
Ya, dan inilah bahagian yang berbeza antara penyedia.
Meta membenarkan aplikasi mengatasi tempat webhook bagi WhatsApp Business Account tertentu dihantar. Kami menetapkan penggantian itu kepada URL anda, lalu memindahkan peristiwa laluan mesej daripada callback kami kepada anda. Kami mengekalkan peristiwa operasi kerana dashboard dan amaran dibina daripadanya.
Kesannya bersifat seni bina, bukan dasar yang kami terbitkan. Kandungan perbualan tiada tempat untuk disimpan di pihak kami kerana ia tidak pernah dihantar kepada kami. Akaun yang tiada penggantian akan kembali kepada callback lalai kami, dan pengendali membuang peristiwa tersebut tanpa menyimpannya.
Apakah yang berlaku kepada destinasi apabila nombor disambungkan semula?
Destinasi itu dialih keluar, iaitu kegagalan yang hampir tiada siapa rancang.
Destinasi bukan sifat nombor telefon. Ia ialah penggantian pada langganan aplikasi kami kepada WhatsApp Business Account. Apabila sambungan dialih keluar, sama ada kerana peraturan ketidakaktifan Meta selama empat belas hari atau sebab lain, aplikasi dinyahpasang daripada akaun itu dan penggantian turut terhapus.
Sambungan semula memulihkan penghantaran dan pemantauan. Ia tidak memulihkan penghantaran ke pelayan anda, dan tiada ralat dilaporkan, jadi petanda pertama ialah pelanggan berkata tiada siapa membalas. Kami menggunakan semula penggantian itu pada setiap sambungan semula kerana perkara ini berlaku kepada nombor sebenar yang berjaya disambungkan semula tetapi menjadi senyap.
Kesilapan biasa
- Memulangkan JSON daripada GET pengesahan. Meta mahukan nilai mentah hub.challenge sahaja.
- Menggunakan URL sementara atau ujian. Meta terus menghantar kepadanya selepas alat yang menjana URL itu berhenti mendengar.
- Menganggap destinasi kekal selepas sambungan semula. Destinasi berada pada langganan aplikasi dan dinyahpasang bersamanya.
- Meletakkan endpoint di sebalik pengesahan yang menolak permintaan Meta.
EasyCoexistence menetapkan penggantian webhook kepada endpoint anda, mengesahkannya sebelum panggilan dan menggunakannya semula secara automatik selepas setiap sambungan semula. Daripada US$ 9 bagi setiap nombor yang disambungkan sebulan, turun kepada US$ 2 mengikut jumlah penggunaan, dengan 7 hari pertama percuma.
Soalan lazim
Adakah mesej saya melalui EasyCoexistence?
Tidak. Penggantian menghantar peristiwa laluan mesej daripada Meta terus ke endpoint anda. Peristiwa bagi akaun tanpa penggantian kembali kepada callback kami dan dibuang tanpa disimpan.
Bolehkah saya menukar destinasi kemudian?
Ya, pada bila-bila masa, melalui dashboard atau penyambung MCP. Menghantar null menetapkannya semula kepada lalai kami.
Apakah yang berlaku jika pelayan saya tidak berfungsi ketika Meta menghantar?
Meta akan cuba semula untuk suatu tempoh, kemudian berhenti. Mesej masih tiba dalam aplikasi WhatsApp Business pada telefon, jadi perniagaan tidak kehilangan apa-apa walaupun integrasi gagal.
Adakah satu webhook mencukupi untuk beberapa nombor?
Ya. Halakan setiap nombor ke endpoint yang sama dan buat percabangan berdasarkan phone number id penerima dalam payload.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaTiada caj selama 7 hari. Batalkan pada bila-bila masa.Disahkan pada