WhatsApp Business App Authorization Binding
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
Open the app icon below, open the camera in the app's top right corner, and scan the QR code above
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.
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 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
Last updated