Panduan Manual Login WhatsApp Cloud API di api.co.id

Apa itu Manual Login?

Di dashboard api.co.id, saat menghubungkan WhatsApp Business Account Anda akan melihat dua tab:

• Embedded Signup — login via Meta, webhook otomatis, cocok untuk mayoritas use case.
• Manual Login — Anda menempelkan WABA ID dan Access Token (biasanya System User Token permanen) dari Meta Business Settings.

Setelah Manual Login berhasil, api.co.id akan:

• Memvalidasi token ke Meta Graph API (v22.0).
• Mengambil data WABA (nama, timezone, messaging tier, template namespace).
• Menyinkronkan semua nomor telepon yang terdaftar di WABA tersebut.
• Membuat Verify Token webhook unik per akun (64 karakter hex).
• Menampilkan Webhook Callback URL yang harus Anda daftarkan di Meta App.

Kapan Menggunakan Manual Login vs Embedded Signup

Prasyarat Sebelum Mulai

Pastikan Anda sudah memiliki:

• Akun api.co.id (daftar gratis jika belum).
• Meta App dengan produk WhatsApp — ikuti Langkah 1 jika belum punya.
• Akses admin ke Meta Business Portfolio (Business Settings).
• WhatsApp Business Account (WABA) — sudah ada atau akan dibuat.
• Nomor telepon yang bisa diverifikasi via SMS atau panggilan suara (jika belum ditambahkan ke WABA).
• WABA ID (WhatsApp Business Account ID).
• System User Access Token permanen dengan permission WhatsApp.

Langkah 1 — Buat Meta App di Developer

Sebelum menghubungkan nomor ke api.co.id, Anda memerlukan Meta App sendiri di Meta for Developers. App inilah yang menjadi jembatan antara WhatsApp Cloud API, webhook, dan System User Token yang akan Anda gunakan di Manual Login. Untuk panduan visual langkah demi langkah, lihat juga Create Meta App (Kapso Docs).

Jika Anda sudah punya Meta App dengan produk WhatsApp aktif, lewati langkah ini dan lanjut ke Langkah 2.

1.1 Buat aplikasi baru

1. Buka Meta for Developers dan login dengan akun Facebook yang memiliki akses ke Business Portfolio Anda.
2. Klik Create App (Buat Aplikasi).
3. Pilih use case Connect with customers through WhatsApp (Hubungkan dengan pelanggan melalui WhatsApp).
4. Pilih Business Portfolio yang memiliki nomor WhatsApp Anda, atau portfolio tempat nomor akan didaftarkan.
5. Isi App name (contoh: MyBrand WhatsApp API) dan email kontak, lalu selesaikan wizard pembuatan app.

1.2 Salin App ID & App Secret

Setelah app dibuat, Anda memerlukan dua kredensial ini untuk langkah berikutnya (token & webhook):

1. Di dashboard app, buka App settings → Basic (Pengaturan Aplikasi → Dasar).
2. Salin App ID — angka numerik panjang di bagian atas.
3. Klik Show pada App Secret, lalu salin nilainya. Simpan di password manager — jangan dibagikan ke publik.

1.3 Pastikan produk WhatsApp aktif

1. Dari dashboard app, buka Use cases (Kasus penggunaan).
2. Pastikan Connect with customers through WhatsApp sudah ditambahkan. Jika belum, klik Customize atau Set up untuk mengaktifkannya.
3. Setelah aktif, menu WhatsApp → API Setup akan tersedia — ini dipakai di Langkah 2 untuk menambahkan nomor telepon.

Langkah 2 — Siapkan Nomor & Token di Meta

2.1 Tambahkan nomor telepon di Meta (jika belum)

1. Buka Meta for Developers → pilih App Anda.
2. Buka menu Use cases → klik Customize pada Connect with customers through WhatsApp.
3. Masuk ke API Setup.
4. Di bagian Send and receive messages, buka dropdown From → klik Add phone number.
5. Ikuti wizard: masukkan nomor, verifikasi via SMS/voice call, dan selesaikan display name.
6. Setelah selesai, salin Phone number ID dan WhatsApp Business Account ID (WABA ID) — Anda akan membutuhkan WABA ID saat Manual Login di api.co.id.

2.2 Buat System User Access Token permanen

Di Meta Business Settings:

