Keep your number on the WhatsApp Business app (coexistence)
Connect with Meta keeps your WhatsApp Business app number on your phone and brings the same chats into Venom: what Meta changes in the app first, what you do on the phone, the 24-hour history and contacts sync, messages you send from the phone, and how to disconnect.
If your business number is on the WhatsApp Business app, Connect with Meta keeps it there and brings the same one-to-one chats into Venom's Support inbox. You keep answering on the phone when you like, and answer from Venom (or let agents draft) the rest of the time. Meta calls this coexistence.
Connect with Meta exists when your deployment's operator set up Venom's Meta app (operator's guide). Otherwise, connect with your own Meta app (WhatsApp through Meta's Cloud API), which moves the number to the Cloud API only.
Everything quoted below is from Meta's page "Onboard WhatsApp Business app users" (developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users), as read on 2026-11-19.
Before you start: what Meta changes
Venom shows this on the Connect with Meta page before anything from Meta loads:
- App version: "The business customer must use WhatsApp Business app version 2.24.17 or higher."
- Linked devices: "all companion apps will be unlinked from the account, and the business can then re-link any supported companion apps." "All companion clients are supported, except for WhatsApp for Windows and WhatsApp for WearOS."
- What stops working in the app, for one-to-one chats: disappearing messages ("will be turned off"), view once ("will be disabled"), live location ("will be disabled"); broadcast lists "will be disabled. Business will not be able to create new Broadcast lists. Existing Broadcast lists will become read-only." Editing and revoking sent messages becomes supported.
- What is not supported on the Cloud API, so it never reaches Venom: group chats ("Group chats will not be synchronized"), voice and video calls, business tools (catalog, orders, status), messaging tools (marketing messages, greeting, away messages, quick replies, labels), the business profile and Channels. Meta's table says "No change" in the app for these: they keep working on the phone, they are just not mirrored to the API.
- Throughput: "a fixed throughput of 20 mps" for the API.
- Cost: "messages sent by the business via the WhatsApp Business app will continue to be free, but messages sent via Cloud API will be subject to Cloud API pricing." Messages from the app "do not create, extend, or affect Cloud API conversation windows."
Meta's page lists no countries; its errors page has "This feature is unavailable for phone numbers from this region"
(3441042) and "This number isn't eligible yet" (3441077).
Connecting
- Settings, Comms, WhatsApp, Connect with Meta. Read the list, tick I have read this, and keep Open conversations in Support on.
- Load Meta's sign-in. Only now does your browser load Meta's script (from connect.facebook.net) and talk to facebook.com.
- Open Meta's signup: Meta's window opens. Sign in to Facebook, pick your business portfolio, and choose your existing WhatsApp Business app number.
- On your phone, with the WhatsApp Business app open, Meta's page describes what happens:
- "WhatsApp presents a verification code to enter."
- "Expect to receive a message from the official Facebook Business Account. Tap Connect"
- "Tap the Connect to the Business Platform button"
- "Tap the Confirm button in the app to give the business the option to share their chat history with you."
- "Paste the verification code." (into Meta's window) There is no QR code in this flow.
- Press Finish in Meta's window. Meta hands the code over only on Finish; closing the window on the last screen connects nothing in Venom.
Venom then exchanges the code for a token on the server, checks that the account and number really belong to what you signed in to, skips registration (Meta: the number "is already registered"), points the account's webhooks at Venom, reads your templates, routes the number to Support, and turns it on.
The 24-hour sync
Meta: "you have 24 hours to synchronize their contacts and messaging history, otherwise they must be offboarded and complete the flow again." Each sync "can only" be done once.
Venom asks for both at once, right after connecting: your contacts, then up to six months of one-to-one chats
(POST /{phone-number-id}/smb_app_data). The WhatsApp card in Settings, Comms shows the deadline, the history's
progress (Meta sends it in chunks, out of order), how many messages and contacts arrived, and, if asking failed, a button
to ask again before the deadline. Keep the app open on your phone until the history has arrived ("advise them to
keep the WhatsApp Business app open").
- History lands in each customer's Support conversation at the time each message was sent: your messages as sent by
"WhatsApp Business app", theirs as received. A customer with no conversation gets one, closed and tagged
history. - Nobody is notified, no SLA starts, no automation or webhook hears it, and nothing is sent.
- A message from three months ago does not open WhatsApp's 24-hour window; one from an hour ago does.
- Files: Meta sends a file "only for media messages sent within 14 days of onboarding", later, by media id; older ones show as a note.
- If you chose not to share your history, the card says so; new messages still arrive.
Contacts
The contacts Meta syncs stay in Comms until you decide. The card shows how many there are; Preview the import shows the count, how many have a number, how many People already has, and a few names. Import into People adds them as your own people (private, or shared with the organisation if your role may share); a contact whose number is already on a person you can see is linked, not copied; a second import changes nothing.
Messages you send from the phone
What you send from the WhatsApp Business app arrives as an echo (smb_message_echoes) and shows in the Support thread as
sent by "WhatsApp Business app". An echo never starts an automation, a bot or an agent, and is never sent again.
Disconnecting
Meta: "You cannot use the Deregister API to deregister a business phone number from Cloud API if it is already in use
with both Cloud API and the WhatsApp Business app." Only you can end it, in the app: Settings, Account, Business
Platform, Disconnect Account. Meta then tells Venom (PARTNER_REMOVED), and Venom turns the number off and says so on
the card.
Removing the number in Venom unsubscribes Venom from the account at Meta (no more webhooks) and tells you the steps above for the number itself.
If Meta suspends the number (a phone change or re-registration: ACCOUNT_OFFBOARDED), the card says so; when the business
onboards to Venom's app again, Meta sends ACCOUNT_RECONNECTED and the card shows it connected.