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.

Prerequisites for migration of hosting from On-premise to Cloud

• A valid On-premise WhatsApp Business API account registered with 360dialog and access to the phone number

• Confirm that the number is registered under a On-premise WhatsApp Business API account. If the account is under the Cloud API, this process will fail. Cloud API to On-premise API migration is not supported by Meta.

• The WhatsApp Business Account connected to the number to be ported must be verified by Meta. Accounts that are not live for any reason cannot be ported.

• The client must be able to receive and verify a 6 Digit PIN Code by SMS or Voice Call.

Limitation of Cloud API Numbers per WABA

Each WABA can only have one Cloud API number. If you need to use multiple numbers from the same WABA in the Cloud, you will need to move them to separate ones.

Adding another number to the same WABA will cause the webhook to be shared across all numbers, which may result in receiving events for both numbers in a single webhook.

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. Meta Business Manager is verified The Meta Business Manager must be fully verified.

2. The number is registered under a On-premise hosting

   Confirm that the WhatsApp Business API account is registered under On-premise hosting type. If the account is under the Cloud API, this process will fail.

3. Phone number access The client must have access to the phone number to receive a 6 Digit PIN Code via SMS or Phone Call.

4. 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 can start messaging through the Cloud API. Please refer to Differences between CloudAPI and On Premise API for partners.