Sambungkan bot Botpress ke WhatsApp dengan Coexistence
Gunakan integrasi WhatsApp Botpress dalam Manual Configuration. Tampal access token dan phone number id bagi nombor yang disambungkan, pilih verify token, dan biarkan App ID serta Client Secret kosong. Kemudian tetapkan URL webhook Botpress dan verify token itu sebagai destinasi webhook nombor tersebut, dan Meta akan menghantar setiap mesej kepada bot.
Medan Client Secret Botpress: jika dibiarkan kosong, pengesahan tandatangan webhook dilangkau.
Medan webhook yang dilanggan oleh panduan Botpress, termasuk mesej dan kemas kini status template.
Tetingkap khidmat pelanggan yang dibuka oleh mesej pelanggan, dan dalam tempoh itu mana-mana mesej perkhidmatan boleh dihantar.
Konfigurasi Botpress manakah yang berfungsi dengan nombor Coexistence?
Manual Configuration. Pilihan lain menyambungkan nombor melalui aplikasi Meta milik Botpress sendiri, iaitu proses onboarding nombor yang berasingan dan bukan cara untuk menggunakan nombor yang sudah disambungkan.
Dalam integrasi WhatsApp, buka senarai juntai Configuration dan pilih Manual Configuration. Ia meminta Verify Token, Access Token, Default Bot Phone Number ID, dan secara pilihan App ID, Client Secret serta WABA ID.
Access token, phone number id dan WABA id datang daripada sambungan: dashboard memaparkannya, dan get_api_credentials memulangkannya kepada pembantu. Verify token ialah mana-mana rentetan pilihan anda. App ID dan Client Secret dibiarkan kosong. Panduan Botpress menunjukkan secret itu sebagai medan yang perlu diisi, tetapi definisi integrasinya menandakannya sebagai pilihan dan menyatakan bahawa tanpanya pengesahan tandatangan dilangkau. Perkara ini penting, kerana Meta menandatangani setiap penghantaran dengan app secret milik Tech Provider, yang tidak dipegang oleh mana-mana pelanggan.
Bagaimanakah webhook Botpress menerima mesej daripada Meta?
Melalui destinasi webhook nombor tersebut. Panduan Botpress meminta anda menampal URL webhooknya dan verify token anda ke dalam konfigurasi WhatsApp sebuah aplikasi Meta. Di sini anda tidak mempunyai aplikasi Meta sendiri: Meta menghalakan peristiwa nombor itu ke mana-mana destinasi yang dinamakan oleh sambungan. Jadi salin URL webhook yang dipaparkan Botpress untuk integrasi itu dan tetapkannya, bersama verify token yang sama, sebagai destinasi dalam dashboard atau dengan set_webhook_destination.
Meta menghantar GET pengesahan, Botpress menjawabnya, dan penghantaran bermula. Apabila Botpress menyimpan konfigurasi manual, ia turut menyemak token dengan bertanya kepada Graph aplikasi mana yang mengeluarkannya, jadi token yang tidak sah atau telah dibatalkan akan gagal semasa menyimpan dan bukan pada mesej pertama.
Pengendali Botpress juga memproses smb_message_echoes, peristiwa yang dihantar Meta apabila seseorang membalas dari aplikasi WhatsApp Business. Maka balasan dari telefon dapat dilihat oleh bot dan tidak tersembunyi daripadanya.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
Apakah yang perlu bot ketahui tentang Coexistence?
Bahawa seorang manusia mungkin sudah sedang berbual. Aplikasi WhatsApp Business terus berfungsi pada nombor itu, jadi pelanggan boleh menerima balasan dari telefon dan dari bot dalam minit yang sama. Tentukan dalam flow apa yang berlaku apabila echo tiba: kebanyakan pasukan menghentikan bot buat sementara waktu bagi kenalan itu, supaya orang yang masuk campur tidak dipintas.
Perkara kedua ialah masa. Bot yang menjawab mesej masuk berfungsi dalam tetingkap khidmat pelanggan 24 jam, yang membenarkan teks bebas. Flow yang menghantar sesuatu sehari kemudian, seperti susulan atau peringatan, memerlukan template yang diluluskan, dan teks bebas di situ akan memulangkan ralat 131047. Panduan Botpress melanggan medan status template untuk jenis mesej proaktif seperti ini.
Dan throughput ditetapkan pada 20 mesej sesaat bagi nombor Coexistence, jauh melebihi apa yang dihantar oleh bot perbualan.
Kesilapan biasa
- Mengisi Client Secret dengan secret aplikasi Meta anda sendiri. Tandatangan tidak akan sepadan dan Botpress menjawab setiap penghantaran dengan 401.
- Memilih pilihan OAuth atau sandbox dan bukannya Manual Configuration. Pilihan itu menyambungkan nombor melalui aplikasi Botpress sendiri, bukan nombor yang sudah disambungkan.
- Mengabaikan echo. Tanpa peraturan untuk balasan yang dihantar dari telefon, bot menjawab di atas orang yang sudah masuk campur.
Sambungkan nombor di easycoexistence.com, tampal token dan phone number id ke dalam Manual Configuration Botpress, dan tetapkan URL webhook Botpress sebagai destinasi. Daripada US$ 9 sebulan bagi setiap nombor, jatuh kepada US$ 1 apabila anda menambah nombor, dengan 3 hari pertama percuma.
Soalan lazim
Adakah selamat melangkau semakan tandatangan?
Perlindungan beralih kepada URL. Botpress menjana URL webhook bagi setiap integrasi, jadi pastikan ia dirahsiakan. Media masih perlu diambil daripada Meta dengan token, dan peristiwa palsu tidak dapat memalsukannya.
Bolehkah nombor yang sama turut menghantar peristiwa ke n8n?
Sebuah nombor hanya mempunyai satu destinasi webhook. Halakan ia ke satu sistem dan majukan dari situ jika sistem kedua memerlukan peristiwa tersebut.
Adakah Botpress memerlukan WABA id saya?
Definisinya menandakannya sebagai pilihan buat masa ini dan menyatakan ia akan diwajibkan dalam versi major akan datang, jadi isikannya daripada sambungan.
Adakah mesej melalui EasyCoexistence?
Tidak. Meta menghantar terus ke URL webhook Botpress, dan kandungannya tidak pernah disimpan di pihak kami.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada