Skip to main content
The Coexistence flow is automatically triggered when the business customer enters a phone number that is already in use with the WhatsApp Business app. Coexistence lets the business keep using the app on their phone while also enabling Cloud API access on the same number.

Authorization screen

This screen describes the data the business customer will be permitting your app to access.
009 440355 499307962 1008389814869598 5637589979105939691 N

Phone number entry screen

This screen lets the business customer enter the phone number they want to onboard. To trigger the Coexistence flow, the customer must enter a WhatsApp Business app phone number.
004 907c6a 801581607 1607352977790017 7594983767099348141 N

Business profile screen

This screen displays the WhatsApp Business app account details associated with the entered phone number — the profile picture, name, phone number, and website that the business has set in the WhatsApp Business app. The business customer reviews these details and confirms this is the WhatsApp Business app account they want to onboard.
013 3296b8 499313069 1389527599895128 7043341498025829570 N

Business portfolio selection screen

This screen lets the business customer select an existing Meta business portfolio to associate with the Coexistence onboarding, or create a new one.
007 2fc86d 499311597 981669164610316 1800456959882667107 N 1

Business creation screen

This screen lets the business customer create a new business portfolio by entering business information: name, country, and website.
014 Aa02bc 499295566 1871995543474424 9084855772139197380 N 1

QR code verification screen

This screen displays a QR code that the business customer scans from inside the WhatsApp Business app on their phone. To make scanning easier, a WhatsApp message containing a link to the QR code is also delivered to the same number. Once the customer scans the QR code, the flow advances automatically.
017 3f561b 499308522 2975432439456543 6277030950218254579 N

Business information confirmation screen

This screen lets the business customer confirm their WhatsApp Business Account name (read-only) and select a time zone (required) for the account.
010 705cea 499307309 1663908571513023 7981049472507936754 N 1

Terms and conditions review screen

This screen presents the terms and conditions that the business customer must accept to complete Coexistence onboarding.
015 Deec7b 499294643 941976661935218 7452330591006400118 N 1

Success screen

This screen indicates that the Coexistence onboarding completed successfully. When the customer clicks Finish, a message event is triggered containing the customer’s WhatsApp Business Account ID and business phone number ID, which you must use to onboard the customer to the platform.
011 2fb985 499299365 1649509376198400 2742425130304284765 N