Panduan untuk pengguna baru · diperbarui 12 November 2026

Menghubungkan WhatsApp, mulai dari nol.

Belum tahu bedanya bisnis, aplikasi Meta dan WABA? Mulai dari peta sederhana ini. Setelah tahu asal tiap ID, lanjutkan ke jalur koneksi yang sesuai.

Kenali empat hal yang berbeda

Bayangkan bisnis Anda memiliki lemari aset di Meta. Akun WhatsApp dan aplikasi integrasi ada di dalam konteks bisnis itu, tetapi mempunyai ID dan fungsi masing-masing.

Business Portfolio — pemilik aset bisnis

Contoh nama: Toko Contoh. Business Portfolio ID dipakai untuk mengenali bisnis, bukan kolom WABA ID.

WABA — akun WhatsApp bisnis

Wadah untuk nomor dan template. Inilah WhatsApp Business Account ID pada form manual.

Nomor WhatsApp pengirim

Nomor yang pelanggan hubungi mempunyai Phone Number ID sendiri. ID ini berbeda dari angka nomor telepon.

Meta App — aplikasi penghubung

Jembatan agar Piwara dapat memakai API Meta. Memiliki App ID dan App Secret.

Access Token — kunci dengan izin

Dibuat untuk aplikasi tertentu, lalu diberi izin dan akses ke WABA/nomor. Token bukan ID bisnis dan bukan App Secret.

Hubungannya: token dibuat untuk aplikasi yang benar → token diberi akses ke WABA → WABA berisi nomor pengirim. App Secret harus berasal dari aplikasi yang menerbitkan token.

Lihat contohnya sebelum mengisi

Tiga gambar ini membantu mengenali asal ID, tempat mengisinya dan jalur pesan masuk. Klik gambar untuk memperbesar; contoh tidak memakai credential atau data pelanggan.

Bedakan WABA ID dan Phone Number ID. Ilustrasi panduan dengan data contoh, bukan tangkapan layar akun. Nama dan letak menu Meta dapat berbeda.

Bedakan WABA ID dan Phone Number ID

Isi form koneksi Piwara. Ilustrasi panduan dengan data contoh, bukan tangkapan layar akun. Nama dan letak menu Meta dapat berbeda.

Isi form koneksi Piwara

Hubungkan jalur pesan masuk. Ilustrasi panduan dengan data contoh, bukan tangkapan layar akun. Nama dan letak menu Meta dapat berbeda.

Hubungkan jalur pesan masuk

Buka seluruh langkah bergambar →

Kamus nama dan ID yang sering tertukar

IstilahArtinyaTemukan / gunakan di mana?
Akun Facebook pribadiIdentitas Anda untuk login dan memperoleh akses admin.Login pada halaman resmi Meta. Bukan credential yang diisi ke Piwara.
Business Portfolio / Business ManagerTempat bisnis memiliki/mengelola aset, orang dan pengguna sistem.business.facebook.com/settings → pemilih bisnis / Business info. ID-nya bukan WABA ID.
Meta App / Aplikasi MetaIntegrasi yang memiliki App ID dan App Secret. Bukan aplikasi WhatsApp di HP.developers.facebook.com/apps → pilih aplikasi → App settings → Basic.
WABA / WhatsApp Business AccountAkun WhatsApp bisnis yang menampung nomor dan template.WhatsApp → API Setup atau Business Settings → Accounts → WhatsApp accounts. Salin ke WABA ID.
Nomor telepon bisnisNomor yang pelanggan simpan/hubungi, misalnya nomor dengan kode +62.Ditampilkan di WhatsApp Manager/API Setup. Nomor telepon ini bukan Phone Number ID.
Phone Number IDID internal Meta untuk satu nomor pengirim.Pilih nomor di WhatsApp → API Setup, lalu salin Phone Number ID.
Access TokenKunci API dengan scope, akses aset dan masa berlaku.Pengguna sistem untuk operasional; token sementara API Setup untuk uji sesuai batasnya.
App SecretRahasia aplikasi untuk pemeriksaan dan validasi webhook.App settings → Basic → App Secret. Harus cocok dengan aplikasi penerbit token.
Verify TokenKode pencocokan untuk verifikasi callback webhook.Salin dari halaman WhatsApp perusahaan Anda di Piwara. Berbeda dari Access Token.
Configuration IDIdentitas konfigurasi Facebook Login for Business / Embedded Signup.Hanya untuk jalur Via Meta (Embedded Signup). Tidak diisi pada koneksi manual.

Jangan mengenali ID dari panjang angkanya. Baca label dan halaman asalnya.

Sebelum memulai

Siapkan akses berikut. Tidak perlu memasukkan credential ke halaman tutorial ini.

Akses Piwara

Login sebagai owner/admin. Pilih Freemium 7 hari atau bayar paket lebih dulu melalui Billing & Paket.

Akses Meta

Akun Facebook Anda harus diberi hak yang sesuai pada bisnis, aplikasi dan aset WhatsApp. Login saja belum berarti memiliki akses aset.

Nomor yang akan digunakan

Tentukan apakah Anda memakai nomor uji atau nomor bisnis nyata. Untuk nomor nyata, siapkan akses SMS/panggilan jika Meta meminta OTP.

Data bisnis dan jalur nomor

Isi data bisnis yang benar dan ikuti dokumen/review yang diminta Meta. Untuk nomor aktif di HP, tinjau migrasi/coexistence sebelum mengubah akun.

Piwara saat ini mendukung satu nomor aktif per perusahaan. Biaya pesan Meta terpisah dari langganan aplikasi. Pilihan tanpa assisted setup tetap dapat mengikuti panduan mandiri ini.

Pilih jalur yang sesuai dengan kondisi Anda

Langsung / Manual

Untuk menghubungkan nomor/WABA dengan credential dari Meta. Saat ini membutuhkan empat isian: App Secret, Access Token, Phone Number ID dan WABA ID. Panduan di bawah membantu Anda menyiapkannya satu per satu.

Anda tidak perlu Configuration ID. Nomor yang belum selesai aktivasi tetap harus diselesaikan di Meta.

Ikuti panduan manual

Via Meta (Embedded Signup)

Untuk aplikasi yang sudah mempunyai konfigurasi Embedded Signup yang valid. Pada implementasi sekarang, form tetap meminta App ID, App Secret dan Configuration ID sebelum membuka alur Meta.

Ini belum menjadi tombol satu klik tanpa persiapan Meta. Jika Anda belum punya Configuration ID, baca panduan manual dulu atau minta pengelola integrasi menyiapkan jalur OAuth.

Lihat langkah dan prasyarat OAuth

Urutan belajarnya

  1. 1

    Pahami aset

    Kenali Business Portfolio, Meta App, WABA dan nomor pengirim.

  2. 2

    Siapkan akses

    Pilih paket, periksa role dan tentukan nomor yang benar.

  3. 3

    Hubungkan

    Ikuti panduan manual atau konfigurasi OAuth yang sudah siap.

  4. 4

    Buktikan bekerja

    Kirim pesan baru dari ponsel lain, lalu balas lewat Conversations.

Mulai langkah manual

Jika menggunakan Via Meta (Embedded Signup)

Jalur ini berbeda dari manual. Gunakan setelah konfigurasi Embedded Signup aplikasi Anda tersedia.

  1. Pastikan paket aktif dan Anda mempunyai akses owner/admin. Pengelola aplikasi Meta menyiapkan konfigurasi Facebook Login for Business / Embedded Signup, izin dan callback yang diperlukan.
  2. Di WhatsApp → Via Meta (Embedded Signup) → Hubungkan melalui Meta OAuth, isi App ID, App Secret dan Configuration ID dari konfigurasi yang sama. Configuration ID bukan App ID atau WABA ID.
  3. Klik Lanjutkan ke Meta. Pastikan halaman login berasal dari Meta, lalu login dengan akun yang mempunyai akses ke bisnis yang ingin dipakai.
  4. Ikuti pemilihan Business Portfolio, WABA dan nomor pada alur Meta. Selesaikan persyaratan yang diminta. Jangan menganggap nomor uji sebagai nomor bisnis nyata.
  5. Kembali ke Piwara. Jika terdapat beberapa WABA/nomor, penentuan aset dapat memerlukan langkah lanjutan. Periksa nomor yang akhirnya tersambung.
  6. Lakukan pengujian pesan masuk dan balasan. Label Connected saja belum membuktikan seluruh jalur berfungsi.

Jika berhenti pada pengaturan aplikasi/Configuration ID, jalur ini belum siap untuk akun Anda. Koneksi manual juga tetap membutuhkan aset dan izin Meta yang benar; mengganti jalur tidak melewati persyaratan Meta.

Lima status Meta yang tidak sama

Verifikasi nomor

Membuktikan kepemilikan nomor melalui OTP. Pendaftaran/registrasi Cloud API dan PIN dua langkah dapat menjadi tahap lain.

Business Verification

Verifikasi identitas bisnis/portofolio dan dokumen sesuai permintaan Meta. Berbeda dari verifikasi email Piwara.

App Mode / Publish

Status aplikasi penghubung. Development/Unpublished dapat membatasi penggunaan; tinjau kebutuhan akses dan persyaratan publikasi akun Anda.

Review dan akses izin

App Review/tingkat akses dapat diperlukan sesuai penggunaan dan aset yang diakses. Menjadi Live tidak otomatis memberikan seluruh izin.

Nama tampilan dan kondisi akun

Persetujuan nama tampilan, kualitas akun, metode pembayaran Meta dan pembatasan lain ditangani pada layanan Meta. Tidak ditentukan label Connected di Piwara.

Ikuti persyaratan yang benar-benar muncul pada akun Anda. Tutorial ini tidak menjanjikan waktu approval atau menyatakan satu status dapat menggantikan status lainnya.

Checklist koneksi Anda

0/9 selesai

Tandai setelah benar-benar selesai. Checklist ini hanya catatan di browser, bukan pemeriksaan otomatis akun Meta. Token, secret dan ID tidak diminta atau disimpan di sini.

Jika berhenti di tengah, cari gejalanya

Saya tidak tahu ID ini WABA atau bisnis

Lihat lokasi asalnya: Business info menunjukkan portofolio; Accounts → WhatsApp accounts menunjukkan akun WhatsApp. Gunakan WABA dari konteks WhatsApp, bukan dari panjang angka.

Buka langkah terkait →
Nomor tidak ditemukan pada WABA yang dipilih

Kembali ke pemilih From/API Setup. Cocokkan nomor dan WABA. Pastikan token dapat melihat WABA tersebut. Jangan memakai nomor dari akun uji dengan WABA produksi.

Buka langkah terkait →
App Secret tidak valid

Buka aplikasi yang dipilih saat membuat token, lalu ambil App Secret di Basic. Secret dari aplikasi lain atau Access Token yang ditempel ke kolom secret akan ditolak.

Buka langkah terkait →
Token kedaluwarsa atau permission denied

Buat/perbarui token dari aplikasi yang benar. Periksa masa berlaku, ketiga scope yang diperlukan dan penugasan aset ke pengguna sistem.

Buka langkah terkait →
Connected, tetapi chat masuk tidak muncul

Cocokkan nomor tujuan, aktifkan field messages pada aplikasi, lalu Perbaiki webhook untuk subscription WABA. Kirim pesan baru setelah perbaikan. Periksa mode aplikasi dan persyaratan akses Meta.

Buka langkah terkait →
Pesan masuk ada, tetapi kirim/balas gagal

Baca error di bubble pesan. Token untuk kirim bisa kehilangan izin meskipun webhook masih menerima. Periksa juga jendela 24 jam dan opt-out.

Buka langkah terkait →
Nomor pending, OTP atau PIN diminta

Lanjutkan aktivasi nomor pada Meta. OTP, PIN dua langkah, Business Verification dan App Secret mempunyai fungsi berbeda; form manual Piwara tidak menggantikan proses aktivasi nomor.

Buka langkah terkait →
Bisnis belum terverifikasi / aplikasi belum Live

Buka persyaratan pada Business Settings dan dashboard aplikasi masing-masing. Verifikasi bisnis, verifikasi nomor, publikasi aplikasi, review izin dan persetujuan nama tampilan adalah proses terpisah. Satu status selesai tidak otomatis menyelesaikan yang lain.

Buka langkah terkait →
Meta menolak penerima atau negara (misalnya 130497)

Periksa error dan pembatasan akun di Meta. Gunakan support/review Meta bila diperlukan. Mengganti ID atau melakukan retry berulang tidak menghapus pembatasan negara.

Buka langkah terkait →

Saat meminta bantuan, sebutkan tahap dan pesan errornya. Bila mengirim screenshot, tutupi token dan App Secret. Jangan mengirim password Facebook, OTP atau secret melalui chat.

Rujukan resmi dan perubahan tampilan

Panduan dicocokkan dengan alur Piwara pada 12 November 2026. Menu Meta dapat berubah dan beberapa dokumentasi memerlukan login. Gunakan nama fitur/identitas aset untuk mencocokkan langkah, bukan hanya posisi tombol pada screenshot lama.

Tujuannya: pesan masuk terlihat, balasan sampai.

Jika kedua arah sudah berhasil dan nomor pengirim sesuai, lanjutkan ke template, persetujuan penerima dan operasional tim. Jika belum, gunakan gejala di atas untuk kembali ke tahap yang tepat.