Migrasi

Jika Anda memiliki pengaturan klien API WhatsApp Business yang sudah ada dan Anda ingin bermigrasi ke pengaturan baru menggunakan nomor telepon yang sama, dokumen ini menunjukkan kepada Anda cara mengidentifikasi perubahan yang akan dibuat dan apa yang perlu Anda lakukan tentang perubahan tersebut.

Sebelum Memulai

• Pencadangan adalah langkah paling penting dari migrasi.
• Anda tidak perlu mendaftarkan ulang nomor telepon Anda setelah migrasi. Anda dapat mulai berkirim pesan segera setelah migrasi selesai.
• Pengaturan baru harus memiliki jumlah shard yang sama dengan pengaturan lama. Anda tidak bisa melakukan skala naik atau skala turun selama migrasi. Jika pengaturan lama Anda dikonfigurasikan dengan jumlah X Master dan jumlah Y CoreApp, pengaturan yang baru harus memiliki jumlah Master dan CoreApp yang persis sama. Jika ada ketidakcocokan dalam jumlah Master dan CoreApp sebelum dan setelah migrasi, migrasi akan gagal.
• Cobalah memigrasikan akun pengujian sebelum memigrasi akun produksi.
• Persiapkan waktu henti dan jangan mengirim pesan selama migrasi. Terlepas dari opsi migrasi, akan ada waktu henti. Hanya setelah migrasi selesai, pengiriman pesan berlanjut.

Migrasi Pengaturan

Memigrasi pengaturan klien WhatsApp Business menjaga pengaturan aplikasi, informasi pendaftaran, dan kode enkripsinya. Pesan dan info token autentikasi tidak dimigrasikan.

Karena jumlah data yang perlu dipindahkan di antara mesin minimal, hanya ada sedikit waktu henti.

Langkah 1: Instal pengaturan baru

Siapkan klien API WhatsApp Business baru Anda menggunakan Dokumentasi penginstalan.

Langkah 2: Dapatkan token autentikasi baru untuk pengaturan baru

Token autentikasi saat ini tidak akan valid di lingkungan baru. Login ke pengaturan baru untuk mendapatkan token autentikasi baru.

Langkah 3: Pembersihan

• [Opsional] Nonaktifkan autentikasi dua langkah. Ini bermanfaat ketika lupa kode autentikasi dua langkah dan Anda perlu mendaftar ulang. Meskipun pendaftaran ulang tidak diperlukan untuk migrasi yang lancar, Anda mungkin terpaksa mendaftar ulang jika pencadangan dan pemulihan gagal karena alasan yang tidak diketahui. Ikuti petunjuk untuk menonaktifkan kode autentikasi dua langkah.
  Catatan: Jika Anda yakin bahwa kode autentikasi dua langkah Anda sudah benar, langkah ini opsional.
• [Opsional] Reset semua Webhooks. Jika Webhooks telah disiapkan untuk menerima notifikasi inbound dan server Webhooks juga berubah selama migrasi, nonaktifkan server Webhooks lama di Pengaturan Aplikasi.
  Catatan: Langkah ini opsional jika Anda tidak mengubah server Webhooks setelah migrasi.

Langkah 4: Cadangkan pengaturan dari pengaturan saat ini

Gunakan token autentikasi saat ini untuk mencadangkan data pengaturan dari klien API WhatsApp Business saat ini.

Langkah 5: Hapus penginstalan pengaturan saat ini

Ini menyebabkan waktu henti untuk berkirim pesan. Untuk meminimalkan hal ini, pastikan klien API WhatsApp Business sudah siap dijalankan di lokasi baru. Lihat bagian Menghapus Penginstalan dari masing-masing Panduan Penginstalan untuk petunjuknya. Pastikan Anda hanya menghapus penginstalan klien API WhatsApp Business, yang mencakup kontainer Docker dari CoreApp, WebApp, dan Master; jangan menghapus database-nya.

Langkah 6: Pulihkan pengaturan di pengaturan baru

Login jika Anda belum menggunakan token autentikasi baru, dan melakukan pemulihan pada pengaturan baru.
Klien API WhatsApp Business baru Anda harus dijalankan dengan semua informasi wajib dan siap untuk berkirim pesan. Hal yang paling penting untuk diingat adalah pendaftaran ulang akun WhatsApp tidak diperlukan jika pengaturannya dicadangkan dan dipulihkan dengan benar.

Langkah 7: Lakukan pemeriksaan kesehatan

Lakukan pemeriksaan kesehatan dan kirim pesan pengujian untuk memverifikasi bahwa klien API WhatsApp Business telah berfungsi.

Langkah 8: [Opsional] Aktifkan verifikasi dua langkah

Jika Anda menonaktifkannya di Langkah 3, aktifkan kembali verifikasi dua langkah sekarang. Ini memberikan keamanan tambahan untuk akun WhatsApp Anda.

Langkah 9: Mengatur Webhooks

Siapkan Webhooks Anda untuk mengaktifkan notifikasi inbound.

Langkah 10: Hentikan database lama

Database lama Anda berisi data pengaturan lama, pesan lama, dan token autentikasi lama. Jika Anda ingin memulihkan data ini di masa mendatang, jangan hentikan database lama. Setelah Anda memutuskan untuk menghentikan database tersebut, pastikan klien API WhatsApp Business telah aktif selama setidaknya 14 hari dan fitur berkirim pesan berfungsi dengan baik sebelum menghapusnya.