LogoLogo
Become a PartnerStatus Page
  • get started
    • Welcome to 360Dialog
    • Quickstarts
      • Register as a Meta Tech Provider
      • Add a WhatsApp Number
      • Set up Integrated Onboarding
      • Create a Message Template
      • Send a Message
      • (temp title) Getting started as a partner
    • Pricing & Billing
      • Payment Methods for BR: Pix & Boleto
      • Month Closing Invoice (MCI)
    • Get API Access
    • Tech Provider Program
      • Understanding the Meta Tech Provider Program
      • Becoming a Meta Tech Provider: A Step-by-Step Guide
  • MM Lite Beta Program
    • Onboarding
    • Sending Messages
    • Expected Errors & Programming Languages
    • MM Lite Sandbox Testing
      • Sending Messages using MM Lite Sandbox
      • Expected Erros & Programming Languages
  • Partner & Account Management
    • Solutions for Partners
      • Benefits for Partners
      • Partner Hub
      • WABA Management
    • Account Setup & Management
      • Prerequisites and best practices for account creation
      • Account Structure
      • Account Creation
  • Integrations & API Development
    • Webhook Events & Setup
      • Webhook Events (Partner & Messaging API)
      • Webhook Configuration & Management
    • Integration Best Practices
      • Architecture and Security
      • Best Practices for Designing Integrations
        • Design a Stable Webhook Receiving Endpoint
      • Sizing Your Environment Based on Expected Throughput
      • Design a Resilient Message Sending Service
      • Integrated Onboarding
        • Basic Integrated Onboarding
        • Custom Integrated Onboarding
        • Host Your Own Embedded Signup
      • API Key Authentication for the Partner API
  • API Reference
    • Messaging API
    • Messaging Health Status
    • Sandbox (Test API Key)
    • Differences Between Cloud API and On-Premise API for Partners
      • [will be deprecated] Messaging with On-Premise API
    • Partner API
  • WABA Management
    • Managing WABA Accounts
      • Using the Partner Hub to manage Clients and Channels
      • Using the Partner API to manage Clients and Channels
      • Partner Permission to Generate API Key
      • Checking Usage & Statistics
    • Phone Number & Hosting
      • Migrating a Phone Number
        • Migrate number from Meta or alternate BSP to 360Dialog
        • Migrate a phone number to a new WABA
        • Migrate a phone number to a new WABA to change messaging Currency
      • WhatsApp Coexistence
        • Coexistence Onboarding
        • Coexistence Webhooks
      • Hosting type Change (On-premise API to Cloud API)
    • WABA Profile & Compliance
      • Display Name Guidelines
      • WABA Profile Info
      • WABA Policy Enforcement
      • Business Account Verification
    • Partner change (between 360Dialog Partners)
    • WhatsApp Flows
    • Accelerated Onboarding
    • Business Account Verification
  • Messaging
    • Sending & Receiving Messages
      • Conversations
      • Receiving messages
      • Before sending a message
    • Message Types
      • Conversational Components
      • Checklist for Message Broadcasts and Campaigns
      • Text messages
      • Interactive messages
        • Single and Multi Product Messages
        • Location Request Messages
        • Address Messages (India and Singapore only)
      • Contacts & Location Messages
    • Template Messages
      • Template Library
      • 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
    • Media Messages
      • Upload, retrieve or delete media
    • Messaging Health & Troubleshooting
      • Messaging Limits & Quality Rating
      • Errors While Messaging
      • Messages statuses
  • Commerce & Payments
    • 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
    • Products and Catalogs
      • India Businesses: Compliance for Commerce
  • Support & Updates
    • Help & Troubleshooting
      • FAQ
      • Error Code Reference
      • User Support Documentation
        • Tutorials
          • Page How to Troubleshoot Login Issues in the 360dialog Hub
          • How to Report an Issue
          • How to Contact Support
        • How-To Guides
          • Raise a support request
          • Requesting a Status Update for Business Verification
        • Reference
          • Troubleshooting Embedded Signup Issues
          • Commerce Policy Checks for WhatsApp API Access
          • Support Availability & SLAs
          • Incident Issue Prioritization
          • Case Types Table
        • Explanation
          • Why Business Verification Takes Time
          • Why Some Issues Are Not Emergencies
          • Understanding the Support Process
      • Support with Meta
    • Imprint & Data Privacy
    • Product Updates & News
      • How to ensure your Template Messages will be received
      • Integrated Onboarding new look and Campaigns Best Practices
Powered by GitBook
On this page
  • What is the difference between On-premise API and Cloud API?
  • Hosting Type Change Process
  • Preparation Checklist
  • Number migration process
  • Schedule bulk migration to Cloud API

Was this helpful?

  1. WABA Management
  2. Phone Number & Hosting

Hosting type Change (On-premise API to Cloud API)

PreviousCoexistence WebhooksNextWABA Profile & Compliance

Last updated 7 months ago

Was this helpful?

What is the difference between On-premise API and Cloud API?

Historically, there is two different hosting options for a WABA: On-premise API (hosted by 360dialog) and Cloud API (hosted by Meta). .

Please be aware that API responses and parameters can be different depending on the hosting type. Please check the

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.

Hosting Type Change Process

To migrate a WABA from On-Premise API to Cloud API, please refer to our step-by-step instructions:

Preparation Checklist

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

  1. Your Partner Account is enabled for Cloud API .

  2. The number is connected and registered under On-premise hosting

    Confirm that the phone number is connected and registered under . 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.

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

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

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

After the migration:

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

Schedule bulk migration to Cloud API

If you wish to change the hosting type of more than 50 numbers at once (bulk migration), we can help. Follow the steps below:

  • Step 2: Review the provided documentation for the new configuration in Cloud API.

  • Step 3: Once you confirm and acknowledge the integration differences, continue to schedule a date and time. You will also need to provide the partner_id.

  • Step 4: Use the provided link to schedule the bulk hosting type change.

  • Step 5: You will receive a response starting the process up to 7 business days after scheduling.

When we receive your request, you will be contacted by our Support Team with the full list of numbers to be migrated for you to confirm. Make sure to check the numbers and confirm each one since reverting back to On-premise is not possible.

Please note that 360dialog cannot select nor restrict any numbers from being migrated, but you can still choose any amount over 50 numbers to change hosting type.

If you have any questions, don't hesitate to ask our Customer Support team.

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 for more information.

See our .

Please refer to and documentation for more information.

Step 1: , click on Onboarding > Number Migration (you must be logged with a Partner User) > request "Schedule a Bulk Migration to Cloud API".

specific documentation for setting up the phone number webhook
Differences between Cloud API and On-Premise API for Partners
Messaging API
Differences between Cloud API and On Premise API for Partners.
See differences between On-premise API and Cloud API
Learn how to change hosting type of registered numbers
See the difference between them here
On-premise hosting type
Open the Support Widget in the Hub
Hosting Platform Type after Cloud API migration
Enable Cloud API in your Partner Hub to be able to register Cloud API numbers
See what this is and how to enable it here
Cloud API Authorization Errors