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
      • How to contact Support
    • Error Messages
    • Imprint & Data Privacy
    • FAQ
Powered by GitBook
On this page
  • What is a number Migration Process?
  • Making sure the account is registered as WhatsApp Business API
  • How to identify if the WABA is registered in On-premise or Cloud API?
  • Migration Types
  • Migrate number (alternate BSP or Meta) to 360dialog API
  • Migrate to alternate BSP
  • Other Possible Changes
  • Hosting type Change
  • Partner change (between 360dialog Partners)

Was this helpful?

  1. waba basics

Migrating Phone Numbers

Previous[will be deprecated] WABA Integration (On-Premise)NextMigrate number from Meta or alternate BSP to 360dialog Cloud API

Last updated 7 months ago

Was this helpful?

What is a number Migration Process?

A Migration Process refers to the necessary steps taken when moving a number from one WABA (WhatsApp Business Account) to another.

It is applicable in various scenarios, such as Migrating a number from one BSP (Business Solution Provider) to another, migrating from Classic signup to Embedded signup WABA, or making changes to payment settings like WABA currency.

Making sure the account is registered as WhatsApp Business API

These steps are only for numbers registered as WhatsApp Business API accounts. If you are not sure the number is registered as a WhatsApp Business API, try messaging it.

If the message is similar to the one below, it means that the number is still registered on the WhatsApp Business App.

How to identify if the WABA is registered in On-premise or Cloud API?

If the WABA is registered in Cloud API

This is the standard message when starting a conversation with a WABA registered on the Cloud API:

[will be deprecated] If the WABA is registered in On-premise API

This is the standard message when starting a conversation with a WABA registered on the On-premise API:

Migration Types

When migrating an account, there are the following possibilities:

Migrate number (alternate BSP or Meta) to 360dialog API

If the current number is registered in On-premise API, once migrated, it will have Cloud hosting with 360dialog, unless your Partner is not enabled for Cloud API or if your Partner specifies a different hosting type during Integrated Onboarding.

Migrate to alternate BSP

Other Possible Changes

In addition to migrations, there are other scenarios that may require adjustments to a WhatsApp Business Account (WABA) while maintaining the same phone number within the same WABA. These instances involve making Account changes, which are distinct from Migration processes.

Rather than transferring a phone number from one WABA to another, these changes focus on updating specific configurations or functionalities within the existing WABA. For instance, it could involve upgrading a number to a Multi-Connect Setup or moving the number from On-premise to Cloud API (vice versa).

When changing the settings of a WABA, there are the following possibilities

Hosting type Change

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.

Partner change (between 360dialog Partners)

To determine whether a number is registered On-premise or on Cloud API, there are a few methods you can use. You can check directly in the (if the number is already registered with 360dialog). Another option is to start a new conversation with the number and check the message that appears when starting the conversation.

To migrate a number, from an alternate BSP or Meta to 360dialog API, please follow steps.

Please refer to if you wish to migrate your number to an alternate BSP.

If you would like to change an existing number’s hosting type from 360dialog On-premise to 360dialog Cloud API please refer to process.

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

To transfer management of an existing WhatsApp Business Account to a new partner, the Partner Change process must be initiated through the 360dialog Client Hub. See .

360dialog Hub
these
this process
this
start changing the hosting type
Learn here how to integrate with Cloud API
Partner Change Process