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
  • Step 1: Get Familiar with Cloud API
  • Step 2: Make sure your integration is ready to support Cloud API
  • If you are a Direct Client with 360dialog
  • If you are a Client with Software Provider Partners
  • Step 3: Change Hosting Type to Cloud API
  • How to move an existing number to Cloud API
  • How to add a new number in Cloud API
  • Step 4: After the migration

Was this helpful?

  1. waba basics
  2. Messaging API

Step to Step to move to Cloud API

PreviousMessaging Health StatusNext[will be deprecated] WABA Integration (On-Premise)

Last updated 1 year ago

Was this helpful?

As announced in November 2023, Meta is transitioning to a fully Cloud-hosted WhatsApp Business Platform. Starting from On-Premise client v2.53, all new features 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.

This highlights the need for adapting your integration to support Cloud API and changing the hosting type of all numbers promptly.

Follow the instructions below to familiarize yourself with the Cloud API. Once you are ready, you can switch hosting types from the Hub, and if needed, we can assist with migrating multiple numbers simultaneously. If you're interested in this solution, please.

Step 1: Get Familiar with Cloud API

The Cloud API holds significant differences from the On-premise API. You can check the API specifications in our documentation.

Step 2: Make sure your integration is ready to support Cloud API

We recommend trying a test number using Cloud API before migrating numbers to ensure your integration works correctly. In case you require any assistance, don't hesitate to reach out to our Support Team.

If you are a Direct Client with 360dialog

If you are a Direct Client of 360dialog and are well-known with Cloud API requirements, you can skip to the next step and change the hosting type of your number to Cloud API using the 360dialog Client Hub interface.

If you are a Client with Software Provider Partners

If you are a Client of a 360dialog Partner, it is imperative to confirm that your partner is participating on our Partnership Program, and is ready and enabled to support Cloud API.

If your Partner is already enabled for Cloud API, proceed to the next step below to move your number to Cloud API.

Step 3: Change Hosting Type to Cloud API

You can seamlessly move your number to Cloud API from the Hub interface. Refer to our documentation below to learn how to do it. The migration may temporarily take down the number for a few minutes. In case you encounter any issues, please reach out to our support team immediately.

How to move an existing number to Cloud API

How to add a new number in Cloud API

Once you migrate a number, all new onboardings will be on Cloud API.

Step 4: 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 recommended that you generate another API key after the migration.

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

If your Partner is not yet prepared, Our support team is available to assist in any coordination efforts.

If you wish to move an existing number to Cloud API, you can use the 360dialog Hub interface. From there, you can easily switch hosting types and .

If you wish to onboard a number in on-premise, your Partner must pass a to set the hosting type back to on-premise. If you are a Direct Client with 360dialog, reach out to our support team.

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.

If you generate a new API Key, make sure to using the newly generated key.

If you encounter any issues, please.

contact our Support Team
Architecture and Security
The Basics (Overview)
Messaging API
please ask them to consult our Partner documentation.
Hosting type Change
specific API parameter during the signup flow
start changing the hosting type
contact our Support Team
reset your webhook again
confirm your current hosting model