Links

Hosting type Change

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).
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. From May 15, 2024, 360dialog will not allow for new numbers to be onboarded with On-Premise API. We will continue supporting already registered On-Premise API throughout 2024, but we strongly recommend to start changing the hosting type of numbers to Cloud as soon as possible. Learn here how to integrate with Cloud API.

Webhook per WABA for Cloud API

When using Cloud API, a Webhook should be set per WABA, and not per Phone number. This means that traffic from all Cloud numbers in the same WABA will go through the same Webhook. See how to Set Webhook URL per WABA.
When changing hosting type from On-premise to Cloud, the Webhook previously set for the Phone number will be used for the whole Cloud WABA. If you change the hosting type of a second number from On-premise to Cloud, the webhook will not change.

Migration Process

To migrate a WABA from a 360dialog On-Premise to Cloud API, please refer to our instructions below:

Preparation Checklist

Before migrating a number, it's important to go ensure the following:
  1. 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. 2.
    Access to 360dialog Hub
    The process is handled in the 360dialog Hub. You must either be a Direct Client with 360dialog or have a Partner with Cloud API enabled.

Number migration process

In the 360dialog Client 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.
After the migration:
  • Make sure you are calling the correct endpoint: https://waba-v2.360dialog.io/messages
  • Make 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.
  • Use the WABA Webhook endpoint to configure a new Webhook for all Cloud numbers in this WABA. If you don't do so, the Webhook previously set for the On-premise phone number will be used.