Pendaftaran

/v1/account

Node account adalah untuk mendaftarkan klien API WhatsApp Business Anda.

Dokumen ini mencakup:

Anda harus menggunakan akun admin untuk mendaftarkan aplikasi.

Token Autentikasi

Untuk menggunakan API WhatsApp Business, Anda harus terlebih dulu mengautentikasi klien API WhatsApp Business dengan server dan menerima token yang memungkinkan Anda mengakses layanan.

Lihat dokumentasi Login dan Autentikasi untuk informasi selengkapnya tentang autentikasi.

Nomor Telepon dan Sertifikat

Untuk mendaftar, Anda harus memiliki nomor telepon yang valid serta sertifikat berenkode base64 yang terkait dengan nomor telepon tersebut.

Lihat panduan Nomor Telepon untuk informasi tentang jenis nomor telepon yang didukung.

Menambahkan Nomor Telepon

Lihat Menyambungkan Nomor Telepon ke Akun WhatsApp Business Anda untuk mendapatkan petunjuk tentang cara menambahkan nomor telepon ke akun WhatsApp Business Anda. Nama tampilan yang ditetapkan untuk sebuah nomor telepon harus disetujui oleh tim WhatsApp sebelum mengunduh sertifikat berenkode base64.

Salin Sertifikat berenkode Base64.

String sertifikat berenkode base64 dibuat untuk Anda dan digunakan untuk validasi selama pendaftaran Klien API WhatsApp Business.

  1. Buka Pengaturan Bisnis di Pengelola Bisnis Facebook Anda.
  2. Klik Akun WhatsApp dalam menu Akun, lalu pilih Akun WhatsApp Anda dari daftar Akun WhatsApp, jika belum disorot.
  3. Buka tab Pengaturan, dan klik tombol Pengelola WhatsApp.
  4. Dalam tab Nomor Telepon, Anda seharusnya dapat melihat nomor telepon Anda dalam daftar. Klik tombol Lihat pada nomor telepon yang sertifikatnya Anda inginkan.
    Mendapatkan Sertifikat
  5. Dialog pop-up akan menampilkan string sertifikat dalam kotak abu-abu. Klik Dapatkan Sertifikat.
    Unduh String Sertifikat
  6. Gunakan string sertifikat ini dalam parameter cert saat mendaftar dengan endpoint account.

Lihat dokumentasi Nama Tampilan untuk informasi selengkapnya.

Meminta Kode Pendaftaran

Kirimkan nomor telepon dan string sertifikat berenkode base64 Anda untuk meminta kode pendaftaran. Anda dapat menerima kode Anda melalui SMS atau panggilan suara.

Gunakan endpoint /v1/account untuk meminta kode pendaftaran Anda.

POST /v1/account

{
    "cc": "your-country-code",
    "phone_number": "your- phone-number-without-country-code",
    "method": "sms" | "voice",
    "cert": "your-verified-name-cert-in-base64",
    "pin": "your-existing-6-digit-pin" # required if two-factor verification is enabled
}

Parameter

NamaWajib diisiDeskripsi

cc

Ya

Kode negara numerik untuk nomor telepon yang Anda daftarkan

phone_number

Ya

Nomor telepon yang Anda daftarkan, tanpa kode negara atau tanda plus (+)

method

Ya

Cara menerima kode pendaftaran Anda
Opsi:voice, sms

cert

Ya

Sertifikat berenkode Base64

pin

Tidak

PIN 6 digit yang sudah ada — PIN ini diperlukan hanya jika verifikasi 2 faktor diaktifkan di akun ini.

Tanggapan

Tergantung pada tanggapan yang diterima, prosedur pendaftaran dapat dianggap selesai atau memerlukan satu langkah lagi untuk diselesaikan. Jika berhasil, Anda akan menerima salah satu kode status HTTP berikut: Ikuti petunjuk yang sesuai dengan tanggapan yang Anda terima:

  • 201 Created — Akun sudah ada. Anda sudah terdaftar, sehingga tidak perlu melakukan hal lain.
  • 202 Accepted — Akun tidak ada. Tergantung pada metode yang dipilih dalam permintaan, cek SMS atau nomor suara Anda untuk kode pendaftaran. Tanggapan ini akan menyertakan hasil payload yang berisi nama vname yang didekode dari parameter cert untuk Anda gunakan dalam mengonfirmasi nama tampilan yang akan ditetapkan sudah benar. Jika benar, lanjut ke bagian Menyelesaikan Pendaftaran Akun Anda untuk menyelesaikan pendaftaran.
{
  "account": [{
      "vname": "decoded-vname-from-cert"
  }]
}

Jika kesalahan dikembalikan, buka Pesan Kesalahan dan Status untuk informasi selengkapnya.

Menyelesaikan Pendaftaran Akun

Setelah Anda menerima kode pendaftaran melalui metode yang Anda tentukan (mis. SMS atau panggilan suara), selesaikan pendaftaran akun Anda dengan mengirimkan panggilan API ke endpoint /v1/account/verify:

POST /v1/account/verify

{
  "code": "your-registration-code-received-by-sms-or-voice-call"
}

Jika berhasil, tanggapan akan mengembalikan status HTTP 201 Created tanpa objek payload dalam badan tanggapan.

Jika kesalahan dikembalikan, buka Pesan Kesalahan dan Status untuk informasi selengkapnya.

Jika Anda mendaftar ulang akun Anda, Coreapp harus dimulai ulang setelah pendaftaran selesai.