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

Was this helpful?

Last updated 24 days ago

Was this helpful?

Note that once Cloud is enabled in a Partner Hub, every new number (created from scratch or migrated) will be automatically 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.

What is Number Migration?

Number Migration means that a phone number that is already registered for the WhatsApp Business API can be moved between WhatsApp Business Accounts.

This process allows businesses to change BSPs (Business Solution Provider) or move their number to a new account. It is possible to migrate a number between accounts only if the source and destination Business Manager IDs are the same.

After being migrated, a phone number keeps its display name, , , , and any message templates previously approved.

If you are migrating an account with a high volume of messages or a high number of accounts, we can help ensure everything goes smoothly. Please contact our Support team.

What is moved with the number?

Template Messages and chat history migration Only the high quality message templates are migrated on this process. In practice, they are copied to the destination WABA. These templates do not need to go through review again and can be sent immediately. Low quality, rejected, or pending templates are not migrated. Any existing message templates in the destination WABA will not be overwritten. Message and chat history are not migrated with this process.

Catalogs Catalogs are not migrated with this process.

Billing Migration Messages sent before migration are charged to the source BSP. Messages sent after migration are charged to the destination BSP. Messages sent from the source, and that are not delivered before migration, are still charged to the source BSP when they get delivered.

Official Business Accounts (Green Badge) Official Business Accounts (OBAs) can be migrated between WABAs. The only requirement is that the two-factor authentication needs to be disabled during the migration process. It can be re-enabled after the number is migrated.

Prerequisites for Migration of Numbers

A valid WhatsApp Business Account and access to the phone number

  • The client must be able to receive and verify a 6 Digit PIN Code through SMS or Voice Call.

  • The WhatsApp Business Account connected to the number to be migrated must be verified by Meta. Accounts not live for any reason cannot be migrated.

The client or the existing BSP must disable 2FA. The 2FA can and should be disabled without also removing the entire deployment or deleting the number.

Meta rules state that the BSP cannot delay or difficult the disablement of 2FA or the migration process at all. If this happens, please report to us and we will escalate the case to Meta.

Admin Access to Business Manager

  • The client must have ownership of the Business Account.

Preparation checklist

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

  1. Admin Access to Meta Business Manager You must have Admin access to the FBM Account.

  2. Display Name is verified The DIsplay Name of the account must be approved in the old BSP.

  3. Website listed in the Meta Business Manager is valid and live Meta checks if the Website listed in the Meta Business Manager > Business Info section is correct and live. If it isn't, the account will be offline after the number is migrated.

  4. Phone number access You must have access to the phone number to receive a 6 Digit PIN Code via SMS or Phone Call.

  5. 2FA Disabled You must check and confirm with your old BSP that Two-Factor Verification (2FA) is disabled on the existing WhatsApp Business API Client.

🇧🇷 Extra step for Brazilian numbers: Check in your current WhatsApp profile if the number registered has the extra 9 or not. When migrating the number, it should look exactly the same as the current profile.

How to start the migration

If the client does not have a 360Dialog Client Hub account

To migrate numbers of new clients, you should use your unique Number Migration Signup link, which is available inside your 360Dialog Partner Hub, under the Share signup form button.

Any numbers submitted through this form will be linked to your 360Dialog Partner Hub.

The first page of the form will create a 360Dialog Client Hub account for this client. The client will then be redirected to log in the created account to continue with the process as explained below.

If the client already has a 360Dialog Client Hub account

The client will be asked to input the phone number to be migrated, as well as the Meta ID that owns the number:

The "Add Number" button is disabled for Partner-Client accounts. To add a new number, please launch Integrated Onboarding directly from the Partner application.

Migration process with Number Migration Signup link

If the client already has a 360Dialog Client Hub account, the process will start from number 3.

1. Submit Account details

The number migration process starts with the client submitting their company details.

Note that the first page of the form will create a 360Dialog Client Hub account for this client. If the client is already registered, they must Log-in and use the "Import from another BSP" button, as mentioned previously.

2. Proceed with migration in 360Dialog Client Hub

Once the account is created, clients will be prompted to log in to the 360Dialog Client Hub and continue from there. When users log in, they will be able to access the tool for the migration.

3. Create a new WABA or connect an existing one

In the 360dialog Client Hub, the client must enter the phone number to be migrated, and they can either create a new WhatsApp Business Account (WABA) or migrate the number to an existing account.

When a client decides to create a new WABA, they can initiate the process by selecting the appropriate option. This will activate the embedded signup feature, where they need to follow the steps outlined below to successfully create a new WABA.

The following steps will create a WhatsApp Business Account (WABA), which can then be used as a target account for the existing number to be migrated to.

Note that this process may undergo some difficulties along the way due to various reasons.

We are actively working alongside Meta to improve the overall experience during the number migration process. If you need assistance while creating an new WABA, don't hesitate to reach out to our Support Team.

To create an Whatsapp Business Account, follow these simple steps through the Embedded Signup process:

Step 1: Fill in the Business information

The client must select from creating a New Meta Business Account or use an existing Meta Business Account.

Step 2: Create a WhatsApp Business Account

In this step, the client will have the following options:

"Choose a WhatsApp Business Account"

All WABAS currently associated with the Business Manager ID provided in the previous step will be available for selection.

To create a new WABA, choose the option to "Create a new WhatsApp Business Account" and complete all the required business details in the next step.

Prefer to use clear and distinct WABA names to avoid mistakes. Take note of the existing WABA ID and Name before creating a new one for easy differentiation during the migration steps.

Step 3: Create the new WhatsApp Business Profile

If the client chooses to create a new WhatsApp Business Profile, select the option "Create a new WhatsApp Business Profile" and complete all the required business details on the next screen.

5. Continue migration through the 360Dialog Hub

Return to the Migration Screen and select the checkbox "I have just created the business account as the previous steps indicated".

For this process to work, the WABA must be newly created and not older than 48 hours.

6. Verify ownership of the number

Once the client provides the new WABA ID, we'll prompt them to verify their phone number. They will receive a 6-digit PIN through SMS or a phone call.

7. Generate API key

After the phone number is successfully migrated, permissions will be defined by default.

If you have Partner Payment, you should have permissions to manage the number automatically.

Number Migration Support

To ensure minimal downtime while migrating your number to 360Dialog, we offer special Number Migration Support.

Troubleshooting

During the migration process, a few errors might occur. Here is how to solve them:

"This number is already connected to an existing WABA"

"Two-factor authentication not yet disabled"

"This phone number is eligible to be added directly, and does not need to be migrated. Please go to the 360Dialog Client Hub and add it as a new number"

"The phone number you are trying to migrate has already been moved to your destination WhatsApp Account. Please log in to the 360Dialog Client Hub to continue."

This means that the number is already available in 360Dialog. You can use the 360 Client Hub to manage it.

"The source and destination WhatsApp Business Accounts need to represent the same business. Please use the same Business ID as before when submitting the number for migration."

This means that the Meta Business ID sent in the form is not the same ID that currently manages this account. Please check the Business Manager and/or the old BSP dashboard to confirm which Business ID manages this WhatsApp account.

"Something went wrong when trying to migrate your phone number. Please try again after some time. If that does not work, please contact our support via the 360Dialog Client Hub."

Two-Factor Verification .

of the number to be migrated.

Meta Business Manager is verified Your Meta Business Manager must be .

The client needs to access their and select the option right next to the Add number button:

During this step, ensure to select the appropriate Meta Business Account. It is possible to migrate a number between accounts only if the source and destination Business Manager IDs are the same. Please refer to .

If you have Direct Payment, the client must give permissions to manage the number, and you will be able to to send messages with the number migrated to 360Dialog.

See .

Please reach out to our support team via chat or to schedule a session.

Important: make sure you have everything ready from the before booking your call.

This error may occur when adding the number to be migrated in step 3 verification screen. A new WABA should be created anyhow. If you face issues, try using a dummy number. For further help, please

See our documentation about

This means that you should not use the migration form to register this number. instead.

"Register Name should be present and approved" Theof the account must be approved in the old BSP. Migration cannot be done until the Display Name is approved. Please retry later.

This means that an unexpected error occurred. Please with the information about this number and account so we can investigate accordingly.

  1. WABA Management
  2. Phone Number & Hosting
  3. Migrating a Phone Number

Migrate number from Meta or alternate BSP to 360Dialog

This process works if the current account is using On-premise or Cloud API.

PreviousMigrating a Phone NumberNextMigrate a phone number to a new WABA
  • What is Number Migration?
  • What is moved with the number?
  • Prerequisites for Migration of Numbers
  • Preparation checklist
  • How to start the migration
  • If the client does not have a 360Dialog Client Hub account
  • If the client already has a 360Dialog Client Hub account
  • Migration process with Number Migration Signup link
  • 1. Submit Account details
  • 2. Proceed with migration in 360Dialog Client Hub
  • 3. Create a new WABA or connect an existing one
  • 5. Continue migration through the 360Dialog Hub
  • 6. Verify ownership of the number
  • 7. Generate API key
  • Number Migration Support
  • Troubleshooting
must be disabled for the number
Meta Business ID
fully verified
360dialog Client Hub
Whatsapp Accounts Structure
Partner Permission to Generate API Key
creating a ticket
Please follow the process listed here
DIsplay Name
Click here to understand more about the WhatsApp accounts and IDs.
migration checklist
See differences between On-premise API and Cloud API
Learn how to change hosting type of registered numbers
quality rating
messaging limits
Official Business Account status
high-quality
generate the API key
reach out to our Support team
reach out to our Support team
2FA
Enable Cloud API in your Partner Hub to be able to register Cloud API numbers