Coexistência no WhatsApp: o app e a API no mesmo número
O número que já está no aplicativo WhatsApp Business do seu cliente pode ser autorizado na API oficial e continuar funcionando no celular dele, ao mesmo tempo. Sem QR code, sem trocar de número, sem perder o histórico.
O que é
Coexistência é o nome que a Meta dá ao onboarding de um número que já roda no aplicativo WhatsApp Business. Em vez de dedicar o número à API — o que o tira do celular — a autorização acontece por cima do que já existe. Depois dela, o mesmo número atende pelos dois lados.
| Conexão dedicada | Coexistência | |
|---|---|---|
| O número continua no app do celular | Não | Sim |
| Histórico de conversas | Não migra | Permanece no aparelho |
| Atendimento manual pelo aplicativo | Deixa de existir | Continua |
| Precisa trocar de número | Muitas vezes sim | Não |
| QR code | Não | Não |
Por que isso decide a venda
Para quem opera números de clientes, a objeção que mata a migração para a API oficial quase nunca é preço. É esta: o meu cliente vai perder o WhatsApp dele.
E a objeção é legítima. Numa conexão dedicada, o dono do negócio perde o aplicativo no celular, perde o histórico visível e perde a capacidade de responder um cliente pelo telefone enquanto está na rua. Nenhum ganho de automação compensa isso para uma boa parte das empresas. A coexistência remove a objeção em vez de argumentar contra ela.
Como funciona na prática
- Você gera um link de conexão e envia ao cliente.
- Ele abre o link e percorre o Embedded Signup da Meta, autorizando na conta comercial dele.
- Ele escolhe o número que já usa e confirma no celular.
- Você recebe a chave e o webhook. O número segue no aplicativo dele, e as mensagens começam a chegar no seu sistema.
O passo a passo completo, com o que a Meta exige antes, está em como conectar um número.
Os limites que você precisa saber antes
Coexistência não é a conexão dedicada com um bônus. Ela tem restrições próprias, e descobri-las depois de vender é pior do que lê-las agora.
- O aplicativo precisa continuar instalado e ser aberto periodicamente. Desinstalar o WhatsApp Business do aparelho desconecta a conta. Provedores documentam uma janela de duas semanas para abrir o app ao menos uma vez — com números que variam entre 13 e 14 dias na documentação de cada um.
- Selo de conta comercial oficial não é suportado. O selo azul (Official Business Account) não se aplica a números em coexistência.
- A verificação de negócio padrão não se aplica. O caminho de verificação é outro, conduzido pelo parceiro ou pelo Meta Verified.
- O número não migra entre contas WhatsApp Business. Um número em coexistência fica na WABA em que foi autorizado.
- A taxa de envio é menor do que a de uma conexão dedicada, e a documentação de provedores fala em torno de vinte mensagens por segundo. Para disparo em massa, a conexão dedicada continua sendo o caminho.
Quando não usar coexistência
Se o cliente quer um número exclusivamente automatizado, sem ninguém respondendo pelo celular, a conexão dedicada é mais simples e tem taxa de envio maior. Coexistência existe para o caso em que uma pessoa continua atendendo pelo aparelho — que, no Brasil, é a maior parte dos casos.
Perguntas frequentes
O que é coexistência no WhatsApp?
É o recurso oficial da Meta que autoriza na Cloud API um número que já está em uso no aplicativo WhatsApp Business. Depois de autorizado, o mesmo número responde pelos dois caminhos ao mesmo tempo: continua no celular, com o histórico e o atendimento manual de sempre, e passa a enviar e receber pela API.
O cliente perde o histórico de conversas?
Não. As conversas permanecem no aplicativo, no aparelho dele. O que chega e o que sai por lá é espelhado para o seu sistema como evento, então o seu lado enxerga a conversa inteira sem que o cliente perca nada.
Precisa ler QR code?
Não. QR code é como as integrações não oficiais abrem uma sessão do WhatsApp Web, e é por isso que elas caem e precisam ser relidas. A coexistência autoriza o número pela conta Meta da empresa, uma vez, pelo Embedded Signup — não existe sessão de navegador para manter viva.
O cliente precisa trocar de número?
Não. É exatamente esse o ponto da coexistência. Na conexão dedicada, o número sai do aplicativo e passa a existir só na API; na coexistência, ele fica nos dois.
Dá para migrar de uma API não oficial usando coexistência?
Sim, e é o caminho mais comum. O número sai da integração não oficial e é autorizado na Cloud API pelo Embedded Signup, continuando no aplicativo WhatsApp Business do cliente. Ele não troca de número e não perde o histórico.
Coexistência é exclusividade do CRPRO Hub?
Não. É um recurso da plataforma da Meta, e outros provedores oficiais também o suportam. O que nenhuma integração não oficial consegue fazer é coexistência — elas dependem de sessão do WhatsApp Web, que é o oposto do mecanismo.