If you have an existing setup of the WhatsApp Business API client and you want to migrate to a new setup using the same phone number, this document shows you how to identify changes to be made and what you need to do about them.
We no longer suggest database migration owing to privacy and complexity concerns.
Migrating the WhatsApp Business client settings preserves the application settings, the registration information and the encryption keys. Messages and authentication token info are not migrated.
Because the amount of data needing to be transferred between machines is minimal, there will be only a small downtime.
Set up your new WhatsApp Business API client using the Installation documentation.
The current authentication token will not be valid in new environment. Log in to the new setup to obtain a new authentication token.
Use the current authentication token to back up the settings data from the current WhatsApp Business API client.
This causes a downtime for messaging. To minimize it, make sure the WhatsApp Business API client is ready to run in the new location. Refer to the Uninstalling section of the respective Installation guide for instructions. Make sure you are only uninstalling the WhatsApp Business API client, which includes the Docker containers of the Coreapp, Webapp and Master; do not delete the database.
Log in if you're not already using a new authentication token, and perform a restore on the new setup.
Your new WhatsApp Business API client should be running with all the required information and ready for messaging. The most important thing to remember is re-registration of the WhatsApp account is not required if the settings are backed up and restored properly.
Perform a health check and send a test message to verify the WhatsApp Business API client is working.
If you disabled it in Step 3, re-enable two-factor verification now. This provides additional security for your WhatsApp account.
Set up your Webhooks to enable inbound notifications.
Your old database contains the data of your old settings, old messages and old auth tokens. If you want to recover any of this data in future, do not drop the old database. Once you decide to drop the database, make sure the WhatsApp Business API client has been running for at least 14 days and messaging is working well before deleting it.