Cara Setup WhatsApp Business API: Panduan Langkah demi Langkah
Cara setup WhatsApp Business API langkah demi langkah: business portfolio, verifikasi, nomor telepon, display name, Embedded Signup, template, dan go-live.
Oleh OmniChannels.ai Editorial Team · Ditinjau oleh BroadNet Messaging Solutions Team
Jawaban singkat
Untuk menyiapkan WhatsApp Business API, buat atau gunakan business portfolio Meta, selesaikan verifikasi bisnis, pilih nomor telepon yang dapat menerima SMS atau panggilan suara dan tidak aktif di WhatsApp, tentukan display name yang sesuai dengan brand Anda, hubungkan melalui alur Embedded Signup dari provider Anda, tambahkan metode pembayaran, daftarkan nomor dengan PIN verifikasi dua langkah, lalu ajukan template pesan pertama untuk disetujui sebelum go-live.
Di halaman ini
Poin penting
- Menurut Meta, nomor telepon bisnis untuk API harus dimiliki oleh Anda, memuat kode negara dan kode area, serta dapat menerima SMS atau panggilan suara; short code tidak didukung.
- Nomor yang sudah digunakan di WhatsApp harus dihapus dari aplikasi sebelum didaftarkan, kecuali Anda memakai opsi coexistence dari Meta untuk nomor WhatsApp Business App yang memenuhi syarat.
- Embedded Signup memungkinkan Anda membuat atau memilih business portfolio, WhatsApp Business Account, dan nomor telepon langsung di dalam platform provider.
- Verifikasi bisnis menambah jumlah nomor telepon yang dapat Anda daftarkan dan menjadi salah satu jalur menuju batas pengiriman pesan yang lebih tinggi.
- Persetujuan template, metode pembayaran yang valid, dan PIN verifikasi dua langkah adalah hambatan yang paling sering muncul sebelum go-live.
Panduan ini ditujukan bagi pemimpin marketing, CX, atau IT yang bertugas membuat bisnis Anda aktif di WhatsApp Business API. Panduan ini menjelaskan setiap langkah onboarding (aktivasi akun) secara berurutan, apa yang diperiksa Meta di setiap tahap, lalu ditutup dengan checklist go-live dan error yang paling sering ditemui tim.
Apa yang perlu disiapkan sebelum memulai?
Siapkan empat hal: akses admin ke business portfolio Meta perusahaan Anda, dokumen bisnis, nomor telepon khusus, dan nama brand yang dikenal pelanggan. Sebagian besar keterlambatan terjadi karena salah satunya belum siap.
| Item | Persyaratan | Mengapa penting |
|---|---|---|
| Business portfolio Meta | Akses admin; nama legal bisnis dan alamat sudah diisi | Memiliki WhatsApp Business Account (WABA) |
| Dokumen bisnis | Izin usaha atau registrasi komersial, bukti alamat | Diperlukan untuk verifikasi bisnis |
| Website | Pada domain yang Anda kendalikan, menampilkan nama bisnis Anda | Mendukung verifikasi dan peninjauan display name |
| Nomor telepon | Dimiliki oleh Anda, dengan kode negara dan kode area, dapat menerima SMS atau panggilan suara | Wajib untuk pendaftaran; short code tidak didukung |
| Display name | Sesuai dengan brand dan website Anda | Tampil di profil WhatsApp Anda; ditinjau oleh Meta |
| Metode pembayaran | Kartu atau kredit dari provider | Diperlukan untuk mengirim template berbayar |
| Proses persetujuan (opt-in) | Persetujuan yang jelas dari pelanggan untuk menerima pesan WhatsApp | Diwajibkan oleh kebijakan WhatsApp |
Bagaimana cara setup WhatsApp Business API langkah demi langkah?
Ikuti langkah-langkah ini secara berurutan. Jika Anda melakukan onboarding melalui provider, langkah 3 sampai 6 biasanya berlangsung di dalam alur Embedded Signup milik provider tersebut.
Langkah 1: Siapkan business portfolio Meta Anda
Masuk ke Meta Business Suite dengan akun Facebook pribadi yang menjadi admin business portfolio perusahaan, atau buat portfolio baru. Gunakan nama legal bisnis dan alamat yang persis sama dengan yang tertera di dokumen Anda. Tambahkan minimal dua admin agar akses tidak hilang jika salah satu orang keluar.
Langkah 2: Mulai verifikasi bisnis
Di Pusat Keamanan (Security Centre) business portfolio Anda, mulai verifikasi bisnis. Meta meminta dokumen yang mengonfirmasi nama legal, alamat, serta nomor telepon atau email, dan dapat melakukan verifikasi melalui kode atau pemeriksaan domain. Persyaratan berbeda di tiap negara dan dapat berubah, jadi ikuti petunjuk di layar.
Anda dapat memulai onboarding sebelum verifikasi selesai, tetapi Meta menerapkan batas yang lebih rendah hingga saat itu: menurut dokumentasi Meta, portfolio baru dimulai dengan dua nomor telepon terdaftar dan batas pengiriman 250 pengguna unik di luar jendela layanan pelanggan.
Langkah 3: Pilih nomor telepon
Pilih nomor yang akan tetap dipakai bisnis selama bertahun-tahun, seperti nomor telepon tetap (landline) atau nomor seluler khusus. Meta mensyaratkan bahwa nomor tersebut:
- dimiliki oleh Anda dan memuat kode negara serta kode area;
- dapat menerima SMS atau panggilan suara untuk verifikasi;
- bukan short code;
- tidak sedang terdaftar di WhatsApp, kecuali Anda memakai opsi coexistence dari Meta untuk nomor WhatsApp Business App yang memenuhi syarat.
Jika nomor tersebut aktif di aplikasi WhatsApp atau WhatsApp Business dan Anda tidak ingin memakai coexistence, cadangkan data yang Anda perlukan, lalu hapus akun dari aplikasi terlebih dahulu.
Langkah 4: Tentukan display name Anda
Display name tampil di profil WhatsApp Anda. Gunakan nama brand yang dikenal pelanggan, konsisten dengan website dan dokumen bisnis Anda. Hindari nama generik ("Best Deals"), huruf kapital yang tidak lazim, atau penambahan slogan. Meta meninjau nama tersebut; statusnya tampil sebagai pending, approved, atau declined di WhatsApp Manager.
Langkah 5: Hubungkan melalui Embedded Signup
Embedded Signup adalah alur dari Meta yang ditempatkan provider di dalam platform mereka. Anda masuk dengan Facebook, memilih atau membuat business portfolio, membuat atau memilih WhatsApp Business Account, memasukkan nomor telepon dan display name, lalu memverifikasi nomor dengan kode melalui SMS atau panggilan suara. Di akhir proses, provider menerima izin untuk mengelola WABA atas nama Anda, sementara kepemilikan tetap berada di portfolio Anda.
Langkah 6: Daftarkan nomor dan atur PIN dua langkah
Nomor harus didaftarkan untuk Cloud API dengan PIN verifikasi dua langkah enam digit. Provider Anda biasanya melakukannya sebagai bagian dari onboarding. Simpan PIN dengan aman: PIN ini diperlukan untuk mengganti PIN atau menghapus nomor di kemudian hari.
Langkah 7: Tambahkan metode pembayaran
Meta menagih biaya per pesan template yang terkirim, berdasarkan kategori dan negara penerima. Tambahkan kartu ke WABA di WhatsApp Manager, atau pastikan kredit dari provider Anda mencakup akun Anda. Tanpa penagihan yang valid, pengiriman template akan gagal.
Langkah 8: Buat template pertama Anda
Di luar jendela layanan pelanggan 24 jam, Anda hanya dapat mengirim template yang telah disetujui. Mulailah dengan tiga sampai lima template yang Anda butuhkan di hari pertama:
- Template utilitas (utility) untuk konfirmasi pesanan atau pemesanan.
- Template utilitas untuk pembaruan status, seperti pengiriman atau pengingat.
- Template autentikasi (authentication) jika Anda mengirim OTP (kode verifikasi).
- Satu template marketing (pemasaran) untuk kampanye pertama Anda kepada kontak yang sudah memberi persetujuan (opt-in).
Gunakan variabel untuk nama dan nomor pesanan, jangan masukkan bahasa promosi ke template utilitas, dan buat versi bahasa Arab dan Inggris sebagai bahasa terpisah dari template yang sama jika Anda melayani pelanggan di negara Teluk (GCC).
Contoh kasus: lembaga pelatihan di Doha mulai beroperasi
"Al Fanar Academy" (contoh fiktif) ingin memakai WhatsApp untuk pertanyaan kursus dan pengingat kelas.
- Minggu 1: Manajer operasional memastikan akses admin ke business portfolio, mengunggah registrasi komersial, dan memulai verifikasi. Akademi memilih nomor telepon tetap utamanya, yang dapat menerima panggilan suara.
- Onboarding: Melalui Embedded Signup milik provider, akademi membuat WABA, memasukkan display name "Al Fanar Academy", dan memverifikasi nomor melalui panggilan suara.
- Template: Akademi mengajukan pengingat kelas (utilitas), konfirmasi pendaftaran (utilitas), dan pengumuman semester baru (marketing) dalam bahasa Arab dan Inggris. Template marketing ditolak karena ajakan bertindak (call to action) yang kurang jelas, lalu disetujui setelah ditulis ulang.
- Go-live: Akademi mengirim pengingat kepada siswa yang memberi persetujuan (opt-in) lewat formulir pendaftaran, dan mengarahkan balasan ke kotak masuk bersama (shared inbox) tim penerimaan siswa.
Langkah yang paling lama adalah verifikasi, bukan setup teknisnya.
Checklist go-live
Centang setiap item sebelum kampanye pertama Anda.
- Verifikasi bisnis sudah diajukan atau disetujui.
- Display name sudah disetujui.
- Nomor telepon sudah terdaftar dan PIN dua langkah tersimpan dengan aman.
- Metode pembayaran valid dan saldo tersedia.
- Template yang dibutuhkan sudah disetujui di setiap bahasa yang Anda perlukan.
- Persetujuan (opt-in) tercatat untuk setiap kontak yang akan Anda kirimi pesan.
- Kotak masuk bersama sudah disiapkan, dengan agen yang ditugaskan untuk membalas pesan masuk.
- Pesan uji sudah dikirim ke nomor internal dan diperiksa di Android dan iOS.
- Laporan pengiriman (DLR) untuk pengiriman uji sudah ditinjau.
- Volume pengiriman sudah direncanakan dalam batas pengiriman pesan Anda saat ini.
Apa saja error setup yang paling umum?
Sebagian besar error mengikuti beberapa pola. Dokumentasi kode error Meta mencantumkannya; berikut yang paling sering ditemui tim onboarding.
| Kode error | Arti (menurut Meta) | Solusi umum |
|---|---|---|
| 133010 | Nomor telepon belum terdaftar | Selesaikan pendaftaran dengan PIN dua langkah |
| 131047 | Jendela layanan pelanggan sudah tertutup | Kirim template yang telah disetujui, bukan teks bebas |
| 132001 | Template tidak ada dalam bahasa tersebut atau belum disetujui | Periksa nama template, kode bahasa, dan status persetujuan |
| 132012 | Nilai variabel tidak sesuai dengan format template | Samakan jumlah dan format variabel |
| 131042 | Masalah metode pembayaran | Perbaiki kartu atau kredit di WABA |
| 131026 | Pesan tidak dapat dikirim | Penerima mungkin tidak memakai WhatsApp atau aplikasinya sudah usang; gunakan kanal lain |
| 131049 | Pesan ditahan demi kesehatan ekosistem | Sering terkait frekuensi marketing; tunggu sebelum mengirim ulang dan tinjau targeting |
| 368 | Akun dibatasi karena pelanggaran kebijakan | Tinjau pemberitahuan kebijakan di WhatsApp Manager dan ajukan banding jika sesuai |
Masalah lain yang sering muncul bukan berupa kode error: nomor yang masih aktif di aplikasi WhatsApp, display name yang tidak sesuai dengan website, dan admin yang tidak memiliki kendali penuh atas portfolio.
Bagaimana OmniChannels.ai membantu
OmniChannels.ai, didukung oleh BroadNet Technologies, melakukan onboarding nomor WhatsApp Business API melalui Meta Embedded Signup, sehingga business portfolio Anda tetap memegang kepemilikan WABA. Anda dapat membuat template marketing, utilitas, dan autentikasi, termasuk OTP one-tap, zero-tap, dan copy-code, dengan variabel, media, dan tombol, lalu memeriksanya di pratinjau ponsel dan memantau status persetujuan. Setelah aktif, kampanye mendukung unggah Excel/CSV, pratinjau, penjadwalan, dan penyaringan duplikat, dengan laporan pengiriman (DLR) untuk setiap pengiriman. Bahasa Arab dan Inggris didukung. Lihat halaman WhatsApp Business API dan kampanye, atau jadwalkan demo.
Pertanyaan yang sering diajukan
Bisakah saya memakai nomor WhatsApp yang sudah ada untuk API?
Bisa, dengan syarat tertentu. Meta menyatakan bahwa nomor yang sudah digunakan di WhatsApp harus dihapus dari aplikasi sebelum didaftarkan di API. Untuk nomor WhatsApp Business App yang memenuhi syarat, Meta juga menyediakan opsi coexistence saat Embedded Signup agar aplikasi tetap berfungsi di nomor yang sama. Periksa kelayakan untuk pasar Anda sebelum memutuskan.
Apakah verifikasi bisnis Meta wajib?
Anda bisa mulai mengirim pesan sebelum verifikasi, tetapi dengan batas yang lebih rendah. Menurut Meta, portfolio baru dimulai dengan dua nomor terdaftar dan batas pengiriman 250 pengguna unik di luar jendela layanan; memverifikasi bisnis adalah salah satu cara untuk menaikkan batas jumlah nomor dan memenuhi syarat untuk batas pengiriman yang lebih tinggi. Sebagian besar bisnis yang sedang tumbuh sebaiknya melakukan verifikasi lebih awal.
Dokumen apa yang diperlukan untuk verifikasi bisnis?
Meta umumnya meminta dokumen yang menunjukkan nama legal bisnis, alamat, dan nomor telepon, seperti izin usaha, registrasi komersial, atau tagihan utilitas (utility bill), ditambah website pada domain yang Anda kendalikan. Persyaratan berbeda di tiap negara dan dapat berubah, jadi ikuti petunjuk di Pusat Keamanan (Security Centre) Meta Business Suite untuk portfolio Anda.
Mengapa display name saya ditolak?
Display name biasanya ditolak jika tidak jelas terkait dengan bisnis, hanya memakai istilah generik, salah menggunakan huruf kapital atau tanda baca, atau tidak dapat dihubungkan dengan website atau bisnis yang telah diverifikasi. Gunakan nama brand yang dikenal pelanggan, pastikan website Anda menampilkannya, lalu ajukan ulang dengan branding yang konsisten.
Apakah saya membutuhkan developer untuk menyiapkan WhatsApp Business API?
Tidak, jika provider menawarkan Embedded Signup dan platform siap pakai dengan inbox, template, dan kampanye. Developer dibutuhkan jika Anda ingin memanggil API secara langsung, menerima webhook di sistem Anda sendiri, atau mengintegrasikan WhatsApp dengan CRM atau platform pesanan Anda.
Sumber
Lanjut membaca
Panduan lainnyaWhatsApp
Batas Pesan WhatsApp dan Quality Rating: Cara Scale dengan Aman
Panduan batas pesan WhatsApp dan quality rating: cara kerja tier di level portofolio, penyebab kualitas turun, dan langkah menaikkan volume kirim dengan aman.
8 menit baca
WhatsApp
Kategori Template WhatsApp: Approval dan Rekategorisasi
Kategori template WhatsApp: aturan marketing, utilitas, dan autentikasi, penyebab template ditolak atau direkategorisasi, serta cara agar disetujui.
8 menit baca
Pemasaran
Email vs WhatsApp Marketing: Pilih Kanal Mana di Tiap Tahap?
Perbandingan email vs WhatsApp marketing per tahap: biaya, persetujuan, jenis konten, aturan deliverability, dan cara menggabungkan kedua kanal.
8 menit baca
