Skip to main content
Use this guide if your WhatsApp Business Number is already connected to another Business Solution Provider (BSP) and you want to use it with YCloud.
This flow is for WhatsApp Business Platform numbers, not WhatsApp Business App coexistence numbers. If you use a WhatsApp Business App account with another BSP, follow Coexistence accounts migration. To connect a Business App account to YCloud for the first time, see Onboard WhatsApp Business App.

What migrates with the number

When you migrate your number to YCloud, the following details and eligible templates migrate with it. Templates with low quality, rejected templates, and templates pending approval do not migrate.

Before you start

The Facebook account you use for this process must be an administrator of the WhatsApp account that owns the number.

Migrate your number

1. Create a channel

In YCloud, open WhatsApp accounts and click + Create Channel.
YCloud WhatsApp accounts page with Create Channel highlighted.

Start from Create Channel on the WhatsApp accounts page.

2. Start embedded signup

Click I’m ready to start to open the Facebook signup popup. For this migration, you will select your existing registered number in the popup.
YCloud embedded signup page with the I'm ready to start button highlighted.

Click I'm ready to start to open Facebook Login for Business.

3. Sign in to Facebook and review the authorization

Sign in with the Facebook administrator account for your WhatsApp account. Review the access and terms shown in the popup, then click Continue to proceed.
Facebook Login for Business showing the YCloud connection introduction and Continue button.

Review the information about connecting your account to YCloud.

4. Select the registered number

On Add your WhatsApp phone number, open the Phone number dropdown. Search for the number you want to migrate and select it. The dropdown identifies an existing number with a Registered label. Click Next to continue.
Phone number dropdown showing a search result with the Registered label highlighted.

Search for your existing number and select the result labeled Registered.

5. Confirm the business portfolio and WhatsApp account

Confirm the Business portfolio (Business Manager, or BM) and WhatsApp account that own the number. Meta displays This number is already used for another integration because the number is connected to another BSP. Review the conversation-routing warning. Confirm that the existing integrations support conversation routing before selecting the confirmation checkbox, then click Next.
Business portfolio and WhatsApp account selection with a warning that the number is already used for another integration and a conversation-routing confirmation checkbox.

Confirm the business assets and review the warning about the existing integration.

6. Confirm the display name

Review the number’s Display name, then click Next. You cannot change the display name during this migration flow.
WhatsApp Business display name confirmation screen with the Next button.

Confirm the existing display name and continue.

7. Confirm the permissions

Continue through the remaining authorization screens. Review and confirm the permissions to connect the account to YCloud. When Meta displays Your account is connected to YCloud, continue to the next step to finish the flow.

8. Click Finish

You must click Finish. Do not close the popup with its close button. Closing the popup instead of clicking Finish can prevent YCloud from completing the migration, even if Meta already shows that the account is connected.
Click Finish on the final screen.
Meta's account connected confirmation screen with the Finish button at the bottom.

Click Finish to complete the signup flow. Do not close the popup manually.

9. Wait for YCloud to complete the connection

After you click Finish, the popup closes automatically. Wait for YCloud to finish connecting the number before testing messages.

10. Set conversation routing to YCloud

After the connection completes, you must set Conversation routing to YCloud in Meta. The routing may still point to the previous BSP, so complete this step before testing messages.
  1. Open WhatsApp accounts in Meta Business Settings and sign in with your administrator account.
  2. Search for the migrated phone number and select it.
  3. Open Conversation routing, then click Manage under Message routing.
Meta WhatsApp account settings with the Conversation routing tab and Manage button highlighted.

Select the migrated number, open Conversation routing, and click Manage.

  1. In Configure conversation routing, select YCloud for each routing category shown, including customer messages and replies to ads, marketing messages, and utility messages. If Calls with customers is shown, set that category to YCloud as well.
  2. Click Apply to save the changes.
Configure conversation routing dialog with YCloud selected for each message routing category.

Select YCloud for the routing categories, then click Apply.

11. Test sending and receiving messages

Send a test message from YCloud using the migrated number. Reply from the recipient’s WhatsApp account and check that YCloud receives the reply.