Panduan ini menjelaskan cara menghubungkan WhatsApp resmi (Cloud API / Standard mode) ke Mintol menggunakan System User Token dari Meta Business Manager.
Cloud API adalah mode lanjutan. Token yang digunakan adalah System User Token yang bersifat permanen. Jika belum familiar dengan Meta Business Manager, pertimbangkan menggunakan mode Coexistence yang lebih mudah.
Prasyarat
Sebelum memulai, pastikan kamu sudah memiliki:
- Akses admin ke Meta Business Manager
- WhatsApp Business Account (WABA) yang aktif
- Nomor telepon yang sudah terdaftar di WhatsApp Business API
Langkah 1 — Dapatkan WABA ID
- Buka Meta Business Manager → Business Settings
- Di sidebar kiri, klik WhatsApp Accounts
- Pilih WABA yang ingin dihubungkan
- Catat WABA ID yang tampil di halaman settings (berupa angka panjang)
Langkah 2 — Buat System User dan Generate Token
System User Token bersifat permanen (tidak expire) dan punya akses penuh ke WABA.
- Di Meta Business Manager → Business Settings → System Users
- Klik Add → beri nama, pilih role Admin → klik Create System User
- Klik Add Assets pada System User yang baru dibuat:
- Pilih WhatsApp Accounts → pilih WABA kamu → centang semua permission → klik Save Changes
- Klik Generate New Token:
- Pilih aplikasi Meta kamu
- Centang permission berikut:
whatsapp_business_managementwhatsapp_business_messagingbusiness_management
- Klik Generate Token
- Simpan token ini dengan aman — token tidak akan ditampilkan lagi setelah halaman ditutup
Langkah 3 — Konfigurasi Webhook di Meta App
Agar pesan masuk bisa diterima Mintol, kamu perlu mengatur webhook di aplikasi Meta.
- Buka Meta for Developers → pilih aplikasi kamu
- Di sidebar, klik WhatsApp → Configuration
- Di bagian Webhook, klik Edit:
- Callback URL:
https://yourdomain.ai/api/webhooks/whatsapp - Verify Token: isi dengan verify token dari halaman pengaturan Mintol
- Callback URL:
- Klik Verify and Save
- Subscribe ke field:
messages,message_deliveries,message_reads
Langkah 4 — Tambahkan Aplikasi ke WABA
Agar Mintol bisa mengirim pesan atas nama WABA kamu:
- Meta Business Manager → WhatsApp Accounts → pilih WABA
- Klik Settings → tab Apps
- Klik Add → cari dan tambahkan App ID aplikasi Meta kamu
Langkah 5 — Hubungkan ke Mintol
- Di Mintol, buka halaman Accounts → klik Connect → pilih Cloud API
- Isi form:
- WABA ID: ID yang dicatat di Langkah 1
- System User Token: token yang di-generate di Langkah 2
- Klik Complete Setup
Mintol akan otomatis mengambil nama bisnis dan nomor telepon dari WABA kamu.
Troubleshooting
| Error | Penyebab | Solusi |
|---|---|---|
| Gagal mengambil detail WABA | WABA ID salah atau token tidak punya akses | Pastikan WABA ID benar dan System User sudah diberi akses ke WABA tersebut |
| Gagal subscribe webhook | Aplikasi belum ditambahkan ke WABA | Ulangi Langkah 4 — tambahkan App ke WABA |
| Tidak bisa terima/kirim pesan | Webhook belum dikonfigurasi | Ulangi Langkah 3 — pastikan URL dan verify token benar |
Last modified on