Migrate 360dialog On-Premise API to 360dialog Cloud API

What is the difference between On-premise and Cloud?

When registering a WABA with 360dialog, there are 2 different hosting options: 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 CloudAPI and On Premise API for partners.

Constraints of Cloud API Numbers per WABA

In case there is a Cloud API number already present in the same WhatsApp Business Account (WABA), the webhook will receive the events for both numbers. To avoid this, the number will need to be transferred to a WhatsApp Business Account (WABA) that doesn't have any Cloud API numbers associated with it. To create a new account, use the Integrated Onboarding.

Migration Process

To migrate a WABA from a 360dialog On-Premise to Cloud API, please refer to our step-by-step instructions through the 360dialog Client Hub:

Preparation Checklist

Before migrating a number, it's important to go ensure the following:

1. The number is conected and registered under a On-premise hosting

   Confirm that the WhatsApp Business API account is connected and registered under On-premise hosting type.

2. 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.

Number migration process

In the 360dialog Partner 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:

Hosting Platftom Type after Cloud API migration

The migration time process per WABA takes ~3 min. When it is finished, you must re-set your Webhook URL and start messaging through the Cloud API. Please refer to Differences between CloudAPI and On Premise API for partners.