Hubungkan WhatsApp secara manual
Tab Manual Login ditujukan untuk developer yang punya Meta app sendiri dan ingin mengatur webhook sendiri. Bila Anda tidak butuh itu, pakai Embedded Signup.
Ini langkah di sisi tumbuh.ai. Sisi Meta (Meta app, nomor, System User, token) dijelaskan di Manual Login: siapkan di Meta. Kerjakan itu lebih dulu.
Sebelum mulai
- Anda sudah menyelesaikan Persiapan Meta Business dan Manual Login: siapkan di Meta.
- Nomor Anda sudah terdaftar di Cloud API (status
CONNECTED). tumbuh.ai tidak mendaftarkan nomor atau mengatur PIN. - Anda tahu WABA ID. Lihat di Meta Business Suite, bagian WhatsApp Accounts.
- Anda punya access token System User yang tidak kedaluwarsa, dengan izin
whatsapp_business_managementdanwhatsapp_business_messaging. tumbuh.ai tidak memperbarui token Manual Login secara otomatis. - Dua perintah uji di langkah 4 halaman Meta sudah berhasil dengan token itu.
- Kuota channel paket Anda masih tersedia.
Langkah
- Buka Platform > WhatsApp. Klik Add Account bila sudah ada akun lain.
- Pada kartu "Hubungkan WhatsApp Business", pilih tab Manual Login.
- Isi WABA ID.
- Isi Access Token.
- Klik Connect WABA.
- Setelah berhasil, kartu "Connected Successfully" menampilkan Webhook URL dan Verify Token. Salin keduanya dengan tombol salin.
- Buka Meta App Dashboard (tombol Open Meta Dashboard ada di kartu yang sama).
- Masuk ke WhatsApp > Configuration > Webhooks.
- Klik Edit pada kolom Webhook URL.
- Tempel Webhook URL dan Verify Token dari tumbuh.ai, lalu klik Verify and Save.
- Langganan (subscribe) field webhook
messages. - Kembali ke tumbuh.ai, lalu klik Done.
Anda bisa membuka lagi informasi ini kapan saja dari menu tiga titik pada kartu perangkat, lewat Webhook Info.
Regenerate Token
Di dialog Webhook Info ada tombol Regenerate Token. Tombol ini membuat Verify Token baru dan membatalkan yang lama. Setelah itu, perbarui Verify Token di konfigurasi webhook Meta App Anda agar cocok. Bila tidak, verifikasi ulang webhook berikutnya akan gagal. Pengiriman pesan yang sedang berjalan tidak terputus.
Catatan keamanan
Jaga kerahasiaan Webhook URL, Verify Token, dan access token Anda. Anda tidak perlu memberikan App Secret Meta app ke tumbuh.ai. Access token Anda disimpan terenkripsi.
Hasil yang diharapkan
- Meta berhasil memverifikasi webhook (Verify and Save sukses).
- Kartu perangkat tampil dengan lencana Manual dan status Connected.
- Pesan masuk muncul di OneInbox.
Uji dari ujung ke ujung
Setelah Verify and Save berhasil dan field messages berlangganan, uji semuanya:
- Kartu perangkat. Di Platform > WhatsApp, kartu nomor Anda tampil dengan lencana Manual dan status Connected. Nomor, display name, dan kualitas terisi.
- Pesan masuk. Dari WhatsApp pribadi (nomor lain), kirim pesan ke nomor bisnis Anda. Pesan muncul di OneInbox dalam beberapa detik.
- Balasan. Balas dari OneInbox saat jendela 24 jam masih terbuka. Pesan sampai di WhatsApp pribadi Anda.
- Template. Buka Template dan klik Sync from Meta. Template yang sudah ada di WABA Anda muncul.
- Di luar jendela 24 jam. Pesan non-template ditolak. Hanya template yang disetujui yang bisa dikirim.
Bila ada langkah yang gagal, lihat Masalah Setup Meta.
Bila token diganti atau kedaluwarsa
Buat token baru di Meta, lalu hubungkan ulang WABA yang sama lewat tab Manual Login. Koneksi lama diperbarui dengan token baru, dan Verify Token baru dibuat. Perbarui Verify Token di Meta hanya bila Anda menyimpan ulang konfigurasi webhook.
Masalah umum
- "Verify and Save" gagal: pastikan Verify Token yang ditempel sama persis dengan yang di tumbuh.ai. Bila Anda sudah menekan Regenerate Token, pakai token yang baru.
- Pesan masuk tidak muncul: pastikan field
messagessudah disubscribe. - Koneksi gagal atau terputus: lihat Masalah Setup Meta dan Masalah koneksi.
- Pesan gagal terkirim dengan kode error Meta: cek Error WhatsApp.