Mengelola Nomor Telepon Bisnis

Panduan ini memberikan informasi gambaran umum terkait nomor telepon untuk Mitra Solusi dan pelanggan. Selain itu, panduan ini berisi informasi proses untuk Mitra Solusi jika mereka harus mengelola nomor telepon dan sertifikat pelanggan.

Informasi awal tentang Nomor Telepon

Ada beberapa detail yang perlu diketahui bisnis seputar nomor telepon dan Pendaftaran Tersemat.

Bisnis memerlukan nomor khusus untuk menggunakan WhatsApp melalui pendaftaran tersemat. Jika bisnis memiliki nomor yang terdaftar secara aktif di WhatsApp Messenger atau Aplikasi WhatsApp Business, mereka tidak dapat menggunakan nomor telepon yang sama.

Bisnis dapat memiliki beberapa nomor telepon yang dikaitkan dengan Akun Bisnis Meta mereka, sehingga mereka tinggal menambahkan nomor telepon lain dan menggunakannya untuk WhatsApp.

Untuk informasi lebih mendetail terkait nomor telepon dan Platform WhatsApp Business, lihat Nomor Telepon.

Untuk informasi tentang cara memigrasi nomor telepon WhatsApp terdaftar yang ada, lihat Memigrasi Nomor Telepon.

Petunjuk untuk pelanggan bisnis

Bagian ini ditujukan kepada pelanggan dari Pendaftaran Tersemat dan memberikan panduan tentang tindakan yang mungkin mereka lakukan terkait dengan nomor telepon.

Menambahkan Nomor Telepon ke Akun WhatsApp Business

Ada dua metode untuk menambahkan nomor tambahan ke Akun WhatsApp Business (WABA):

1. [Direkomendasikan] Lakukan kembali alur pendaftaran tersemat, pilih Pengelola Bisnis & WABA yang sudah ada, tambahkan nomor, dan verifikasi.
2. Di Pengelola Bisnis, buka tab Nomor Telepon dari Pengelola WhatsApp, lalu pilih Tambahkan Nomor Telepon. Saat menggunakan opsi ini, Mitra Solusi harus memverifikasi nomor telepon secara manual karena verifikasi telepon tidak tersedia di Pengelola Bisnis. Untuk alasan ini, disarankan agar bisnis mengikuti alur pendaftaran tersemat untuk menambahkan nomor tambahan.

Instruksi untuk Mitra Solusi

Bagian ini ditujukan kepada Mitra Solusi dan memberikan petunjuk untuk mengelola nomor telepon dan sertifikat pelanggan.

Mendapatkan nomor telepon

Gunakan endpointGET /<WABA_ID>/phone_numbers untuk mendapatkan daftar nomor telepon bisnis di WABA pelanggan bisnis.

Permintaan

curl 'https://graph.facebook.com/<API_VERSION>/<CUSTOMER_WABA_ID>/phone_numbers' \ -H 'Authorization: Bearer <CUSTOMER_BUSINESS_TOKEN>' 

Tanggapan

Setelah sukses:

{ "data": [ { "verified_name": "<VERIFIED_DISPLAY_NAME>", "code_verification_status": "<VERIFICATION_STATUS>", "display_phone_number": "<DISPLAY_PHONE_NUMBER>", "quality_rating": "<QUALITY_RATING>", "platform_type": "CLOUD_API", "throughput": { "level": "<THROUGHPUT_LEVEL>" }, "webhook_configuration": { "application": "<WEBHOOK_CALLBACK_URL>" }, "id": "<BUSINESS_PHONE_NUMBER_ID>" } ], "paging": { "cursors": { "before": "<BEFORE_CURSOR>", "after": "<AFTER_CURSOR>" } } } 

Mendaftarkan Nomor Telepon untuk Cloud API

Setelah verifikasi telepon berhasil dari alur pendaftaran tersemat, pendaftaran akan berhasil dengan panggilan API ke endpoint register. Untuk ini, sediakan code_method (sms | voice). Karena nomor telepon sudah terverifikasi, Anda tidak perlu khawatir dengan kode pendaftaran. Panggilan APIverify tidak diperlukan.

Atau, Anda dapat memverifikasi nomor telepon terlebih dahulu dan menawarkannya kepada pelanggan Anda dalam alur Pendaftaran Tersemat yang baru. Hal ini agar pelanggan tidak perlu menghubungi Anda untuk kata sandi sekali pakai selama proses onboarding. Lihat Nomor Telepon yang Diverifikasi Sebelumnya.

Mendaftarkan Nomor Telepon untuk Di Tempat

Setelah verifikasi telepon berhasil dari alur pendaftaran tersemat, pendaftaran akan berhasil dengan panggilan API ke endpoint account. Untuk ini, sediakan code_method (sms | voice). Karena nomor telepon sudah terverifikasi, Anda tidak perlu khawatir dengan kode pendaftaran. Panggilan API verify tidak diperlukan.

Atau, Anda dapat memverifikasi nomor telepon terlebih dahulu dan menawarkannya kepada pelanggan Anda dalam alur Pendaftaran Tersemat yang baru. Hal ini agar pelanggan tidak perlu menghubungi Anda untuk kata sandi sekali pakai selama proses onboarding. Lihat Nomor Telepon yang Diverifikasi Sebelumnya.

Mendapatkan Sertifikat dan Status Telepon

Dengan endpoint phone_numbers, Anda dapat melihat status nama tampilan nomor telepon dan mengambil sertifikat setelah ganti nama. Lihat Membaca Nomor Telepon untuk informasi selengkapnya.

Contoh Permintaan

Dalam contoh berikut, gunakan ID untuk WABA yang telah ditetapkan.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    new_name_status
  &access_token={system-user-access-token}"

Contoh Tanggapan

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "last_onboarded_time": "2023-08-22T19:05:53+0000",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

Parameter Tanggapan

Mendapatkan Status OTP Telepon

Untuk mengetahui apakah nomor telepon telah diverifikasi melalui OTP (kata sandi sekali pakai), periksa kolom code_verification_status dari nomor telepon itu. Pertama, buatlah panggilan GET ke endpoint /{whatsapp-business-account-id}/phone_numbers:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

Tanggapan termasuk code_verification_status dengan salah satu opsi berikut: VERIFIED atau NOT_VERIFIED. Contoh tanggapan akan terlihat seperti ini:

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

Atau, Anda bisa mendapatkan status dengan menghubungi ID nomor telepon:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"

Memfilter Nomor Telepon berdasarkan Mode Akun

Anda dapat menanyakan nomor telepon dan memfilternya berdasarkan account_mode mereka. Untuk permintaan tersebut, Anda dapat menggunakan parameter yang terdaftar di bawah ini.

Parameter Permintaan

Contoh Permintaan

Dalam contoh berikut, gunakan ID untuk WABA yang telah ditetapkan.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?filtering=[{
    "field":"account_mode",
    "operator":"EQUAL",
    "value":"SANDBOX"}]
  &access_token={system-user-access-token}"

Contoh Tanggapan

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "verified_name": "John’s Cake Shop",
      "quality_rating": "UNKNOWN",
    }
  ],
  "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

Pelajari Selengkapnya

• Nomor telepon: Ringkasan Platform WhatsApp Business
• Nomor telepon: Memigrasi nomor terdaftar yang sudah ada
• Referensi: Akun WhatsApp Business