API di Tempat Platform WhatsApp Business

Akun

/v1/account

Kami menghentikan API di Tempat. Endpoint ini tidak bisa lagi digunakan untuk mendaftarkan nomor telepon bisnis dan sekarang mengembalikan kesalahan berikut:

{
  "code": 1005,
  "title": "Access denied",
  "details": "Unknown error: biz_link_on_prem_reg_blocked"
}

Node account berfungsi untuk mendaftarkan klien API WhatsApp Business Anda.

Harap diketahui bahwa Coreapp akan dimulai ulang jika nomor baru didaftarkan di klaster yang sudah digunakan untuk pendaftaran nomor lain.

Edge

Edge berikut terhubung ke node ini:

EdgeDeskripsi

/verify

Setelah Anda menerima kode pendaftaran melalui metode yang Anda tentukan, gunakan edge ini untuk menyelesaikan pendaftaran akun Anda.

Sebelum Memulai

Anda akan memerlukan:

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 Meta Business 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.

Batasan

  • Anda harus menggunakan akun admin untuk mendaftarkan aplikasi.
  • Jika Anda mendaftar ulang akun Anda, Coreapp harus dimulai ulang setelah pendaftaran selesai.

Meminta

Buat panggilan POST ke endpoint ini untuk meminta kode pendaftaran. Dalam panggilan Anda, tambahkan nomor telepon Anda dan string sertifikat berenkode base64. Anda dapat menerima kode Anda melalui SMS atau panggilan suara.

Contoh

POST /v1/account

{
    "cc": "COUNTRY_CODE",
    "phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
    "method": "sms" or "voice",
    "cert": "VERIFIED_NAME_CERT_IN_BASE64",
    "pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}

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, periksa SMS atau nomor suara Anda untuk kode pendaftaran. Tanggapan ini akan menyertakan muatan yang diberikan, berisi nama vname yang didekode dari parameter cert untuk Anda gunakan dalam mengonfirmasi nama tampilan yang ditetapkan sudah benar. Jika benar, lanjutkan ke Menyelesaikan Pendaftaran Akun Anda untuk menyelesaikan pendaftaran.
{
  "account": [{
      "vname": "decoded-vname-from-cert"
  }]
}

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

Parameter

NamaDeskripsi

cc

Wajib.

Kode negara numerik untuk nomor telepon yang Anda daftarkan

phone_number

Wajib.

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

method

Wajib.

Cara menerima kode pendaftaran Anda
Opsi:voice, sms

cert

Wajib.

Sertifikat berenkode base64.

pin

Opsional.

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

Mengubah PIN Verifikasi Dua Langkah

Untuk mengubah PIN verifikasi dua langkah pada nomor telepon bisnis Anda:

  1. Muat portofolio bisnis Anda di Pengelola WhatsApp.
  2. Jika panel Nomor telepon tidak otomatis dimuat, buka Fitur akun (ikon kotak peralatan) > Nomor telepon.
  3. Klik ikon pengaturan (roda gigi) nomor telepon.
  4. Klik Verifikasi dua langkah.
  5. Klik Ubah PIN dan selesaikan alur.

Anda harus memasukkan PIN Anda saat ini untuk mengubahnya. Perhatikan bahwa Anda juga dapat mengatur PIN baru dengan menggunakan API kami:

Menonaktifkan Verifikasi Dua Langkah

Untuk menonaktifkan verifikasi dua langkah, ikuti langkah-langkah untuk mengubah PIN, tetapi klik tombol Nonaktifkan verifikasi dua langkah sebagai langkah terakhir. Email yang berisi tautan akan dikirim ke alamat email yang terkait dengan portofolio bisnis Anda. Gunakan tautan tersebut untuk menonaktifkan verifikasi dua langkah. Setelah dinonaktifkan, Anda dapat mengaktifkannya kembali dengan mengatur PIN baru.

Pertanyaan Umum

Ya, kami dapat menyiapkan nomor telepon baru atau mengubah nama terverifikasi saat Anda siap untuk tayang.

Tautan Permanen

Nomor bebas pulsa dapat digunakan asalkan kode negara Anda disertakan. Alasannya, nomor bebas pulsa tanpa kode negara tidak dapat diidentifikasi secara unik — nomor yang sama dapat tersedia di dua negara yang berbeda.

Juga harap diketahui bahwa ada kesulitan lain terkait dengan nomor bebas pulsa. Biasanya, jika Anda memanggil nomor bebas pulsa dengan kode negara saat Anda berada di negara tersebut, panggilan Anda akan gagal. Artinya, ada kemungkinan pelanggan dari negara Anda akan mencoba menghubungi nomor yang tercantum pada kontak bisnis (termasuk kode negara) dan mereka tidak akan bisa menjangkau Anda. Jika ini adalah masalah, Anda akan perlu memberi tahu mereka secara jelas.

Baca selengkapnya tentang nomor bebas pulsa di sini.

Tautan Permanen

Jika Anda mencadangkan penyiapan saat ini dan memulihkannya di komputer baru, informasi pendaftaran akan berpindah bersama penerapan Anda lainnya. Lihat dokumentasi Pengaturan Pencadangan dan Pemulihan untuk informasi selengkapnya.

Tautan Permanen

Anda dapat mendaftarkan nomor telepon baru dan menghapus yang lama di Akun WhatsApp Anda di Pengelola Bisnis Facebook.

  1. Di Akun WhatsApp Anda, buka Pengaturan.
  2. Klik Pengelola WhatsApp.
  3. Pilih tab Nomor Telepon. Di sinilah Anda dapat mengelola semua nomor telepon untuk akun ini.
Tautan Permanen

Jika pendaftaran gagal dengan "SMS" karena terlalu banyak percobaan dan Anda melihat pesan "akses ditolak", silakan coba mendaftar dengan "suara"

Tautan Permanen

Sayangnya, Anda harus memilih nomor telepon lain yang dapat menerima SMS atau panggilan suara agar kami dapat mengirimkan kode pendaftaran. Kode pendaftaran manual didukung di masa lalu, tetapi sekarang tidak didukung lagi. Nomor telepon yang sebelumnya menggunakan kode pendaftaran manual akan terus didukung sesuai kebutuhan. Untuk nomor telepon baru, kami hanya akan mengirimkan kode pendaftaran melalui SMS atau panggilan suara.

Jika Anda ingin menggunakan nomor 1800 atau bebas pulsa, bacalah panduan ini.

Tautan Permanen

Pelajari Selengkapnya