WhatsApp coexistence lets you connect a number that already uses the WhatsApp Business app to ConverZap without removing it from the phone: the number works on the app and on the official API at the same time. The connection runs through Meta’s Embedded Signup, using the “Número que já usa o app WhatsApp Business” (Number that already uses the WhatsApp Business app) button. Midway through the flow, Meta itself displays a QR code that you scan with the WhatsApp Business app on the phone. This QR code is part of Meta’s official process for the WhatsApp API; it has nothing to do with unofficial API connections or WhatsApp Web.
When to use WhatsApp coexistence
The new number flow rejects numbers that are already active on a WhatsApp app. Coexistence solves this for businesses that want to keep handling customers on the phone while also using official API features in ConverZap, such as templates, bulk messaging, the team inbox and AI agents.
Requirements
- The number must be on the WhatsApp Business app. Coexistence does not work with regular WhatsApp: in that case, move the number to the WhatsApp Business app first, or delete the account on the phone and use the “Número novo” (New number) flow.
- Admin access to the ConverZap workspace.
- A Facebook account that manages the business on Meta, to pick or create the business portfolio and the WhatsApp Business account.
- The phone with the WhatsApp Business app at hand, to scan the QR code.
- The number must not be connected to another ConverZap workspace.
Step by step
- In the side menu, click “Configurações” (Settings) and then “Integrações” (Integrations), or open “Saúde do WhatsApp” (WhatsApp Health) if no number is connected yet.
- In the “Conectar WhatsApp com o Facebook” (Connect WhatsApp with Facebook) panel, click “Número que já usa o app WhatsApp Business”.
- In Meta’s window, log in with the Facebook account that manages the business and pick or create the business portfolio and the WhatsApp Business account.
- When Meta shows the QR code, open the WhatsApp Business app on the number’s phone and scan the code, following the instructions on Meta’s screen.
- Complete the remaining steps in Meta’s window. ConverZap shows “WhatsApp conectado” (WhatsApp connected) with the number.
- Add the business’s payment method in Meta’s WhatsApp Manager. Without it, Meta won’t send messages through the API.
With coexistence, ConverZap does not register the number on the API again, because it is already active on the app. Instead, right after the connection, ConverZap asks Meta to sync the app’s contacts and history.
Contact and history sync
Meta only accepts the sync request within the first 24 hours after the connection. If Meta doesn’t start the sync, ConverZap shows a warning on the connection screen (“A Meta não iniciou a sincronização…”, meaning Meta didn’t start the sync), and the number’s connection remains valid. Currently, contacts and history synced from the app are not yet imported into the ConverZap inbox.
Current limitations
- Messages sent from the WhatsApp Business app on the phone do not appear in the ConverZap inbox (“Conversas”, Conversations). Incoming messages and messages sent from ConverZap appear normally.
- The app’s chat history and contacts are not brought into ConverZap.
- Coexistence only works with the WhatsApp Business app; regular WhatsApp is not supported.
Tip: if an AI agent handles a number in coexistence, avoid replying to the same conversation from the phone. Since replies sent from the app don’t reach ConverZap, the agent can’t see them and isn’t paused by them. To take over a conversation, use the “Assumir do agente” (Take over from agent) button in the inbox.