Migrasi Nomor Telepon ke WhatsApp Cloud API

Manfaat Migrasi ke WhatsApp Cloud API

WhatsApp Cloud API adalah platform baru yang menawarkan koneksi langsung bagi bisnis ke infrastruktur WhatsApp'dan merupakan opsi layanan mandiri dibandingkan dengan melalui mitra WhatsApp (BSP). Beberapa manfaat menggunakan WhatsApp Cloud API adalah:

pilihan yang lebih hemat biaya.
koneksi ke platform yang lebih andal dan stabil.
kemampuan untuk membangun integrasi khusus yang sesuai dengan kebutuhan bisnis spesifik Anda.
solusi yang fleksibel dan berskala untuk bisnis dalam segala ukuran.

Pelajari lebih lanjut tentang WhatsApp Cloud API di sini.

Apa yang akan dimigrasikan?

Perhatikan bahwa elemen berikut dapat dimigrasikan dari WhatsApp BSP ke WhatsApp Cloud API.

Bisa dimigrasikan

Nomor telepon yang terkait dengan akun.
Semua templat pesan berkualitas tinggi yang telah disetujui sebelumnya.
Nama tampilan nomor telepon.
Peringkat kualitas nomor telepon.
Batasan pengiriman pesan.
Status resmi WABA.

Tidak dapat dimigrasikan

Templat pesan berkualitas rendah, ditolak, atau tertunda.

Persyaratan Pra-Migrasi: Apa yang Perlu Dipersiapkan untuk Pengaturan Migrasi Anda

Perhatikan frasa yang akan sering digunakan di seluruh dokumen ini:
-Sumber WABA: WhatsApp BSP tempat kami migrasi.
-Tujuan WABA: WhatsApp Cloud API yang menjadi tujuan migrasi kami.

Daftar Periksa Persyaratan Pra-Migrasi:

Aplikasi Pengembang Meta yang Ada: Jika Anda belum membuat aplikasi pengembang, klik di sini untuk membuat aplikasi Anda di Meta Business Manager (MBM) dan mulai menggunakan WhatsApp Cloud API. Aplikasi ini harus dibuat menggunakan akun bisnis (ID bisnis) yang sama dengan WABA sumber.
ID Bisnis: WABA Sumber dan Tujuan harus dikaitkan dengan MBM yang sama atau memiliki ID bisnis yang sama.
Verifikasi Bisnis: ID Bisnis harus diverifikasi. Jika bisnis Anda belum diverifikasi, ikuti langkah-langkah ini untuk memverifikasinya.
Status Peninjauan WABA: Status peninjauan WABA Sumber dan Tujuan harus disetujui.
Pembayaran Metode: Metode pembayaran harus dikonfigurasi untuk WABA Sumber dan Tujuan. Pastikan metode pembayaran telah disiapkan di sumber dan tujuan.
Verifikasi Dua Langkah: Verifikasi dua langkah harus dinonaktifkan pada nomor telepon yang sedang dimigrasikan.

Bila semua hal di atas telah diperiksa dan diselesaikan, proses migrasi dapat dilanjutkan.

Mengonfigurasi Nomor Telepon dan ID WABA

Meta telah merancang ID WABA agar tidak dapat dimigrasikan. Karena keterbatasan tertentu, solusi sementara telah diterapkan. Agar migrasi nomor telepon dapat terjadi, ID WABA sumber dan tujuan harus berada di bawah akun manajer bisnis Meta yang sama. Artinya, migrasi nomor telepon hanya akan mengakibatkan pemindahan nomor tersebut antar WABA dan tidak akan memungkinkan perubahan apa pun. Untuk berhasil memigrasikan nomor telepon, langkah-langkah berikut harus dilakukan:

Tambahkan nomor baru ke WABA tujuan: Ini akan menghasilkan ID WABA baru untuk nomor yang ingin Anda migrasikan. Anda dapat melewati langkah ini jika Anda memiliki WABA dengan nomor yang tidak lagi digunakan.

Pelajari selengkapnya tentang menghubungkan nomor telepon ke WhatsApp Cloud API di sini.

Hapus nomor baru dari WABA tujuan: Ini akan mengosongkan tempat agar nomor dapat ditambahkan ke WABA tujuan. Atau, jika Anda memiliki nomor yang tidak terpakai, Anda dapat menghapus nomor tersebut.

Setelah nomor dihapus, lanjutkan untuk memindahkan nomor pelanggan'saat ini ke WhatsApp bisnis yang baru.

Dokumentasi API untuk Proses Migrasi

Penting untuk dicatat bahwa saat ini, langkah-langkah migrasi yang diuraikan dalam dokumentasi API hanya dapat dijalankan oleh pengembang atau seseorang dengan latar belakang teknis serupa. Namun, kami memahami bahwa ini dapat menjadi keterbatasan bagi sebagian orang dan kami sedang berupaya mengembangkan solusi yang lebih mudah digunakan dan diakses di masa mendatang. Butuh bantuan? Hubungi kamidi sini!

