Onboarding WhatsApp Business app users - "Coexistence"

1. Binding process

1. Visit the InnoPaaS platform

Go to the Sender menu and click WhatsApp Business App

2. Log in with a Facebook account

On the login authorization page, click Continue

3. Select a business asset group

If available, you can choose to create an asset group

4. Select the associated WhatsApp Business app

5. EnterWhatsApp Businessnumber

Enter the number and click [Continue]

6. A QR code is displayed

At this point you need to open your phone, log in to the WhatsApp Business App and scan this code

7. Open your phone WhatsApp Business App

1. Open the app icon below, open the camera in the app's top right corner, and scan the QR code above

2. After waiting for the right-side interface to pop up, tap Connect to the Business Platform on the phone

8. Choose whether to share chat history

If you choose to share, the system will sync all messages sent or received within the last 180 days.

• Messages in group chats will not be included

• Media messages will not include media material IDs; however, other historical Webhooks containing media message material IDs will be sent separately, but only for media messages sent within 14 days after onboarding

• Disappearing messages are not included

If you choose not to share, chat messages will not be synced.

9. Confirm the business account

Scan the QR code again. At this point the InnoPaaS platform will display the business account information for confirmation. If the time zone is empty, please select the time zone of the country where your number is located (time zone is required; otherwise it will affect subsequent InnoPaaS platform approval, and the platform API will not be able to send messages)

10. Click [Confirm] and wait for Meta to bind the account

11. Click [Finish] to complete the InnoPaaS information binding

Click the finish button to complete the final step where InnoPaaS authorizes the number to be bound to the platform account.

At the same time the phone will also show that the binding is complete.

2. Requirements and precautions

Requirements

• Business clients must use WhatsApp Business app version 2.24.17 or higher.

• The country/region code of the business client's phone number must be supported

• You must know how to usethe Cloud API

• You must use embedded registration withsession historyincluded

Limitations

• To ensure compatibility with the WhatsApp Business app, the throughput for company phone numbers used for both the WhatsApp Business app and the Cloud API is fixed at 20 mps.

• If your business client previously worked with a partner and is still sharing the previous quota, they may see an error message when trying to switch to a new partner. Follow theguideto resolve the error.

Unsupported countries/regions

WhatsApp Business business account phone numbers with country/region codes from the following countries/regions are not supported:

• Nigeria

• South Africa

Customer service window

Customer service windowThe customer service window only opens when a WhatsApp user sends a message to a business that has onboarded the Cloud API. If a WhatsApp user sends a message to a business before the business has onboarded the Cloud API, the business can only reply with template messages because the customer service window has not yet opened. If the user sends a message after the business has onboarded the Cloud API, the customer service window will open as usual and the business can reply with non-template messages.

Feature comparison

The table below describes features available to businesses that have onboarded the Cloud API and any changes to WhatsApp Business app functionality after onboarding.

Existing features of the WhatsApp Business app	Changes to WhatsApp Business app features after onboarding to the Cloud API	Are WhatsApp Business app features supported on the Cloud API?
Individual (one-to-one) chat	Message editing/recall is no longer supported.	Supported. All chat messages from the past 6 months can be synced. Sent and received messages will be mirrored between the Cloud API and the WhatsApp Business app.
Contacts	No change.	Supported. All contacts with WhatsApp phone numbers can be synced.
Group chat	No change.	Not supported. Group chats will not be synced.
Disappearing messages	Disappearing messages for all individual (one-to-one) chats will be turned off	Not supported.
View-once messages	View-once messages for all individual (one-to-one) chats will be disabled	Not supported.
Live location messages	Live location messages for all individual (one-to-one) chats will be disabled	Not supported.
Broadcast lists	Broadcast list functionality will be deactivated. Businesses will not be able to create new broadcast lists. Existing broadcast lists will become read-only.	Not supported.
Voice and video calls	No change.	Not supported.
Business tools (for example: catalog, orders, status)	No change.	Not supported.
Messaging tools (for example: marketing messages, greeting messages, away messages, quick replies, labels)	No change.	Not supported.
Business profile (for example: business name, address, website)	No change.	Not supported.
Channels	No change.	Not supported.

Linked devices

Businesses can link up to 4 WhatsApp 'companion' clients to the WhatsApp Business app account on other devices (described in our Help Center as "Linked devices"). All companion clients are supported,WhatsApp for Windows and WhatsApp for Wear OS excluded. If a business onboards the Cloud API using an existing WhatsApp Business app account and phone number, all companion apps will be unlinked from that account, and the business can later relink any supported companion apps.

Message history not shared

If a business chooses not to share its message history with you, the system will trigger a history Webhook containing the error code 2593109 of history Webhook.

Report conversion events

Onboarded businesses can run Click-to-WhatsApp ads, so we recommend using the Conversion API to report purchase/lead signals on behalf of merchants. SeeConversion API for business messages.

Business client deregistration

If a business phone number is in use with both the Cloud API and the WhatsApp Business app, you cannot use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/deregister endpoint to deregister that business phone number from the Cloud API. Instead, your business client can unlink the Cloud API from the WhatsApp Business app by navigating to Settings > Account > Business Platform and then clicking the Unlink Account button. When a business client unlinks from the Cloud API, an account_update with a PARTNER_REMOVED event will be triggered. account_update Webhook.

Errors

If you onboard a business client using a WhatsApp Business app phone number, you may later receive a message Webhook with error code 131060 One reason this can happen is that a WhatsApp user sent or received messages to/from the business using an unsupportedcompanion deviceIf you receive this Webhook, prompt the business to check the messages in the WhatsApp Business app.

Chat history contents

If, when the solution provider requests the business chat history, the business has approved sharing the chat history, a series of history Webhooks will be triggered describing all messages sent or received within 180 days after the business onboarded to the Cloud API.

• Messages in group chats will not be included

• Media messages will not include media material IDs; however, other historical Webhooks containing media message material IDs will be sent separately, but only for media messages sent within 14 days after onboarding