API Pengelolaan WhatsApp Business

Memigrasikan Nomor Telepon di Antara Akun WhatsApp Business melalui Pendaftaran Tersemat

Dokumen ini menjelaskan cara menggunakan Pendaftaran Tersemat untuk memigrasikan nomor telepon bisnis dari satu Akun WhatsApp Business (WABA) ke Akun WhatsApp Business lainnya.

Pelanggan dapat memigrasikan nomor telepon bisnis mereka di antara Akun WhatsApp Business (WABA) dan mempertahankan nama tampilan, peringkat kualitas, batasan berkirim pesan template, status Akun Bisnis Resmi, dan template berkualitas tinggi yang disetujui. Migrasi biasanya hanya dilakukan ketika pelanggan ingin memindahkan nomor telepon bisnisnya dari satu Mitra Solusi ke Mitra Solusi lainnya.

Untuk melakukan migrasi bagi pelanggan, Anda memiliki dua opsi: migrasi melalui Pendaftaran Tersemat atau migrasi terprogram.

Migrasi melalui Pendaftaran Tersemat lebih sederhana dan merupakan solusi pilihan karena dapat dimulai oleh pelanggan Anda, secara otomatis membuat dan memberikan kepemilikan semua aset yang diperlukan, memberi aplikasi Anda akses ke aset tersebut, dan memerlukan lebih sedikit panggilan API.

Migrasi terprogram harus dimulai oleh Anda dan melibatkan lebih banyak panggilan API karena Anda harus memverifikasi bahwa aset dependen dikonfigurasi dengan benar, harus membuat sendiri semua aset baru yang diperlukan, dan harus mengaitkannya dengan aset lain. Karena alasan ini, migrasi terprogram hanya disarankan jika Anda akan bekerja dengan pelanggan yang menggunakan model Atas Nama (yaitu Anda akan membuat dan memiliki WABA tujuan beserta asetnya dan membaginya dengan pelanggan).

Jika Anda ingin memigrasikan nomor telepon pelanggan secara terprogram, lihat dokumen Memigrasikan Nomor di antara Akun WhatsApp Business Terprogram kami.

Cara Kerjanya

Pelanggan dapat menggunakan penerapan Pendaftaran Tersemat (versi 2) Anda untuk memulai proses migrasi. Pendaftaran Tersemat akan meminta pelanggan memasukkan nomor telepon bisnis mereka dan Akun WhatsApp Business (WABA) destinasi baru.

Saat pelanggan menyelesaikan alurnya, Pendaftaran Tersemat membuat WABA baru mereka, mengaitkannya dengan portofolio bisnis Meta mereka, memberi aplikasi Anda akses ke WABA, lalu mengembalikan ID WABA yang baru dibuat dan ID nomor telepon bisnis.

Anda harus mengambil gambar ID ini dan menggunakannya dengan API untuk membagikan lini kredit Anda, berlangganan webhooks, dan mendaftarkan nomor tersebut untuk digunakan dengan Cloud API. Setelah Anda menyelesaikan langkah terakhir (pendaftaran), nomor telepon bisnis dikaitkan kembali dengan WABA tujuan dan nomor tersebut kemudian dapat digunakan untuk mengirim dan menerima pesan lagi.

Karena nomor telepon bisnis pelanggan tidak berubah, nama tampilan, peringkat kualitas, batas kirim pesan, dan status Akun Bisnis Resmi semuanya dipertahankan.

Selain itu, semua template yang memenuhi syarat secara otomatis diduplikasi di WABA tujuan dan diberi status yang sama dengan template sumbernya, dan semua media yang diunggah ke nomor telepon bisnis pelanggan dapat terus digunakan.

Akun WhatsApp Business

Pendaftaran Tersemat secara otomatis menghasilkan WABA baru pelanggan, mengaitkannya dengan Akun Meta Bisnis mereka, dan memberi aplikasi Anda akses ke WABA.

Template

Templates are automatically duplicated in the destination WABA and granted the same quality ratings and statuses as their source counterparts. The duplicated templates will be subjected to Template Categorization Guidelines checks to ensure that the templates are correctly categorized. This may result in some of the duplicated templates being REJECTED.

Only templates with both a status of APPROVED and quality_score of GREEN are eligible for duplication. If the destination WABA cannot accommodate all of the new templates, we will duplicate as many as we can until the destination WABA'S template limit has been reached. Unduplicated templates must be re-created and submitted for approval if they are to be used by the destination WABA.

Please note that the quality ratings of templates will NOT be migrated. All migrated templates will start with an UNKNOWN rating. This rating will remain for the first 24 hours, after which a new rating will be generated if sufficient data is available.

Tagihan

Messages sent before migration is complete are charged to the old Solution Partner. Undelivered messages sent before migration is complete will be charged to the old Solution Partner if they are delivered after migration is complete.

Messages sent after migration is complete are charged to the new Solution Partner.