1. Buka Users → System users.
2. Klik Add, buat system user baru (contoh: ApiCoId API Access).
3. Klik system user tersebut → Assign assets.
4. Di tab Apps: pilih Meta App Anda → berikan Full control.
5. Di tab WhatsApp accounts: pilih WABA yang memiliki nomor Anda → berikan semua permission yang tersedia.
6. Simpan assignment, lalu klik Generate token.
7. Pilih Meta App yang sama → set expiration ke Never.
8. Centang permission:
   • whatsapp_business_management
   • whatsapp_business_messaging
9. Generate dan salin token segera — Meta hanya menampilkannya sekali.

2.3 Data yang perlu Anda siapkan

Langkah 3 — Hubungkan di Dashboard api.co.id

1. Login ke crm.api.co.id.
2. Buka menu WhatsApp Business Accounts (atau halaman koneksi WABA).
3. Klik Connect WhatsApp → pilih tab Manual Login (badge Advanced).
4. Isi field WABA ID dengan WhatsApp Business Account ID dari Meta.
5. Isi field Access Token dengan System User Token permanen Anda.
6. Klik Connect WABA.

Sistem api.co.id akan:

• Memanggil Meta Graph API untuk memvalidasi token dan WABA ID.
• Mengambil daftar nomor telepon terdaftar di WABA.
• Menyimpan token secara terenkripsi (AES-256-GCM).
• Menampilkan layar sukses beserta Webhook URL dan Verify Token.

Langkah 4 — Konfigurasi Webhook di Meta

Setelah Manual Login berhasil, api.co.id menampilkan dua nilai penting. Salin keduanya — jangan tutup halaman sebelum disalin.

4.1 Webhook Callback URL

Ini adalah endpoint yang menerima event pesan masuk, status pengiriman, dan update template dari Meta.

4.2 Verify Token

Token unik per akun (dibuat otomatis saat connect). Digunakan Meta saat verifikasi webhook pertama kali. Anda bisa melihat ulang atau regenerate token ini dari menu Webhook Info di kartu nomor WhatsApp (hanya untuk akun Manual Login).

4.3 Daftarkan di Meta App Dashboard

1. Buka Meta for Developers → App Anda.
2. Buka Use cases → WhatsApp → Configuration.
3. Di bagian Webhooks, klik Edit atau Configure.
4. Callback URL: tempel
   https://chat.api.co.id/api/v1/webhooks
5. Verify token: tempel Verify Token dari dashboard api.co.id.
6. Klik Verify and Save.
7. Subscribe ke webhook fields berikut (minimal):
   • messages — pesan masuk dari customer
   • message_status — update status terkirim/dibaca/gagal
   • message_template_status_update — status approval template

Langkah 5 — Verifikasi Koneksi Berhasil

Lakukan pengecekan berikut setelah webhook dikonfigurasi:

1. Status kartu nomor di dashboard menampilkan Connected.
2. Kirim pesan ke nomor WhatsApp Business Anda dari HP pribadi → pesan harus muncul di inbox dashboard api.co.id dalam beberapa detik.
3. Balas pesan dari dashboard → customer harus menerima balasan (status berubah dari Sent ke Delivered / Read).
4. Buat template message di dashboard → submit ke Meta → tunggu status APPROVED (webhook message_template_status_update harus aktif).

Tanda webhook belum benar

• Pesan keluar status Sent tapi tidak pernah Delivered.
• Pesan masuk dari customer tidak muncul di dashboard.
• Template status tidak ter-update otomatis.

Solusi: periksa ulang Callback URL, Verify Token, dan pastikan field webhook sudah di-subscribe.

Langkah 6 — Aktifkan Lisensi Nomor

Untuk mengirim pesan via API publik api.co.id, setiap nomor WhatsApp memerlukan lisensi aktif (Rp100.000/bulan per nomor). Setelah Manual Login berhasil:

• Sistem akan mencoba auto-bind lisensi yang sudah Anda beli sebelumnya ke nomor yang baru terhubung.
• Jika belum ada lisensi, buka menu Subscription → beli lisensi → bind ke nomor WhatsApp Anda.
• Tanpa lisensi aktif, API messages/send akan menolak dengan error LicenseExpired (HTTP 402).

Setelah lisensi aktif, generate API Key di menu Developers dan mulai integrasi. Dokumentasi lengkap: docs.api.co.id.

Troubleshooting