Migrate WhatsApp business messaging to Genesys Cloud

Verified Meta business portfolio or account.
Meta business associated source WhatsApp business account (WABA) and destination WABA.
Source WABA with an approved status. To ensure migration eligibility, verify the WABA status with the current owner of your WABA.
Source WABA with a valid attached payment method. You cannot migrate phone numbers in WABAs without attached payment methods.
Approved display name of the phone number to be migrated. Display names in pending status cannot be migrated.
Two-step verification (2FA) of the inactive phone number.
- If the source WABA is owned by another WhatsApp provider, request to disable 2FA.
- If the source WABA is owned by Genesys Engage, email the Genesys Engage WhatsApp team at least two business days before the planned migration date so they can disable the 2FA for your numbers.
Phone number enabled to receive SMS or voice calls from international numbers for WhatsApp verification.
- If you choose the phone call method of verification and if your number is behind an IVR, then to receive the verification code, either temporarily disconnect the number from IVR or temporarily forward all calls going to your number to a mobile or landline.
- WhatsApp limits you from requesting too many codes in quick succession, and failure to receive the code and verifying that the number can result in your number being locked by WhatsApp.
Inbound message flow and digital bot flow setup for your Genesys Cloud organization. Once migration for the number is complete, configure a message route by associating the new integration to your flow.

As a user, migrate your phone numbers that are registered on the WhatsApp business platform through Genesys Engage or any other business solutions provider to Genesys Cloud using the Embedded Signup Flow process. If you meet the prerequisites, you can activate or migrate a number with 5-10 minutes, with potential for a brief period of downtime during the migration process.

Note:

If you are a Genesys Engage customer and you migrate your WhatsApp number to Genesys Cloud, then delete your WhatsApp Integration from your Genesys Engage hub and wait for 1-2 minutes before you proceed with the migration to Genesys Cloud. The number goes into offline status in the source WABA for a brief period before it is migrated and reactivated through Genesys Cloud.
Meta does not allow you to migrate business phone numbers from your mobile applications (WhatsApp Messenger or WhatsApp business app) to the WhatsApp business platform. If your WhatsApp number is registered on a mobile device app (either WhatsApp Messenger or WhatsApp business app), then delete the account from your mobile device, before you can register the number on the WhatsApp business platform through Genesys Cloud. You can use your number either on the business platform, on the business, or on the messenger app and it cannot exist concurrently on both accounts. Permanently delete your WhatsApp account from your mobile application. For more information about how to delete the account from your mobile application, see How to delete your account. Deleting the application does not release the number. Delete the number for it to be released and then treated as a new number for registration. After you have deleted the account, wait 3–5 minutes for the number to be released by WhatsApp. Then, create your WhatsApp integration in Genesys Cloud through the Embedded Signup Flow process.

To complete your phone number migration process, follow these steps.

Complete your phone number migration processClick to expand

To complete your phone number migration, perform the following steps:

Click Admin.
Under Message, click Platforms.
Click Menu > Digital and Telephony > Message > Platform Integrations.
Click Create New Integration.
Click WhatsApp Messenger.
Log in to your Facebook account.
Select the same Meta business portfolio that owns the source WhatsApp business account (WABA).
Select the WhatsApp business account. If you do not have a WABA, you can create one.
Create a new WhatsApp business profile for the number that is migrated. Use the approved display name for the number as provided in the source WABA.
Enter the number that you want to migrate. A warning message about the migration appears. Click the image to enlarge.
Select the preferred verification method. You can verify your number using either Text Message or Phone Call method.
Click Next.
In the Verification Code field, enter the six-digit verification code.
Click Next to verify your number.
Choose the Facebook pages that you want Genesys Cloud to access and click Continue.
Review what Genesys Cloud is requesting permission to do and click Continue.
After Meta has verified all information, click Finish.
The Platform page refreshes automatically. Complete the WhatsApp integration by performing the following steps:
1. In the Phone Number field, enter the WhatsApp phone number. Use the E.164 format to enter the phone number. Include the + sign and full number with country and area code, without any other characters or white spaces.
2. In the Name field, type a name that you want to assign to your WhatsApp Messenger integration.
3. In the PIN field, enter any six-digit PIN number to register your phone number on WhatsApp. Your PIN can be a combination of any six digits. You can use the same PIN for future actions on your WhatsApp phone number. It is encouraged that you save or store the PIN before you move on to creating your integration as Genesys does not persist this PIN. If you forget or misplace the PIN, you can change it from your Phone Number Settings page in your WhatsApp Manager.
4. Click Create Integration.
Click Confirm to create the integration.

If the integration fails to save, your traffic continues to flow through your current provider as long as the number is still connected in the source WABA. Traffic switches over to Genesys Cloud only after you create the integration and is in Active status, which ensures that there is no disruption to your traffic. Once you save your integration, proceed to configure the message route to associate the new WhatsApp Integration to your inbound message flow. For more information about how to configure a message route, see Add an inbound message route.

All the high quality templates from the source WABA are migrated to the new WABA automatically. To begin using these templates, configure them in your Canned Responses. You can also create new templates in the WABA by logging into your WhatsApp business manager. For more information about how to manage your WABA, see Manage your WhatsApp business account.

[NEXT] Was this article helpful?

Get user feedback about articles.