Client Documentation
Get StartedStatus Page
  • 360Dialog
    • Why you should use 360dialog as Business Solution Provider (BSP)
    • Prices, plans and payment options
  • client hub
    • 360Dialog Client Hub
    • Numbers
      • Manage your WABA
        • Account Statuses
    • Activity
    • Funds
      • Month Closing Invoice (MCI)
    • Payment Management
    • API Keys
    • Template Message Management
    • Partner Change
    • Cancellation
    • Downgrade
  • WhatsApp Marketing
    • Best practices to maintain Account Health and prevent being blocked
    • Driving users to your WhatsApp account
      • WhatsApp Channels
    • Business Search
    • Linking a WABA to a Facebook Page /EN
      • Vinculando uma conta WABA à uma página do Facebook /PT
      • Cómo vincular un WABA a una página de Facebook /ES
    • Linking a WABA to Google Message Ads
    • Ads that Click to WhatsApp (CTWA) /EN
      • Anúncios de Clique para o WhatsApp (CTWA) /PT
        • Como usar o WhatsApp para marketing e vendas? /PT
      • Anuncios que Click to WhatsApp (CTWA) /ES
        • ¿Cómo usar WhatsApp para marketing y ventas? /ES
    • Conversions API (CAPI)
    • Create Ads lookalike audience based on WhatsApp events
    • MM Lite API Beta
      • Onboarding
      • Sending Messages
  • waba basics
    • WhatsApp Business Platform
    • WhatsApp Accounts structure
    • WABA for Government Agencies
    • WABA Policy Enforcement
    • Architecture and Security
    • The Basics (Overview)
    • Webhook Events and Notifications
    • Messaging API
      • Messaging Health Status
      • Step to Step to move to Cloud API
        • [will be deprecated] WABA Integration (On-Premise)
    • Migrating Phone Numbers
      • Migrate number from Meta or alternate BSP to 360dialog Cloud API
      • Migrate a phone number to a new WABA
      • Migrate to alternate BSP
  • waba management
    • Creating new WABA
      • Using a new phone number
      • WhatsApp Coexistence
        • Coexistence Onboarding
        • Coexistence Webhooks
    • Display Name Guidelines
    • Meta Business Verification
    • Official Business Account (OBA) or blue badge
    • WABA Profile Info
    • Capacity, Quality Rating, and Messaging Limits
      • Accelerated Onboarding
    • Hosting type Change
  • waba Messaging
    • Sandbox (Test API Key)
    • Receiving messages
    • Before sending a message
      • Checklist for Message Broadcasts and Campaigns
    • Conversations
    • Messaging
    • Conversational Components
    • Media Messages
      • Upload, retrieve or delete media
    • Template Messages
      • Template Elements
      • Sending Template Messages
      • Authentication Templates
        • Zero-Tap Authentication Templates
        • One-Tap Autofill Authentication Templates
        • Copy Code Authentication Templates
      • Catalog Templates
      • Product Card Carousel Templates
      • Single-Product Message Templates
      • Coupon Code Templates
      • Limited-Time Offer Templates
      • Multi-Product Templates
    • Interactive Messages
      • Single and Multi Product Messages
      • Location Request Message
    • Flows
    • Products & Catalogs
    • Contacts and Location Messages
    • Payments (India Only)
      • Receive WhatsApp Payments via Payments Gateway
      • Receive WhatsApp Payments via Payment Links
      • Order Details Template Message
    • Payments (Singapore only)
      • Receive WhatsApp Payments via Stripe
  • Partners
    • Partner Documentation
  • Support
    • Help and Support
      • Opening Hours & Response Time
      • Status Pages
      • Meta Support
      • Common Issues
    • Error Messages
    • Imprint & Data Privacy
    • FAQ
Powered by GitBook
On this page
  • What is the difference between On-premise and Cloud?
  • Hosting Type Change Process
  • Preparation Checklist
  • Number migration process
  • Bulk migration to Cloud API

Was this helpful?

  1. waba management

Hosting type Change

PreviousAccelerated OnboardingNextSandbox (Test API Key)

Last updated 5 months ago

Was this helpful?

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 of numbers to Cloud as soon as possible. .

Hosting Type Change 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. The number is connected and registered under On-premise hosting

    Confirm that the WhatsApp Business API account 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.

  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. Please reach out to your Solution Partner to perform the migration of your account.

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

  4. 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 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:

The migration time process can take from 5 to 60 minutes. You should expect downtime during and after this process. In case you encounter any issues, please reach out to our Support Team.

After the migration:

Bulk migration to Cloud API

If you wish to change the hosting type of more than 50 numbers at once, please reach out to your Software Solutions Provider. 360Dialog will coordinate and work closely with your Partner to facilitate the migration process for you.

The migration should be requested at least 7 days in advance to the migration date, as it requires proper planning.

Make sure you are calling the correct endpoint: https://waba-v2.360dialog.io

Make sure you are using the most recently generated . Old API KEYs will not work on the Cloud API. It is highly recommended that you generate another API key after the migration. See for more information.

See our

start changing the hosting type
Learn here how to integrate with Cloud API
/messages
API KEY
Cloud API Authorization Errors
Hosting Platform Type after Cloud API migration
specific documentation for setting up the phone number webhook.