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 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 a phone number from Classic Signup WABA to Embedded Signup WABA
  • Migrate a phone number to a new WABA with another currency set
  • Other Possible Changes
  • Hosting type Change
  • Partner Change (between 360dialog Partners)

Was this helpful?

  1. WABA Management
  2. Phone Number & Hosting

Migrating a Phone Number

PreviousPhone Number & HostingNextMigrate number from Meta or alternate BSP to 360Dialog

Last updated 11 months ago

Was this helpful?

What is a number Migration Process?

A Migration Process refers to the necessary steps taken when there is a need to move 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 your client's number is registered as a WhatsApp Business API, try messaging it.

If the Call icon appears in the top right of the app, it means that this is a WhatsApp Business App account. If the Call icon is not available, it means that it is registered in the WhatsApp Business API.

Note: In some cases, the call icon may not appear correctly on the business accounts of the current desktop version of WhatsApp. If this occurs, you can verify whether the number is registered by checking the message that appears when starting the conversation.

If the message is similar to the one below, it means that the number is still registered on the WhatsApp 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:

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.

Migration Types

When migrating an account, there are the following possibilities:

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

If you have Cloud Enabled to your Partner Account, any number that is migrated to your Partner Hub will automatically be hosted in the Cloud API.

Migrate a phone number from Classic Signup WABA to Embedded Signup WABA

Migrate a phone number to a new WABA with another currency set

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

If you have Cloud API enabled in your Partner Account, any number that is migrated to or created in your Partner Hub will automatically be hosted in the Cloud API.

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.

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. One option is to utilize the or 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.

If the current number is registered in On-premise API, once migrated, it will have Cloud hosting with 360dialog, unless the Hosting type is specified during the Account Creation, or, if the Partner Account is not enabled for Cloud API. See our.

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

You can migrate numbers onboarded on the deprecated Classic Signup (On Behalf-of) model to Embedded Signup (Shared WABA). For this, please .

To allow for Conversation fees charges in a different currency, the number has to be migrated to a new WABA with the new currency set. For this, .

To change an existing number’s hosting type from 360dialog On-premise to Cloud API, please refer to process.

To transfer management of an existing WhatsApp Business Account to a new partner, the Partner Change process must be initiated by the client through the 360dialog Client Hub. The change request can then be accepted via the 360dialog Partner Hub notification center. See .

See differences between On-premise API and Cloud API
Learn how to change hosting type of registered numbers
please follow these steps
follow the steps described here
please follow the steps described here
this
See differences between On-premise API and Cloud API
Learn how to change hosting type of registered numbers
Partner Change process
Partner API
360dialog Hub
In this case, you should follow the steps outlined here.
Enable Cloud API in your Partner Hub to be able to register Cloud API numbers
documentation about this here
Enable Cloud API in your Partner Hub to be able to register Cloud API numbers