Cloud API

Platform WhatsApp Business > Cloud API > Referensi

Pendaftaran

Untuk menggunakan nomor telepon bisnis Anda dengan Cloud API, Anda harus mendaftarkannya. Daftarkan nomor telepon bisnis Anda dalam skenario berikut:

  • Pembuatan Akun: Saat Anda menerapkan API ini, Anda perlu mendaftarkan nomor telepon bisnis yang ingin Anda gunakan untuk mengirim pesan. Kami memberlakukan pengaturan verifikasi dua langkah selama pembuatan akun untuk menambahkan layer keamanan ekstra ke akun Anda.
  • Ganti Nama: Dalam hal ini, telepon Anda sudah terdaftar dan Anda ingin mengubah nama tampilan Anda. Untuk melakukannya, Anda harusterlebih dahulu mengajukan ganti nama di Pengelola WhatsApp. Setelah nama disetujui, Anda perlu mendaftarkan telepon Anda lagi dengan nama baru.
  • Memigrasi nomor dari API di Tempat ke Cloud API. Lihat Pengecualian Migrasi.

Sebelum Anda dapat mendaftarkan nomor telepon bisnis Anda, Anda harus terlebih dahulu memverifikasi kepemilikannya.

Pengecualian Migrasi

Jika Anda memigrasikan nomor telepon dari API di Tempat ke Cloud API, ada langkah-langkah tambahan yang perlu Anda lakukan sebelum mendaftarkan nomor telepon dengan Cloud API. Lihat Migrasi antara API di Tempat dan Cloud API untuk proses lengkapnya.

Mendaftarkan Nomor Telepon Bisnis

Untuk mendaftarkan nomor telepon bisnis terverifikasi, buat panggilan POST ke PHONE_NUMBER_ID/register. Sertakan parameter yang tercantum di bawah ini.

EndpointAutentikasi

PHONE_NUMBER_ID/register

(Lihat Mendapatkan ID Nomor Telepon)

Solution Partners must authenticate themselves with an access token with the whatsapp_business_management permission.

Batasan

Permintaan ke endpoint pendaftaran dibatasi hingga 10 permintaan per nomor bisnis dalam jangka waktu bergerak 72 jam.

Saat Anda membuat permintaan pendaftaran, kami akan memeriksa berapa banyak permintaan pendaftaran yang telah Anda buat untuk mendaftarkan nomor tersebut dalam 72 jam terakhir. Jika Anda telah membuat 10 permintaan, API akan menampilkan kode kesalahan 133016, dan nomor tersebut tidak akan dapat didaftarkan selama 72 jam ke depan.

Parameter

NamaDeskripsi

messaging_product

Wajib.

Layanan berkirim pesan yang digunakan. Atur ini ke "whatsapp".

pin

Wajib.

Jika nomor telepon bisnis terverifikasi telah mengaktifkan verifikasi dua langkah, atur nilai ini ke 6 digit PIN verifikasi dua langkah dari nomor Anda. Jika lupa PIN Anda, Anda dapat memperbaruinya.


Jika nomor telepon bisnis terverifikasi belum mengaktifkan verifikasi dua langkah, atur nilai ini ke angka 6 digit. Ini akan menjadi PIN verifikasi dua langkah baru dari nomor telepon bisnis terverifikasi.

data_localization_region

Opsional..


Jika disertakan, aktifkan penyimpanan lokal di nomor telepon bisnis. Nilai harus berupa 2 huruf kode negara ISO 3166 (misalnya: IN) yang menunjukkan negara tempat Anda ingin menyimpan data-at-rest.


Nilai yang didukung:


APAC

  • Australia: AU
  • Indonesia: ID
  • India: IN
  • Jepang: JP
  • Singapura: SG
  • Korea Selatan: KR

Eropa

  • UE (Jerman): DE
  • Swiss: CH
  • Inggris: GB

LATAM

  • Brasil: BR

MEA

  • Bahrain: BH
  • Afrika Selatan: ZA
  • Uni Emirat Arab: AE

NORAM

  • Kanada: CA

Setelah diaktifkan, tidak dapat dinonaktifkan atau diubah secara langsung. Sebaliknya, Anda harus membatalkan pendaftaran nomor tersebut dan mendaftarkannya lagi tanpa parameter ini (untuk menonaktifkan), atau sertakan parameter dengan kode negara baru (untuk mengubah).


Untuk mengaktifkan penyimpanan lokal pada nomor yang sudah terdaftar, Anda harus membatalkan pendaftaran nomor tersebut, lalu mendaftarkannya kembali dan sertakan parameter ini.

Contoh Permintaan tanpa Penyimpanan Lokal

curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "212834"
}

Contoh Permintaan dengan Penyimpanan Lokal

curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "pin": "212834",
  "data_localization_region": "CH"
}

All API calls require authentication with access tokens.

Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.

Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.

Membatalkan Pendaftaran Nomor Telepon Bisnis

Membatalkan pendaftaran nomor telepon bisnis membuatnya tidak lagi dapat digunakan dengan Cloud API dan menonaktifkan penyimpanan lokal pada nomor tersebut, jika sudah diaktifkan.

Pembatalan pendaftaran tidak menghapus nomor atau riwayat pesannya. Untuk menghapus nomor dan riwayatnya, lihat Menghapus Nomor Telepon dari WABA.

Untuk membatalkan pendaftaran nomor telepon bisnis terverifikasi, buat panggilan POST ke PHONE_NUMBER_ID/deregister:

EndpointAutentikasi

PHONE_NUMBER_ID/deregister

(Lihat Mendapatkan ID Nomor Telepon)

Solution Partners must authenticate themselves with an access token with the whatsapp_business_management permission.

Batasan

Permintaan ke endpoint pembatalan pendaftaran dibatasi hingga 10 permintaan per nomor bisnis dalam jangka waktu bergerak 72 jam.

Saat Anda membuat permintaan pembatalan pendaftaran, kami akan memeriksa berapa banyak permintaan pembatalan pendaftaran yang Anda buat untuk membatalkan pendaftaran nomor tersebut dalam 72 jam terakhir. Jika Anda telah membuat 10 permintaan, API akan menampilkan kode kesalahan 133016, dan nomor tersebut tidak akan dapat dibatalkan pendaftarannya selama 72 jam ke depan.

Contoh

Contoh Permintaan:

curl -X POST \  
 'https://graph.facebook.com/v21.0/FROM_PHONE_NUMBER_ID/deregister' \  
 -H 'Authorization: Bearer ACCESS_TOKEN'

Tanggapan yang berhasil akan terlihat seperti ini:

{
  "success": true
}

Lihat Juga