Hosting type Change (On-premise API to Cloud API)
What is the difference between On-premise API and Cloud API?
Historically, there is two different hosting options for a WABA: On-premise API (hosted by 360dialog) and Cloud API (hosted by Meta). See the difference between them here.
Please be aware that API responses and parameters can be different depending on the hosting type. Please check the Differences between Cloud API and On Premise API for Partners.
As announced in November 2023, Meta is transitioning to a fully Cloud-hosted WhatsApp Business Platform and will stop supporting On-Premise API in October 2025. Starting from On-Premise client v2.53, all new feature updates will be exclusively delivered to Cloud API. While the On-Premise API client will receive quarterly releases, they will focus solely on bug fixes and security patches.
Hosting Type Change Process
To migrate a WABA from On-Premise API to Cloud API, please refer to our step-by-step instructions:
Preparation Checklist
Before migrating a number, it's important to go ensure the following:
Your Partner Account is enabled for Cloud API See what this is and how to enable it here.
The number is connected and registered under On-premise hosting
Confirm that the phone number is connected and registered under On-premise hosting type. Disconnected numbers need to be reconnected before changing hosting type.
The hosting type change itself will not require registration (receiving OTP), but if it was triggered when the number wasn't fully connected, it will fail.
Access to 360dialog Hub
The process is handled in the 360dialog Hub. No public endpoint is available to change the hosting type through the API yet.
Access to last API Key generated or to generate a new one
In Cloud, only the most recent API Key will work. To ensure everything goes smoothly after migration, we strongly recommend that you generate a new API Key.
Prepare for possible downtime The migration time process can take from 5 to 60 minutes. You should expect downtime during this timeframe.
Number migration process
In the 360dialog Hub > Details page for any number, there is a property "Hosting Platform Type".
From there, you can launch the Cloud migration assistant.
Your request will be processed. You either wait for it to be done or close the pop-up. You will receive a notification in your Notification Center whenever the migration is completed.
Done!
After the number is migrated, the Hosting Platform Type will appear as below:
The migration time process can take from 5 to 60 minutes. You should expect downtime during and after this process.
After the migration:
Make sure you are calling the correct endpoint:
https://waba-v2.360dialog.io/messagesMake sure you are using the most recently generated API KEY. Old API KEYs will not work on the Cloud API. It is highly recommended that you generate another API key after the migration. See Cloud API Authorization Errors for more information.
Please refer to Differences between Cloud API and On-Premise API for Partners and Messaging API documentation for more information.
Schedule bulk migration to Cloud API
If you wish to change the hosting type of more than 50 numbers at once (bulk migration), we can help. Follow the steps below:
Step 1: Open the Support Widget in the Hub, click on Onboarding > Number Migration (you must be logged with a Partner User) > request "Schedule a Bulk Migration to Cloud API".
Step 2: Review the provided documentation for the new configuration in Cloud API.
Step 3: Once you confirm and acknowledge the integration differences, continue to schedule a date and time. You will also need to provide the
partner_id.Step 4: Use the provided link to schedule the bulk hosting type change.
Step 5: You will receive a response starting the process up to 7 business days after scheduling.
When we receive your request, you will be contacted by our Support Team with the full list of numbers to be migrated for you to confirm. Make sure to check the numbers and confirm each one since reverting back to On-premise is not possible.
Please note that 360dialog cannot select nor restrict any numbers from being migrated, but you can still choose any amount over 50 numbers to change hosting type.
If you have any questions, don't hesitate to ask our Customer Support team.
Last updated
