Cara menambah WhatsApp ke SaaS anda dengan Embedded Signup dan Coexistence
Sebuah SaaS menambah WhatsApp dengan menyambungkan setiap nombor sedia ada pelanggan melalui Embedded Signup Meta dengan Coexistence, supaya nombor itu terus berfungsi dalam aplikasi WhatsApp Business. Dengan Partner API easyCoexistence, satu sesi sambungan bagi setiap pelanggan menjalankan proses ini pada halaman yang dihoskan, Meta menyampaikan mesej nombor itu ke webhook_url anda, dan backend anda membalas melalui Cloud API menggunakan token pelanggan itu sendiri.
Throughput tetap bagi nombor yang digunakan bersama aplikasi WhatsApp Business dan Cloud API.
Versi aplikasi WhatsApp Business paling lama yang nombor pelanggan boleh sambung melalui Coexistence.
Sejauh mana sejarah sembang yang boleh dikongsi Meta semasa penyertaan awal; ia mesti disegerakkan dalam masa 24 jam.
Tetingkap khidmat pelanggan WhatsApp selepas mesej atau panggilan pengguna; setiap mesej baharu menetapkannya semula.
Tarikh Meta menamatkan Embedded Signup v2 dan v3, dengan integrasi dipindahkan ke v4.
Apakah bahagian dalam integrasi WhatsApp?
Lima, dan easyCoexistence mengambil alih yang pertama dan yang terakhir. Produk anda mengekalkan logik perbualan, kotak masuk dan apa sahaja yang ditulis oleh model anda atau kakitangan pelanggan, manakala Meta membawa mesej antara nombor dan pelayan anda:
Apakah yang Coexistence ubah untuk pelanggan anda?
Mereka mengekalkan nombor dan telefon mereka. Aplikasi WhatsApp Business terus berfungsi bersama Cloud API, jadi kakitangan membalas di telefon manakala produk anda membalas melalui API, dan apa yang mereka hantar dari aplikasi tiba di webhook anda sebagai smb_message_echoes. Tiga had menyertainya: nombor itu menghantar pada kadar tetap 20 mesej sesaat, hanya API boleh menghantar template, dan Meta memutuskan sambungan nombor apabila telefon tidak aktif selama kira-kira 14 hari.
Bagaimana langkah sambungan kelihatan dalam produk anda?
Butang Sambung WhatsApp memanggil POST /connect-sessions daripada backend anda dengan redirect_url, id pelanggan anda sebagai external_ref, dan webhook_url dengan webhook_verify_token, supaya Meta menghalakan nombor itu kepada anda sejak minit pertama. Pelanggan mengesahkan senarai semak ringkas pada halaman yang dihoskan, menjalankan tetingkap timbul Meta, mengimbas kod QR dengan aplikasi WhatsApp Business dan kembali kepada anda dengan connection_id. Sama ada untuk menjalankan Embedded Signup daripada aplikasi Tech Provider anda sendiri ditimbang dalam panduan Embedded Signup.
Bagaimana mesej sampai ke backend anda?
Daripada Meta, terus ke webhook_url, tanpa singgah di easyCoexistence dan tanpa salinan disimpan. Medan messages membawa apa yang pelanggan hantar dan status apa yang anda hantar, dan smb_message_echoes membawa apa yang kakitangan hantar dari aplikasi. Meta menandatangani setiap penghantaran dengan rahsia aplikasi easyCoexistence yang tidak pernah dikongsi, jadi laluan URL yang panjang dan rawak mengesahkannya. Dua nombor dalam satu WhatsApp Business Account berkongsi destinasi yang sama: lakukan penghalaan mengikut value.metadata.phone_number_id.
Bagaimana backend anda membalas dan menghantar template?
Dengan Graph API Meta dan token pelanggan daripada GET /connections/{id}?credentials=1, yang turut memulangkan send_endpoint. Teks bebas dihantar dalam masa 24 jam selepas mesej terakhir orang itu; selepas itu, hanya template yang diluluskan Meta:
- Balas: POST /<
PHONE_NUMBER_ID>/messages dengan type text, dalam tetingkap. - Template: panggilan sama dengan type template, nama template dan kod bahasanya.
- Cipta template: POST /<
WABA_ID>/message_templates, kemudian semak statusnya, kerana keputusan semakan tidak sampai kewebhook_urlanda. - Media: POST /<
PHONE_NUMBER_ID>/media untuk muat naik; media masuk tiba sebagai ID untuk diambil dengan token yang sama.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $CUSTOMER_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511987654321",
"type": "text",
"text": { "body": "Your table for 4 is booked for 8 pm." }
}'Bolehkah produk anda mengimport sembang sedia ada pelanggan?
Sekali sahaja, semasa sambungan. Dengan webhook_url ditetapkan pada sesi, easyCoexistence meminta Meta menghantar kenalan nombor itu dan, jika pelanggan bersetuju dalam aplikasi, sehingga 180 hari sembang, yang tiba sebagai webhook smb_app_state_sync dan sejarah. Meta hanya membenarkannya dalam masa 24 jam selepas sambungan, jadi pastikan endpoint sudah menjawab sebelum pautan dihantar. Panduan sejarah sembang menerangkan muatan data.
Siapa yang membayar Meta untuk mesej?
Pelanggan anda. Meta mengenakan bayaran untuk mesej yang backend anda hantar melalui API kepada WhatsApp Business Account pelanggan itu sendiri, menggunakan kaedah pembayaran yang mereka tambah di sana, dan perniagaan tanpa kaedah tersebut tidak boleh menghantar template pemasaran. easyCoexistence mengenakan caj kepada akaun anda bagi setiap nombor yang disambungkan dan tidak pernah mengenakan caj untuk mesej atau menaikkan harga Meta.
Apa yang berlaku apabila nombor terputus?
URL acara anda menerima connection.disconnected dengan sebab Meta apabila ia diketahui. PRIMARY_INACTIVITY ialah peraturan 14 hari, dan sesi sambungan baharu untuk pelanggan itu membawa semula nombor yang sama. connection.token_missing bermakna nombor itu disambungkan tanpa token pelanggan, jadi ia menerima mesej tetapi tidak boleh menghantar sehingga sesi baharu menyambungkannya semula.
Kesilapan biasa
- Menghantar pautan sambungan sebelum endpoint webhook anda menjawab. Import sejarah berjalan sekali sahaja, dalam masa 24 jam selepas sambungan, dan kandungan yang dihantar sebelum URL anda berfungsi akan hilang.
- Membalas dengan teks bebas selepas tetingkap ditutup. Apabila 24 jam berlalu sejak mesej terakhir orang itu, hanya template yang diluluskan akan berjaya dihantar.
- Menghantar kempen dari satu nombor pada kelajuan penuh. Nombor Coexistence menghantar pada 20 mesej sesaat, jadi beratur hantaran setiap nombor pada kadar itu.
- Menjangka kakitangan menghantar template dari telefon. Dalam Coexistence hanya API menghantarnya, jadi letakkan penghantaran template dalam produk anda.
easyCoexistence menambah WhatsApp ke SaaS anda dengan Embedded Signup Meta dan Coexistence pada halaman yang dihoskan dan memaparkan nama anda: pelanggan mengekalkan nombor dan aplikasi WhatsApp Business mereka, Meta menyampaikan mesej ke pelayan anda sebagai peristiwa yang ditandatangani. API yang sama menyambungkan Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran. Daripada US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Bolehkah pelanggan menyambungkan nombor yang berada pada penyedia API WhatsApp lain?
Tidak selagi nombor itu masih di sana. Senarai semak yang dihoskan meminta nombor tanpa penyedia API atau alat automasi lain, jadi pelanggan memutuskan sambungannya daripada penyedia itu dahulu.
Bolehkah SaaS saya menghantar template WhatsApp untuk pelanggannya?
Boleh, melalui Cloud API dengan token setiap pelanggan: cipta template pada WhatsApp Business Account mereka, tunggu semakan Meta, kemudian hantarnya.
Adakah easyCoexistence membaca mesej WhatsApp pelanggan saya?
Tidak. Meta menyampaikan mesej nombor secara terus ke webhook_url yang anda tetapkan. Nombor tanpa webhook_url akan kembali ke panggil balik easyCoexistence, di mana mesej dibuang tanpa disimpan.
Berapa kos easyCoexistence bagi setiap nombor WhatsApp?
Daripada US$ 9 hingga US$ 0.75 bagi setiap nombor sebulan, mengikut peringkat jumlah sambungan anda, dengan 3 hari pertama percuma. Caj mesej Meta pergi kepada WhatsApp Business Account setiap pelanggan.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada