Coexistência do WhatsApp: usar o app e a API oficial no mesmo número
A coexistência permite que o mesmo número use o aplicativo WhatsApp Business e a Cloud API ao mesmo tempo. A Meta sincroniza até 180 dias de conversas individuais, o número passa a ter vazão fixa de 20 mensagens por segundo e alguns recursos do app são desativados — entre eles grupos, chamadas e listas de transmissão.
Atualizado em
Durante anos, conectar um número à API oficial do WhatsApp foi uma decisão sem volta. O número saía do aplicativo WhatsApp Business, o histórico ficava para trás e quem estava acostumado a responder pelo celular precisava aprender outra ferramenta. Muita empresa preferiu não mexer.
A coexistência resolve exatamente esse impasse. É o recurso oficial da Meta que permite ao mesmo número operar no aplicativo e na Cloud API ao mesmo tempo.
O que muda na prática
Sem coexistência, você escolhe um dos dois mundos. Com ela, o número vive nos dois:
- O dono do número continua respondendo pelo celular, como sempre fez.
- A equipe atende pela plataforma, com fila, atribuição e histórico compartilhado.
- As automações rodam pela API, disparando mensagens e formulários.
- Tudo isso no mesmo número que os clientes já têm salvo.
O que sincroniza — e o que não sincroniza
No momento do onboarding, a Meta sincroniza as mensagens individuais enviadas ou recebidas nos 180 dias anteriores. Daí em diante, as mensagens continuam sincronizando nos dois sentidos.
Nem tudo atravessa:
| Sincroniza | Não sincroniza |
|---|---|
| Conversas individuais (1:1) | Conversas em grupo |
| Mensagens dos últimos 180 dias | Mensagens mais antigas que isso |
| Mídia das mensagens dos últimos 14 dias | Mídia de mensagens anteriores a 14 dias |
Esse detalhe da mídia costuma passar despercebido. As mensagens antigas aparecem, mas os anexos com mais de duas semanas vêm sem o arquivo — o texto está lá, a foto não.
Os recursos que você perde
Esta é a parte que raramente aparece nos materiais comerciais. Depois do onboarding em coexistência, o aplicativo perde funcionalidades:
- Mensagens temporárias
- Mensagens de visualização única
- Localização em tempo real
- Listas de transmissão — as existentes ficam somente leitura
- Grupos
- Chamadas de voz e vídeo
- Ferramentas comerciais
- Canais
Para uma operação de atendimento e vendas, quase nada disso faz falta. Mas se o número é usado para coordenar um grupo de clientes ou receber ligações, a conta muda. Vale conferir a lista antes, não depois.
O limite de vazão
Números em coexistência têm vazão fixa de 20 mensagens por segundo. A Meta define esse teto para manter a compatibilidade com o aplicativo, e ele não é ajustável.
Aqui cabe um alerta: boa parte do conteúdo em português sobre coexistência cita 5 mensagens por segundo. A documentação da Meta diz 20. Se esse número é decisivo para o seu caso, confira na fonte oficial antes de dimensionar qualquer coisa.
Para contexto: 20 mensagens por segundo são 1.200 por minuto. Para atendimento, é folgado. Para disparo em massa de grande volume, é o fator limitante — e nesse caso um número dedicado só à API faz mais sentido.
Quando esse teto é atingido, a API devolve o erro 130429.
Como fica a cobrança
A regra é simples e separa por origem:
- Mensagens enviadas pelo aplicativo continuam gratuitas.
- Mensagens enviadas pela Cloud API entram na tabela de preços da Cloud API.
Ou seja, o atendimento manual do dono no celular não gera custo de conversa. O que passa pela plataforma segue as regras normais de cobrança do WhatsApp.
Requisitos
Antes de tentar o onboarding:
- O aplicativo WhatsApp Business precisa estar na versão 2.24.17 ou superior.
- O número precisa estar ativo no aplicativo — não pode já ter sido migrado para a API.
- A conexão é feita pelo Embedded Signup, o fluxo de autorização da própria Meta, dentro da plataforma que você contratou.
Coexistência ou migração tradicional?
Não existe resposta única. O critério prático:
Coexistência faz sentido quando o número já é conhecido pelos clientes, o histórico importa, o dono quer continuar atendendo pelo celular e o volume de disparo é moderado.
Migração tradicional faz sentido quando o volume de envio é alto e 20 mensagens por segundo limitariam a operação, ou quando o número é novo e não existe histórico nem hábito a preservar.
Para a maioria das pequenas e médias empresas brasileiras, que vendem pelo WhatsApp há anos no mesmo número, a coexistência elimina a principal objeção à API oficial: a de que profissionalizar o atendimento custaria o histórico e o número que o cliente já tem salvo.
Perguntas frequentes
O bloco de perguntas ao final desta página responde as dúvidas mais comuns. Se a sua não estiver lá, o glossário cobre os termos técnicos citados aqui — WABA, BSP e coexistência.
Perguntas frequentes
- Coexistência e migração para a API são a mesma coisa?
- Não. Na migração tradicional o número deixa o aplicativo WhatsApp Business e passa a existir apenas pela API. Na coexistência ele permanece nos dois ambientes ao mesmo tempo, com o histórico sincronizado entre eles.
- Quanto do histórico é sincronizado na coexistência?
- As mensagens individuais enviadas ou recebidas nos 180 dias anteriores ao onboarding. Conversas em grupo ficam de fora, e mensagens com mais de 14 dias sincronizam sem o arquivo de mídia anexado.
- Continuo pagando pelas mensagens enviadas pelo celular?
- Não. Mensagens enviadas pelo aplicativo WhatsApp Business seguem gratuitas. Apenas as enviadas pela Cloud API entram na tabela de preços da Cloud API.