Waktu Henti Template

Pendaftaran nomor telepon bisnis terjadi secara instan, oleh karena itu, Anda dapat terus mengirim dan menerima pesan tanpa gangguan.

Namun, duplikasi template memerlukan waktu, oleh karena itu, Anda tidak akan dapat menggunakan template yang terpengaruh hingga template tersebut dimigrasikan.

Untuk menghindari waktu henti ini, Anda dapat memulai migrasi template terlebih dahulu, sebelum pendaftaran nomor telepon.

Batas Laju

Duplikasi template yang dipicu secara otomatis sebagai bagian dari proses migrasi tidak diperhitungkan dengan batas laju Anda. Namun, panggilan API yang Anda lakukan diperhitungkan dengan batas tersebut.

Batasan

  • Nomor telepon bisnis pengujian yang diterbitkan oleh WhatsApp tidak dapat dimigrasikan.
  • Nomor telepon bisnis yang dimigrasikan hanya dapat didaftarkan untuk digunakan dengan Cloud API.
  • Riwayat pesan dan media yang diunggah tidak akan dimigrasikan jika WABA sumber ada di On-Premises API.
  • Nomor telepon bisnis harus memiliki nama tampilan yang disetujui (name_status adalah APPROVED).
  • Nomor telepon bisnis tidak dapat memiliki permintaan perubahan nama tampilan tertunda yang terkait.
  • Peringkat kualitas template TIDAK akan dimigrasikan. Semua template yang dimigrasikan akan dimulai dengan peringkat UNKNOWN. Peringkat ini akan bertahan selama 24 jam pertama, setelah itu peringkat baru akan dihasilkan jika data yang cukup tersedia.

Persyaratan

Pelanggan

Mintalah pelanggan yang memiliki nomor telepon bisnis untuk mengonfirmasi bahwa mereka memenuhi persyaratan berikut. Mereka dapat melakukan ini menggunakan Pengelola Meta Business, jika mereka memiliki WABA, dengan membuka Akun WhatsApp > (nama WABA mereka) > Pengaturan. Jika mereka tidak memiliki WABA, mereka harus meminta BSP mereka untuk mengonfirmasi.

  • Akun Meta Business mereka harus memiliki status terverifikasi.
  • WABA mereka yang ada harus berstatus disetujui.
  • WABA mereka yang ada harus memiliki metode pembayaran yang valid yang terlampir (di Pengaturan Pembayaran).
  • Nomor telepon bisnis mereka harus menonaktifkan verifikasi dua langkah. Pelanggan yang memiliki WABA dapat menggunakan Pengelola WhatsApp untuk menonaktifkan verifikasi dua langkah pada nomor mereka, jika tidak, mereka harus meminta Penyedia Solusi untuk menonaktifkannya untuk mereka.

Penyedia Solusi

Setidaknya satu aplikasi harus sudah berlangganan webhook di WABA tujuan (lihat Webhooks), dan Anda harus menggunakan Pendaftaran Tersemat versi 2 dengan pencatatan login diaktifkan.

Langkah-Langkah Migrasi

Langkah 1: Instruksikan Pelanggan untuk Menonaktifkan Verifikasi Dua Langkah

Jika Anda belum melakukannya, instruksikan pelanggan Anda untuk menggunakan Pengelola WhatsApp untuk menonaktifkan dua langkah verifikasi pada nomor telepon bisnis mereka (atau meminta Penyedia Solusi mereka saat ini untuk menonaktifkannya untuk mereka).

Anda tidak dapat menyelesaikan langkah selanjutnya hingga verifikasi dua langkah dinonaktifkan.

Langkah 2: Tampilkan Pendaftaran Tersemat

Arahkan pelanggan untuk mengakses implementasi Pendaftaran Tersemat (versi 2) Anda dan untuk memberikan nomor telepon bisnis mereka dan nama tampilannya ketika diminta dalam alur.

Langkah 3: Ambil ID Aset

Saat pelanggan menyelesaikan alur, ambil ID nomor telepon bisnis dan WABA baru yang dikembalikan dalam peristiwa pesan.

Langkah 4: Bagikan Lini Kredit Anda

Bagikan lini kredit Anda dengan WABA seperti yang biasa Anda lakukan setelah menggabungkan pelanggan melalui Pendaftaran Tersemat.

Langkah 5: Berlangganan webhooks

Langganan webhooks untuk aplikasi Anda di WABA baru pelanggan.

Langkah 6: Daftarkan nomor telepon untuk Cloud API

Daftarkan nomor telepon bisnis untuk digunakan dengan Cloud API (Anda tidak dapat mendaftarkan nomor telepon bisnis yang dimigrasikan untuk digunakan dengan On-Premises API).

Pemecahan Masalah

Jika proses migrasi template gagal, lihat dokumentasi berikut untuk petunjuk tentang cara memicu migrasi template secara manual: Migrasi Template.