Langkah 1: Mulai Migrasi Nomor Telepon

URL panggilan balik:

POSTING <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>

Nama	Di dalam	Yg dibutuhkan	Jenis	Keterangan
versi	jalur	BENAR	rangkaian	Versi API.
wabaId	jalur	BENAR	rangkaian	ID WABA WhatsApp Cloud API.

Buka Business Manager > Pengaturan Bisnis > Akun > Akun WhatsApp Business untuk menemukan ID Akun WhatsApp Business. Pilih akun yang ingin Anda gunakan. Panel dengan informasi akun, termasuk ID akan muncul.

Parameter

Tajuk

Otorisasi: Pembawa {Access Token}

Pengguna Sistem membuat Token Akses Anda di tab Akun WhatsApp Business pada Manajer Bisnis. Baca panduan ini untuk mempelajari cara mengakses pengguna sistem dan membuat atau menyalinnya.

Tubuh

Nama	Jenis	Keterangan
cc	nomor	Kode negara numerik untuk nomor telepon yang didaftarkan. Catatan: Tanda tambah (+) tidak diperlukan untuk kode negara.
nomor telepon	nomor	Nomor telepon yang sedang dimigrasikan, tanpa kode negara atau simbol tambah (+).
migrasikan_nomor_telepon	Bahasa Inggris Boolean	Atur ke benar untuk memigrasikan nomor telepon.

Status

Nama	Keterangan
200 Oke	Kesuksesan.

Tanggapan

{ "id": "phoneNumberId" }

Langkah 2: Permintaan Kode (PIN) untuk Memverifikasi Kepemilikan Ponsel

URL panggilan balik

POSTING <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>

Nama	Di dalam	Yg dibutuhkan	Jenis	Keterangan
versi	jalur	BENAR	rangkaian	Versi API.
nomorteleponId	jalur	BENAR	rangkaian	Ini adalah respons yang dikembalikan pada Langkah 1. Salin dan Tempel nomor tersebut ke URL panggilan balik pada langkah ini.

Parameter

Tajuk

Otorisasi: Pembawa {Access Token}

Tubuh

Nama	Jenis	Keterangan
kode_metode	enum	Metode menerima kode registrasi. Nilai yang didukung: SMS dan Suara.
bahasa	enum	Bahasa yang Anda inginkan untuk menerima kode registrasi. Lihat kode bahasa.

Status

Nama	Keterangan
200 Oke	Kesuksesan.

Tanggapan

{ "berhasil": benar }

Kode telah dikirim ke nomor telepon yang dimigrasikan melalui metode yang dipilih (SMS atau Suara).

Langkah 3: Verifikasi Kode

URL panggilan balik

POSTINGAN: <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>

Kode (pin 6 digit) yang diterima di nomor telepon dari langkah 2 akan digunakan untuk memverifikasi kepemilikan.

Parameter

Tajuk

Otorisasi: Pembawa {Access Token}

Tubuh

Nama	Jenis	Keterangan
kode	nomor	Kode registrasi 6 digit diterima setelah menyelesaikan Langkah 2.

Status

Nama	Keterangan
200 Oke	Kesuksesan.

Tanggapan

{ "berhasil": benar }

Mengonfirmasi bahwa kepemilikan telepon telah diverifikasi.

Langkah 4: Daftarkan Nomor Telepon

URL panggilan balik

POSTING <https://graph.facebook.com/{version}/{phoneNumberId}/register>

Parameter

Tajuk

Otorisasi: Pembawa {Access Token}

Tubuh

Nama	Jenis	Keterangan
pesan_produk	enum	Layanan pesan yang digunakan. Dalam kasus ini, gunakan "whatsapp".
pin	nomor	Kode registrasi 6 digit diterima setelah Langkah 2.

Status

Nama	Keterangan
200 Oke	Kesuksesan.

Tanggapan

{ "berhasil": benar }

Nomor telepon berhasil didaftarkan ke WhatsApp Cloud API WABA. Anda sekarang dapat mengirim pesan ke WABA tujuan Anda.

ID WABA tidak dimigrasikan. Nomor yang baru dimigrasikan akan dikaitkan dengan ID WABA dari nomor yang dihapus sebelumnya.

Langkah 5: Periksa Nomor Telepon yang Dimigrasikan di Aplikasi Pengembang Meta

Migrasi yang berhasil dapat diverifikasi melalui Aplikasi Pengembang Meta. Untuk melakukan ini, ikuti langkah-langkah berikut:

Navigasi ke WhatsApp > Memulai
Pada daftar tarik-turun nomor telepon, konfirmasikan bahwa nomor tersebut ada dan tercantum secara akurat.