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
  • What is Number Migration?
  • What is moved with the number?
  • Preparation checklist
  • What to do if it returns an error when adding a new number
  • How to start the migration
  • Provide your company and number details
  • Go through Meta Embedded Signup
  • Done! That's it!
  • Troubleshooting
  • FAQ

Was this helpful?

  1. waba basics
  2. Migrating Phone Numbers

Migrate number from Meta or alternate BSP to 360dialog Cloud API

Bring your WhatApp Business API Number to 360dialog!

PreviousMigrating Phone NumbersNextMigrate a phone number to a new WABA

Last updated 21 days ago

Was this helpful?

We have changed the migration flow to make it simpler. Now, after going through the , you can directly go through the normal "Add number" flow.

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 allows for 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

What is moved with the number?

Migrated

Display name

Quality Rating

Messaging Limits

Official Business Account status

Uploaded Media

Approved high quality message templates

Low quality, rejected, or pending message templates

Catalogs

Message and chat history

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.

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

Preparation checklist

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

  1. You must have Admin Access to Meta Business Manager

  2. You are migrating the number from another BSP

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

What to do if it returns an error when adding a new number

When adding a new number, if you see this screen (red warning): It means that one of the above checks are not fulfilled.

Go back and double check. If everything is okay, you should see this screen after pressing Next button (yellow warning):

How to start the migration

If you are working with a 360dialog's Partner, use their normal add number process.

Provide your company and number details

Go through Meta Embedded Signup

Your number should be available within the next 5 mins, you will receive an email notification.

Troubleshooting

Here are some common errors and solutions that you might encounter during the migration process.

"This number is already connected to an existing WABA"

"Two-factor authentication not yet disabled"

Before you can verify your phone number ownership you first need to disable two-factor authentication (2FA) for this number. This can be done either by you or by the Business Solution Provider, that is currently in charge of this number.

"Register Name should be present and approved"

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

FAQ

How can I check if my number is able to receive PIN Code via SMS or Voice Call?

Try to call it from an international number and/or send an SMS to it. If you are not able to receive the call/SMS, you may have troubles verifying the phone during the migration process.

Please reach out to your phone number provider to get help.

How can I check if my Meta Business Account is verified?
How can I check if my WhatsApp Business Account (WABA) is approved?
How can I check if 2FA is disabled, and disable it in case it's not?

You or your current BSP must disable 2FA. The 2FA can and should be disabled without also removing the entire deployment or deleting the number. Ask your current BSP for help to diable the 2FA in case you are not able to.

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.

How can I check if my WhatsApp Business Account (WABA) has a valid payment method attached?
How can I check if the display name of my number is approved?

Yes

Yes

Yes

Yes

Yes

Yes

No

No

No

Ensure the phone number you want to migrate is able to receive and verify a 6 Digit PIN Code through SMS or Voice Call (ensure you can receive international calls).

Your Meta Business Account is verified.

The existing WhatsApp Business Account (WABA) must be approved.

The Display Name is approved.

Your existing WABA must have a valid payment method attached (in Payment Settings).

Two-Factor Verification (2FA) must be disabled for the number.

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.

If you want to integrate directly with 360dialog's API, .

Done! That's it!

Otherwise, please reach out to our Support Team through the Support Widget

This error may occur when adding the number for migration 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

Please confirm that the 2FA was disabled before submitting the account for migration.

The of the account . Migration cannot be done until the Display Name is approved. In case disaply name approval is pending, you should wait until it's finnaly approved

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

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

Go to the and ensure the status is " Verified" for you organization.

If it's not, .

Go to your , and ensure the Account status is " Approved".

Go to your , click on the phone number you want to migrate and see the Tw-steps verification details

Go to your , and the payment method should appear on the bottom-right side.

Go to your , click on the phone number you want to migrate and see the Profile details

🇧🇷
🎉
go here to signup or login
Please follow the process listed here
Click here to understand more about the WhatsApp accounts and IDs.
✅
Business Security Center
check here how to verify your Account
🟢
WhatsApp Business account
phone number settings inside WhatsApp Manager
WhatsApp Business account
phone number settings inside WhatsApp Manager
quality rating
messaging limits
Official Business Account status
high-quality
Preparation Checklist
Check how
Check how
Check how
Check how
Check how
Check how
Check how.
Display Name
must be approved
✅
✅
✅
✅
✅
✅
❌
❌
❌
reach out to our Support team
reach out to our Support team
Integrated Onboarding - Number registration
Meta Embedded Signup - Number registration