plasgos-logoPlasgos CRM Doc

Cara Menambahkan WABA Account (Official)

Dokumentasi Fitur Integrasi WhatsApp Business (Official API)

Fitur Integrasi WhatsApp Business (Official API) memungkinkan pengguna menambahkan akun WhatsApp Business mereka ke dalam sistem agar dapat mengirim dan menerima pesan menggunakan WhatsApp Business Cloud API resmi dari Meta.

Integrasi ini ditujukan untuk kebutuhan:

  • Customer support
  • Notifikasi transaksi
  • Broadcast pesan resmi (template)
  • Otomatisasi percakapan (chat room)

Semua komunikasi dilakukan melalui API resmi Meta sehingga aman, stabil, dan sesuai kebijakan WhatsApp.

Sebelum melakukan integrasi, pastikan beberapa prasyarat berikut:

  1. Memiliki WhatsApp Business Account (WABA) yang aktif
  2. Akun terdaftar di Meta Developer Console
  3. Memiliki:
    • WABA ID
    • Access Token dengan permission WhatsApp (whatsapp_business_messaging)
  4. Nomor WhatsApp sudah diverifikasi dan terhubung ke WABA

Pengguna dapat mengakses fitur ini melalui sidebar WhatsApp Business API Plagos, seperti gambar berikut:

waba account

Pada halaman ini, Anda dapat:

  • Melihat daftar WhatsApp Business yang terhubung
  • Menambahkan akun baru (Add Account)
  • Mengedit atau menghapus koneksi akun dari sistem

1. Menambahkan WhatsApp Business Account

Ketika ingin menambahkan akun WhatsApp Business baru, ikuti langkah berikut:

  • Klik tombol Add Account di pojok kanan atas halaman WhatsApp Business Accounts.

  • Lalu akan muncul modal/form WhatsApp Business Cloud API untuk mengisi waba ID dan access token.

add waba
account

Masukkan waba id dan access token dari Meta Developer Console, yang pernah dibuat sebelumnya di Cara membuat dan menghubungkan akun WhatsApp Business (By Meta). :

FieldDeskripsi
WABA IDID WhatsApp Business Account dari Meta
Access TokenToken akses dari Meta (disarankan menggunakan permanent token)

Catatan:

  • Access Token harus memiliki permission whatsapp_business_messaging
  • Rate limit default Meta umumnya 1000 pesan/hari (bergantung akun) Setelah koneksi berhasil, nomor yang terhubung pada WABA akan otomatis ditampilkan di halaman akun.

2. Konfigurasi Webhook Plagos CRM Pada Meta for Developers

Untuk melakukan Integrasi untuk whatsapp business account, kita perlu mengkonfigurasi webhook pada Meta for Developers agar dapat menggunakan fitur whatsapp business sepenuhnya.

2.1 Siapkan URL Callback dan Verifikasi Token

  • Untuk membuat atau mendapatkan URL Callback Plasgos CRM, dapat didapatkan saat anda melakukan proses penambahan akun WhatsApp Business baru di sistem Plagos CRM. Pada modal/form penambahan akun WhatsApp Business, setelah mengisi WABA ID dan Access Token, pada saat scroll ke bagian bawah terdapat webhook configuration berikut.

  • Tapi jika anda sudah memiliki akun WhatsApp Business yang terhubung, anda dapat melihat URL Callback dan Verifikasi Token pada detail akun WhatsApp Business tersebut. Cukup klik tombol Edit pada waba yang sudah terhubung, Webhook configuration terletak di dalam modal yang sama pada bagian bawah waba ID.

waba callback
info

Bagian ini menampilkan data yang perlu Anda set di Meta Developer Console:

FieldDeskripsi
Verify TokenToken verifikasi webhook yang digenerate otomatis oleh sistem Plagos CRM
Callback URLURL webhook yang harus diisi di Meta untuk menerima event WhatsApp (messages, statuses)

2.2 Konfigurasi Webhook di Meta Developer Console

  • Setelah anda mendapatkan Callback URL dan Verify Token dari Plagos CRM, langkah selanjutnya adalah mengkonfigurasi webhook di Meta Developer Console.

  • Kunjungi halaman Meta Developer Console

  • Laku anda akan diarahkan ke halaman aplikasi developer meta, lalu pilih aplikasi yang sudah terhubung dengan WhatsApp Business Anda.

meta developer
console

  • Lalu anda akan diarahkan ke halaman dashboard aplikasi, pada bagian menu sidebar pilih webhook untuk membuka halaman webhook.

  • Lalu masukan link callback URL dan verify token yang sudah didapatkan dari Plagos CRM pada kolom yang tersedia.

  • dan jangan lupa pada dropdown Pilih produk, pilih WhatsApp Business Account

meta developer
webhook

Langkah di Meta Developer Console:

  1. Buka Meta Developer Console → Produk WhatsAppConfiguration
  2. Isi Callback URL dari Plagos CRM di kolom Webhook URL
  3. Isi Verify Token dari Plagos CRM di kolom Verify Token
  4. Simpan dan verifikasi webhook

3. Data yang Disimpan Sistem

Setelah integrasi berhasil, sistem akan menyimpan:

  • WABA ID
  • Status akun (Active / Inactive)
  • Currency (contoh: IDR)
  • Timezone (contoh: Asia/Jakarta)
  • Tanggal integrasi

Data sensitif seperti Access Token disimpan secara aman (encrypted).


4. Manajemen Akun WhatsApp Business

4.1 Status Akun

  • Active → Akun siap digunakan untuk messaging
  • Inactive → Akun tidak digunakan / koneksi gagal

Integrasi dengan Fitur Lain

Setelah akun terhubung, WhatsApp Business dapat digunakan pada:

  • Chat Room → Menerima & membalas pesan
  • Templates → Membuat template message resmi
  • Broadcast (Official) → Pengiriman pesan massal
  • Waba Flow -> Membuat form untuk pengumpulan data via WhatsApp

Dokumentasi ini ditujukan untuk pengguna dan tim teknis sebagai panduan integrasi WhatsApp Business Official API ke dalam sistem Plagos CRM, fokus pada proses penambahan akun WABA dan konfigurasi webhook.