Hubungkan bot Botpress ke WhatsApp dengan Coexistence
Gunakan integrasi WhatsApp milik Botpress dalam Manual Configuration. Tempel access token dan phone number id dari nomor yang terhubung, pilih sebuah verify token, dan biarkan App ID serta Client Secret kosong. Lalu atur URL webhook Botpress dan verify token itu sebagai tujuan webhook nomor tersebut, maka Meta mengirimkan setiap pesan ke bot.
Kolom Client Secret di Botpress: jika dibiarkan kosong, verifikasi tanda tangan webhook dilewati.
Webhook field yang di-subscribe panduan Botpress, termasuk messages dan pembaruan status template.
Jendela layanan pelanggan yang dibuka oleh pesan pelanggan, tempat pesan layanan apa pun boleh dikirim.
Konfigurasi Botpress mana yang cocok dengan nomor Coexistence?
Manual Configuration. Opsi lainnya menghubungkan nomor lewat aplikasi Meta milik Botpress sendiri, yaitu onboarding terpisah untuk nomor tersebut, bukan cara memakai nomor yang sudah terhubung.
Di integrasi WhatsApp, buka drop-down Configuration lalu pilih Manual Configuration. Formulirnya meminta Verify Token, Access Token, Default Bot Phone Number ID, dan secara opsional App ID, Client Secret, serta WABA ID.
Access token, phone number id, dan WABA id berasal dari koneksi: dashboard menampilkannya, dan get_api_credentials mengembalikannya kepada asisten. Verify token adalah string apa pun yang Anda pilih. App ID dan Client Secret tetap kosong. Panduan Botpress menyajikan secret itu sebagai kolom yang harus diisi, tetapi definisi integrasinya menandainya opsional dan menyebut bahwa tanpa secret, verifikasi tanda tangan dilewati. Hal ini penting, karena Meta menandatangani setiap pengiriman dengan app secret milik Tech Provider, yang tidak dimiliki pelanggan mana pun.
Bagaimana webhook Botpress menerima pesan dari Meta?
Lewat tujuan webhook milik nomor tersebut. Panduan Botpress meminta Anda menempel URL webhook-nya dan verify token Anda ke konfigurasi WhatsApp pada sebuah aplikasi Meta. Di sini Anda tidak punya aplikasi Meta sendiri: Meta mengarahkan event nomor itu ke tujuan mana pun yang disebut oleh koneksi. Jadi salin URL webhook yang ditampilkan Botpress untuk integrasinya, lalu atur sebagai tujuan, dengan verify token yang sama, di dashboard atau lewat set_webhook_destination.
Meta mengirim GET verifikasi, Botpress menjawabnya, dan pengiriman pun dimulai. Saat Botpress menyimpan konfigurasi manual, ia juga memeriksa token dengan menanyakan ke Graph aplikasi mana yang menerbitkannya, sehingga token yang tidak valid atau dicabut gagal saat penyimpanan, bukan pada pesan pertama.
Handler Botpress juga memproses smb_message_echoes, event yang dikirim Meta saat seseorang membalas dari aplikasi WhatsApp Business. Jadi balasan dari ponsel terlihat oleh bot, tidak tersembunyi darinya.
| 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 |
Apa yang perlu diketahui bot tentang Coexistence?
Bahwa seorang manusia mungkin sudah sedang berbicara. Aplikasi WhatsApp Business tetap berfungsi pada nomor itu, sehingga pelanggan bisa mendapat balasan dari ponsel dan dari bot dalam menit yang sama. Tentukan di dalam flow apa yang terjadi saat sebuah echo tiba: sebagian besar tim menjeda bot untuk kontak itu selama beberapa waktu, agar orang yang turun tangan tidak disela.
Hal kedua adalah waktu. Bot yang menjawab pesan masuk bekerja di dalam jendela layanan pelanggan 24 jam, tempat teks bebas diperbolehkan. Flow yang mengirim sesuatu sehari kemudian, misalnya tindak lanjut atau pengingat, membutuhkan template yang disetujui, dan teks bebas di situ menghasilkan kesalahan 131047. Panduan Botpress men-subscribe field status template justru untuk jenis pesan proaktif seperti ini.
Dan throughput tetap pada 20 pesan per detik untuk nomor Coexistence, jauh di atas yang dikirim bot percakapan.
Kesalahan umum
- Mengisi Client Secret dengan secret milik aplikasi Meta Anda sendiri. Tanda tangan tidak pernah cocok dan Botpress menjawab setiap pengiriman dengan 401.
- Memilih opsi OAuth atau sandbox, bukan Manual Configuration. Opsi itu menghubungkan nomor lewat aplikasi Botpress sendiri, bukan nomor yang sudah terhubung.
- Mengabaikan echo. Tanpa aturan untuk balasan yang dikirim dari ponsel, bot menjawab di atas orang yang sudah turun tangan.
Hubungkan nomor di easycoexistence.com, tempel token dan phone number id-nya ke Manual Configuration Botpress, lalu atur URL webhook Botpress sebagai tujuan. Mulai US$ 9 per nomor per bulan, turun hingga US$ 1 seiring bertambahnya nomor, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah aman melewati pemeriksaan tanda tangan?
Perlindungan berpindah ke URL. Botpress membuat URL webhook per integrasi, jadi jaga kerahasiaannya. Media tetap harus diambil dari Meta dengan token, sesuatu yang tidak bisa dipalsukan oleh event palsu.
Bisakah nomor yang sama juga mengirim ke n8n?
Satu nomor memiliki satu tujuan webhook. Arahkan ke satu sistem, lalu teruskan dari sana jika sistem kedua membutuhkan event-nya.
Apakah Botpress membutuhkan WABA id saya?
Definisinya menandainya opsional untuk saat ini dan menyebut akan wajib di versi mayor mendatang, jadi isi dari koneksi.
Apakah pesan melewati EasyCoexistence?
Tidak. Meta mengirim langsung ke URL webhook Botpress, dan isinya tidak pernah disimpan di sisi kami.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada