Menghubungkan WhatsApp Business

Sebelum mulai: apa yang sebenarnya Anda kerjakan

Ada dua jalan menyambungkan WhatsApp, dan yang perlu Anda tahu lebih dulu: jalan cepatnya cukup satu kali masuk dengan Facebook. Anda tidak membuat aplikasi Meta, tidak mencari ID apa pun, dan tidak menempelkan alamat webhook. Dialog resmi Meta yang menuntun semuanya, lalu memasang webhook untuk Anda di belakang layar.

Yang Anda kerjakan sebenarnya cuma satu: menyewa “jalur resmi” agar program bisa mengirim dan menerima WhatsApp atas nama bisnis Anda. Karena resmi, Meta ingin yakin bisnisnya nyata dan nomornya benar milik Anda — itu saja sumber setiap langkahnya.

Buka Channels, tambah channel, pilih WhatsApp Business, lalu tekan “Hubungkan nomor WhatsApp”.
Masuk dengan Facebook di jendela resmi Meta yang terbuka.
Pilih nomornya: nomor baru khusus bisnis, atau nomor WhatsApp yang sudah aktif (metode coexistence).
Ikuti verifikasi Meta — kode OTP untuk nomor baru, atau scan QR untuk nomor lama.
Kembali ke aplikasi ini, pilih AI mana yang menjawab di “Dijawab oleh”, lalu uji dari ponsel Anda.

Catatan: Kalau tombol “Hubungkan nomor WhatsApp” tidak muncul, jalur cepat belum diaktifkan di server Anda — masih ada jalur manual (isi WABA ID, Phone number ID, dan token sendiri) di bagian bawah panduan ini. Sambil menyiapkan WhatsApp, sambungkan Web Chat atau Telegram lebih dulu — AI yang Anda ajari di sana TETAP TERPAKAI saat WhatsApp menyala, tidak perlu diulang.

Belum yakin harus mulai dari kanal mana?

Istilah yang akan Anda temui, dalam bahasa sehari-hari

Anda tidak perlu menghafal ini. Kembalilah ke sini kalau menemui katanya di tengah jalan.

WABA / WhatsApp Business Account: Wadah yang menampung nomor-nomor WhatsApp bisnis Anda di Meta. Anggap seperti nama perusahaan pada rekening bank, sedangkan nomor telepon adalah nomor rekeningnya. “WABA ID” berarti nomor identitas wadah itu — deretan angka panjang yang tinggal Anda salin.
Phone number ID: BUKAN nomor telepon Anda, meski namanya mirip. Ini kode internal Meta untuk nomor tersebut. Nomor telepon dibaca manusia; kode ini dibaca program. Keduanya tampil berdampingan di layar Meta, dan tertukar di sini adalah kekeliruan paling sering.
Access token: Semacam kunci titipan. Anda memberikannya ke aplikasi ini supaya bisa mengirim pesan atas nama Anda, tanpa perlu memberikan kata sandi Facebook Anda. Kunci ini bisa Anda cabut kapan saja tanpa mengubah kata sandi apa pun.
System User: “Karyawan robot” yang Anda buat di pengaturan Meta. Kunci titipan tadi diterbitkan atas namanya, bukan atas nama akun pribadi Anda. Gunanya: saat Anda mengganti kata sandi Facebook atau keluar dari perusahaan, kanalnya tidak ikut mati.
Webhook: Alamat tujuan pesan masuk. Bayangkan memberi tahu kantor pos ke mana surat Anda harus diantar — tanpa itu surat tetap dikirim orang, hanya tidak pernah sampai. Ini sebabnya kanal bisa terlihat “aktif” tetapi pesan tidak pernah muncul.
Callback URL dan Verify token: Dua baris yang aplikasi ini berikan untuk Anda tempel di layar Meta. Yang pertama adalah alamatnya, yang kedua kata sandi singkat supaya Meta yakin alamat itu benar milik Anda. Keduanya tinggal ditekan tombol Salin.
Graph API dan versinya: Nama teknis cara program berbicara dengan Meta. Anda tidak perlu memahaminya — biarkan angka versinya apa adanya kecuali Meta sendiri yang menyuruh mengubah.

Cara tercepat: Hubungkan nomor WhatsApp (login Facebook)

Buka Channels, tambah channel, pilih WhatsApp Business. Kalau Anda melihat tombol “Hubungkan nomor WhatsApp”, pakai jalur ini dan abaikan seluruh bagian manual di bawah. Anda cukup masuk dengan Facebook lalu memilih nomor bisnis Anda — tanpa membuat aplikasi Meta, tanpa mencari ID, tanpa menempelkan alamat webhook. Dialog resmi Meta yang menuntun langkahnya, dan aplikasi ini memasang webhook untuk Anda begitu selesai.

Dialog Pilih platform menampilkan lima kanal: Web Chat, Telegram, Messenger, WhatsApp Business, dan Instagram, masing-masing dengan keterangan singkat — Keterangan di bawah tiap nama menyebut apa yang dituntut kanal itu. WhatsApp Business memang yang paling lama — itu bukan kesalahan Anda.

Di dalam jendela Meta Anda akan diminta memilih: memakai NOMOR BARU khusus bisnis, atau NOMOR LAMA yang sudah aktif di WhatsApp (metode coexistence). Pilih sesuai keadaan Anda, lalu ikuti salah satu urutan di bawah.

Pakai nomor baru — nomor yang belum pernah dipakai di WhatsApp mana pun:

Tekan “Hubungkan nomor WhatsApp”. Jendela resmi Meta terbuka; masuk dengan akun Facebook Anda.
Kalau diminta, buat atau pilih portofolio bisnis (business portfolio): isi nama bisnis, situs, dan negara. Cukup satu untuk seluruh bisnis Anda.
Pilih WhatsApp Business Account (WABA) yang ada, atau buat baru bila belum punya.
Isi profil bisnis: nama akun, nama tampilan yang dilihat pelanggan, dan kategori bisnis.
Pilih “nomor telepon baru” (start with a new phone number), lalu masukkan nomor yang belum terdaftar di aplikasi WhatsApp mana pun.
Masukkan kode OTP yang dikirim Meta lewat SMS atau telepon ke nomor itu.
Tekan lanjut sampai selesai, lalu tutup jendela — Anda kembali ke halaman Channels dengan kanal yang sudah terpasang.

Pakai nomor lama (coexistence) — nomor yang SUDAH Anda pakai di aplikasi WhatsApp Business di ponsel dan ingin tetap dipakai:

Tekan “Hubungkan nomor WhatsApp” dan masuk dengan Facebook, sama seperti di atas.
Saat memilih nomor, pilih opsi memakai nomor WhatsApp Business Anda yang sudah aktif, lalu masukkan nomornya.
Masukkan kode OTP yang dikirim Meta ke nomor tersebut.
Sebuah QR code muncul di layar. Buka aplikasi WhatsApp di ponsel yang memakai nomor itu.
Di WhatsApp ponsel, buka pemindai (biasanya lewat Setelan → Perangkat tertaut atau notifikasi dari Facebook Business), pilih pindai QR, lalu setujui untuk membagikan riwayat chat bila ditawarkan.
Tunggu notifikasi “tersambung” di WhatsApp ponsel, lalu tekan Selesai di jendela Meta.

Catatan: Coexistence membuat nomor lama Anda tetap bisa dipakai di ponsel SEKALIGUS melayani pelanggan dari aplikasi ini. Opsi ini hanya muncul bila nomor itu sudah terdaftar sebagai WhatsApp Business sebelum Anda mulai, dan bila dialog Meta menawarkannya — kalau tidak muncul, pakai jalur nomor baru atau jalur manual.

Penting: Setelah tersambung, sebuah PIN enam digit ditampilkan SATU KALI. Catat saat itu juga. PIN itu adalah verifikasi dua langkah nomor Anda di WhatsApp Manager, dan tidak bisa ditampilkan ulang.

Jendela Facebook harus bisa terbuka. Pemblokir iklan atau pemblokir jendela munculan sering menghalanginya, dan yang terlihat hanyalah tombol yang seperti tidak berfungsi. Kalau tombolnya tidak muncul sama sekali, jalur cepat belum diaktifkan di server Anda — lanjutkan dengan pengisian manual di bawah.

Sesudah tersambung lewat jalur ini, lewati seluruh bagian manual dan langsung ke “Pilih siapa yang menjawab” — webhook sudah terpasang otomatis.

Belum yakin nomor mana yang dipakai?

Kalau nomornya ditolak (Phone Number Not Eligible)

Saat memakai nomor lama, Meta kadang menolak dengan pesan bahwa nomornya tidak memenuhi syarat. Hampir selalu penyebabnya sama: nomor itu masih terikat ke tempat lain di Meta, dan satu nomor hanya boleh hidup di satu tempat. Lepaskan ikatannya lebih dulu, lalu ulangi.

Nomor masih terhubung ke partner/aplikasi lain: buka business.facebook.com → Settings → akun WhatsApp → bagian Partner, lepas akun dari partner itu, lalu sambungkan ulang lewat aplikasi ini.
Nomor masih terkait sebuah Halaman Facebook: buka Settings Halaman → WhatsApp, batalkan permintaan koneksi yang masih menggantung (Connection Request Pending), lepas nomornya, lalu sambungkan ulang.
Kalau tetap ditolak: gunakan nomor WhatsApp Business lain yang Anda miliki, atau lanjutkan dengan jalur manual di bawah.

Catatan: Perubahan di Meta kadang butuh beberapa menit untuk terbaca. Kalau baru saja melepas ikatan nomor, tunggu sebentar sebelum mencoba menyambungkan lagi.

Jalur manual — hanya kalau tombol cepat tidak tersedia

Bagian ini dan seterusnya sampai sebelum “Pilih siapa yang menjawab” hanya diperlukan bila tombol “Hubungkan nomor WhatsApp” tidak muncul. Di sini Anda mengurus sendiri apa yang biasanya dikerjakan dialog Meta: mengambil WABA ID, Phone number ID, dan token, lalu memasang webhook. Kalau Anda sudah tersambung lewat jalur cepat, lompati semuanya.

Sebelum mulai (jalur manual)

Kanal ini memakai WhatsApp Cloud API milik Meta. Artinya nomor yang dipakai harus nomor bisnis yang sudah terdaftar di WhatsApp Business Platform — bukan nomor WhatsApp biasa di ponsel Anda, dan bukan aplikasi WhatsApp Business di ponsel.

Akun Meta Business yang sudah terverifikasi.
Satu nomor telepon yang belum terpakai di aplikasi WhatsApp mana pun.
Aplikasi di Meta for Developers dengan produk WhatsApp ditambahkan.

Catatan: Verifikasi bisnis di Meta bisa memakan beberapa hari kerja dan berada di luar kendali aplikasi ini. Mulailah proses itu lebih dulu, sambil menyiapkan agent lewat Web Chat.

Belum punya WhatsApp Business API sama sekali? Mulai dari nol

Lewati bagian ini kalau Anda sudah punya WABA ID dan token. Kalau yang Anda punya baru aplikasi WhatsApp Business di ponsel, itu BUKAN yang dimaksud — aplikasi ponsel dan WhatsApp Business Platform adalah dua produk berbeda, dan yang kedua tidak bisa dipakai dari ponsel. Anda perlu mendaftarkannya lewat Meta lebih dulu, dan seluruh langkah di bawah dikerjakan di situs Meta, bukan di aplikasi ini.

Catatan: Nomor yang Anda daftarkan akan BERHENTI bisa dipakai di aplikasi WhatsApp biasa maupun WhatsApp Business di ponsel. Satu nomor hanya boleh hidup di satu tempat. Kalau nomor itu masih Anda pakai untuk melayani pelanggan sehari-hari, siapkan nomor lain — memindahkannya kembali menuntut penghapusan dari Platform dan menunggu.

Buat akun Meta Business di business.facebook.com. Cukup satu untuk seluruh bisnis Anda; kalau sudah punya karena mengelola Halaman Facebook, pakai yang itu.
Ajukan verifikasi bisnis di Business Settings → Security Center. Anda akan diminta dokumen legal usaha dan bukti alamat. Ini bagian yang paling lama, jadi kerjakan paling awal.
Buat aplikasi di developers.facebook.com/apps, pilih tipe “Business”, lalu kaitkan ke akun Meta Business tadi.
Di dalam aplikasi itu, tambahkan produk “WhatsApp”. Meta akan otomatis membuatkan satu WhatsApp Business Account (WABA) beserta nomor uji.
Daftarkan nomor bisnis Anda yang sungguhan di bagian “API Setup”, lalu verifikasi lewat SMS atau telepon.
Buat System User di Business Settings → Users → System Users, beri akses ke aset WhatsApp Anda, lalu terbitkan token permanen dengan izin whatsapp_business_messaging dan whatsapp_business_management.

Buka Meta Business Settings Buka daftar aplikasi Meta for Developers Anda

Penting: Nomor uji yang diberikan Meta hanya bisa mengirim ke lima nomor yang Anda daftarkan sendiri, dan tidak bisa menerima dari pelanggan. Nomor itu untuk mencoba, bukan untuk berjualan. Selama Anda masih memakainya, jangan simpulkan kanalnya rusak ketika pelanggan sungguhan tidak bisa menghubungi Anda.

Setelah keenam langkah itu selesai, Anda memiliki keempat nilai yang diminta formulir di aplikasi ini. Bagian berikut menjelaskan arti masing-masing dan di layar mana persisnya nilai itu terbaca.

Halaman Step 2 Production setup di dasbor Meta dengan empat tugas: Configure Webhooks, Register your WhatsApp phone number, Add payment, dan Send message — Meta memandu langkah production sebagai daftar tugas. Yang dibutuhkan panduan ini ada di tugas kedua — di situlah WABA ID dan Phone number ID terbaca.

Halaman System users di Meta Business Settings dengan satu system user terpilih, tombol Generate token, dan daftar aset yang bisa diaksesnya — Business Settings → Users → System Users. Tombol “Generate token” di kanan atas itulah yang menerbitkan token permanen. Perhatikan daftar aset di bawah: App dan akun WhatsApp Anda HARUS tercantum di situ, kalau tidak tokennya lahir tanpa izin apa pun.

Catatan: Tampilan Meta berubah beberapa kali setahun. Kalau nama menu pada gambar tidak Anda temukan, cari kata kuncinya di kolom pencarian dasbor Meta — susunan langkahnya jarang berubah meski letak tombolnya berpindah.

Cara mendapatkan kredensial di Meta

Gunakan jalur ini untuk pengisian manual. Pakai aplikasi Meta dan portofolio bisnis yang sama dari awal sampai akhir — mencampur WABA dari satu aplikasi dengan token dari aplikasi lain membuat verifikasi ditolak.

Buka developers.facebook.com/apps, pilih aplikasi Anda, lalu buka produk WhatsApp. Kalau belum punya aplikasi, buat aplikasi bertipe Business dan tambahkan WhatsApp sebagai produk.
Buka WhatsApp → API Setup. Hubungkan WABA yang sudah ada atau buat yang baru. Pada panel penyiapan, salin WhatsApp Business Account ID — nilai ini adalah WABA ID pada formulir.
Pada panel yang sama, pilih nomor bisnis yang akan dipakai. Salin Phone Number ID ke kolom Phone number ID, lalu salin nomor yang terlihat pelanggan lengkap dengan kode negara ke kolom Nomor tampilan. Phone Number ID bukan nomor telepon.
Untuk uji singkat, tekan Generate access token di API Setup. Token ini sementara dan hanya cocok untuk mencoba pengiriman pesan.
Untuk pemakaian sungguhan, buka Business Settings → Users → System Users. Tambahkan System User, tetapkan aplikasi dengan akses Kelola aplikasi dan WABA dengan akses Kelola akun WhatsApp Business, lalu tekan Generate token.
Saat menerbitkan token, pilih aplikasi yang sama dan berikan business_management, whatsapp_business_messaging, serta whatsapp_business_management. Salin token System User itu ke kolom Access token di formulir channel.

Penting: App ID dan App secret bukan kolom pada formulir WhatsApp, tetapi admin platform tetap membutuhkannya untuk konfigurasi server dan verifikasi webhook. Jangan menempelkan App secret ke kolom Access token. Simpan token hanya di tempat rahasia dan jangan memasukkannya ke chat, screenshot, atau riwayat shell.

Panduan resmi Meta: mulai menggunakan WhatsApp Cloud API Buka Meta Business Settings untuk System User

Arti tiap kolom, dan di mana mengambilnya

WABA ID: Nomor identitas WhatsApp Business Account Anda. Ada di Meta Business Suite, bagian pengaturan akun WhatsApp. Berupa deretan angka panjang.
Phone number ID: Bukan nomor telepon. Ini identitas internal Meta untuk nomor tersebut, terlihat di dasbor aplikasi Anda pada bagian produk WhatsApp, di sebelah nomor yang dipilih.
Nomor tampilan: Nomor telepon yang dilihat pelanggan, ditulis lengkap dengan kode negara. Kolom ini hanya untuk ditampilkan di dashboard, tidak dipakai untuk mengirim.
Access token: Kunci yang dipakai untuk mengirim pesan atas nama nomor Anda. Ambil token permanen milik System User, bukan token sementara.
Versi Graph API: Versi antarmuka Meta yang dipakai. Biarkan nilai bawaannya kecuali Meta memberitahu Anda untuk menaikkannya.

Penting: Token uji yang muncul di dasbor Meta hanya hidup 24 jam. Kalau Anda memakainya, halaman Channels akan menampilkan peringatan kedaluwarsa pada hari itu juga — jangan diabaikan, karena besok kanalnya berhenti. Buat System User di Meta Business Suite, beri akses ke aset WhatsApp Anda, lalu terbitkan token permanen dari sana.

Bagian Register your WhatsApp phone number di dasbor Meta, menampilkan WhatsApp Business account ID dan Phone Number ID dengan nomor telepon disensor — Dua nilai yang paling sering tertukar, terbaca di satu layar. “WhatsApp Business account ID” itulah WABA ID. “Phone Number ID” ada di bawah nomornya, dan ia BUKAN nomor telepon — nomor pada gambar ini disensor, ID-nya tidak karena memang bukan rahasia.

Mengisi formulir

Buka Channels, tambah channel, pilih WhatsApp Business.
Isi nama channel, lalu keempat kolom di atas.
Tempel access token pada kolom terakhir. Token disimpan terenkripsi dan tidak pernah ditampilkan kembali — simpan salinannya sendiri di tempat aman.
Simpan.

Saat Anda menekan simpan, kredensialnya langsung ditanyakan ke Meta. Kalau ada yang keliru, penolakannya menyebut kolom mana yang salah — misalnya “Phone number ID bukan salah satu nomor pada WABA ID yang diisi”. Anda tidak perlu menunggu berhari-hari untuk tahu ada yang salah.

Catatan: Setelah tersimpan, channel berstatus “pending”, dan itu memang seharusnya. Kredensial yang benar belum berarti pesan bisa masuk — webhook di langkah berikutnya yang menentukan.

Formulir Hubungkan WhatsApp Business dengan kolom WABA ID, Phone number ID, Versi Graph API, Nomor tampilan, dan Access token — Angka pada gambar ini hanya contoh berpola, bukan milik siapa pun. Kolom Access token sengaja dibiarkan kosong — milik Anda diisi di situ, dan tidak pernah ditampilkan lagi setelah tersimpan.

Daftar channel menampilkan kanal WhatsApp Business bernama Nomor Layanan dengan lencana Aktif dan Kualitas baik — Lencana Aktif berarti kredensialnya diterima Meta. Itu BELUM berarti pesan bisa masuk — langkah webhook di bawah yang menentukan.

Pilih siapa yang menjawab

Langkah ini paling sering terlewat, dan kegagalannya tidak terlihat seperti kegagalan: pesan pelanggan tetap masuk dan tersimpan rapi di Inbox, hanya tidak ada yang menjawabnya. Banyak orang menyimpulkan AI-nya rusak, padahal kanalnya memang belum pernah dikaitkan ke agent mana pun.

Buka Channels, pilih channel ini di daftar sebelah kiri.
Pada “Dijawab oleh”, pilih agent Anda. Pilihan bawaannya “Tim (tanpa AI)” — itu berarti hanya manusia yang membalas.

Kolom Dijawab oleh pada detail channel, dengan agent Asisten Penjualan sedang terpilih — Selama isinya masih “Tim (tanpa AI)”, tidak ada balasan otomatis di kanal ini.

Penting: Agent yang dipilih juga harus berstatus aktif. Agent yang tersimpan tetapi belum diaktifkan tidak menjawab apa pun, dan pemilihnya akan memberi tahu Anda dengan menuliskan “nonaktif” di sebelah namanya.

Mendaftarkan webhook

Webhook adalah alamat yang dipanggil Meta setiap kali ada pesan masuk. Tanpa langkah ini Anda bisa mengirim pesan tetapi tidak akan pernah menerima balasan pelanggan.

Pilih channel yang baru dibuat di daftar sebelah kiri.
Tekan tombol untuk menampilkan alamat webhook. Anda akan melihat Callback URL dan Verify token, masing-masing dengan tombol Salin.
Di dasbor aplikasi Meta, buka konfigurasi webhook produk WhatsApp, tempel kedua nilai itu, lalu verifikasi.
Kembali ke halaman Channels dan tekan tombol pendaftaran webhook untuk berlangganan kejadian pesan.

Catatan: Verify token dibuat khusus untuk satu channel. Kalau Anda punya beberapa nomor, tiap channel punya alamat dan token sendiri — jangan dipakai bergantian.

Halaman Configure a webhook di dasbor Meta dengan produk Whatsapp Business Account sedang dipilih, kolom Callback URL sebagian disensor, dan daftar field berstatus Subscribed — Perhatikan daftar Product di sebelah kiri: untuk WhatsApp yang dipilih adalah “Whatsapp Business Account”, BUKAN “Page”. Memilih Page adalah kekeliruan yang paling sering terjadi di layar ini, dan akibatnya pesan tidak pernah sampai meski semua kolom terisi benar.

Penting: Meta menolak menyimpan kalau Callback URL tidak bisa dijangkau atau Verify token tidak sama persis. Penolakan itu justru berguna: ia terjadi sekarang, bukan berhari-hari kemudian saat pelanggan pertama mengirim pesan. Kalau ditolak, salin ulang kedua nilai — tersalin sebagian adalah sebab tersering.

Panel channel WhatsApp menampilkan tombol Daftarkan ke Meta beserta Callback URL dan Verify token, masing-masing dengan tombol Salin — Dua pekerjaan dalam satu kotak, dan keduanya wajib: salin kedua nilai ini ke dasbor Meta, LALU tekan Daftarkan ke Meta. Nilai pada gambar ini contoh belaka; milik Anda tampil utuh di layar Anda sendiri.

Memastikan sudah jalan

Kirim pesan dari ponsel pribadi Anda ke nomor bisnis tersebut.
Buka Inbox. Percakapan baru harus muncul dalam beberapa detik.
Kalau tidak muncul, lihat panduan masalah umum.

Halaman Inbox menampilkan percakapan WhatsApp yang masuk, dengan nama pelanggan, isi pesan, dan penanda sesi 24 jam yang masih aktif di kepala percakapan — Beginilah tampilan kanal yang sudah benar-benar tersambung. Penanda “Sesi aktif” di kepala percakapan menghitung sisa jendela 24 jam.

Pesan tidak masuk — apa yang harus diperiksa

Aturan 24 jam dan template

Meta hanya mengizinkan pesan bebas selama 24 jam sejak pelanggan terakhir menulis. Lewat dari itu, Anda hanya boleh mengirim template yang sudah disetujui Meta. Di Inbox, kotak tulis akan beralih ke mode template ketika jendela itu tertutup, dan tombolnya berubah menjadi Kirim template.

Kotak tulis Inbox dalam mode template: pemberitahuan bahwa sesi 24 jam berakhir, pemilih template approved, dan tombol Kirim template — Kotak tulis berubah bentuk sendiri saat jendela 24 jam tertutup. Ini bukan kerusakan — pilih salah satu template yang sudah disetujui Meta untuk membalas.

Penting: Persetujuan template diurus di dasbor Meta, bukan di aplikasi ini. Ajukan template yang Anda butuhkan lebih awal — persetujuan tidak instan.