Coexistência no WhatsApp: app e API oficial no mesmo número
Como manter o mesmo número no aplicativo WhatsApp Business e na API oficial ao mesmo tempo: requisitos, o que deixa de funcionar e os erros mais comuns.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
Coexistência é o recurso da Meta que deixa o mesmo número funcionar no aplicativo WhatsApp Business e na API oficial ao mesmo tempo. Na prática, acaba com a escolha que travava toda migração: até ela existir, conectar um número à API significava perder o aplicativo, o histórico e a rotina de quem já atendia por ali. Hoje os dois rodam juntos — com algumas perdas que ninguém conta antes.
Adicione ao Google NotíciasNeste artigo
O que é e como funciona na prática
Com a coexistência ativa, o telefone continua com o aplicativo WhatsApp Business instalado e funcionando normalmente. Quem atende pelo celular segue atendendo. Ao mesmo tempo, o número responde pela API, e o sistema da empresa passa a ver tudo que acontece.
O detalhe que faz a diferença: mensagens enviadas pelo aplicativo aparecem na API como echo messages — cópias do que saiu pelo celular. É isso que mantém a caixa de entrada do software e o aplicativo olhando para a mesma conversa, sem que uma metade do atendimento fique invisível para a outra.
O ganho real não é técnico, é comercial: você migra para a API sem avisar cliente de número novo, sem imprimir material novo e sem perder a conversa que já estava em andamento.
Quem pode usar
Aqui está a primeira surpresa, e ela elimina a maior parte das tentativas: coexistência só existe através de um Tech Provider. Não é um botão no painel da Meta nem algo que você ativa sozinho. É preciso que a empresa que conecta o seu número seja aprovada pela Meta nesse papel — e nem todo fornecedor é.
A lista completa de requisitos:
- A conexão precisa ser feita por um Tech Provider aprovado.
- O aplicativo WhatsApp Business no celular precisa estar na versão 2.24.17 ou mais recente.
- A conta precisa ter cerca de sete dias de atividade e qualidade aceitável — a Meta revisa antes de liberar.
- O número precisa estar no Gerenciador de Negócios da Meta.
- Depois de conectado, alguém precisa abrir o aplicativo a cada duas semanas, mais ou menos, senão a conexão cai.
A coexistência não está disponível em todos os países. Há relatos consistentes de indisponibilidade na União Europeia e no Reino Unido, além de mercados como Índia, Japão, Austrália, Nigéria, Filipinas, Rússia, Coreia do Sul, África do Sul e Turquia. O Brasil está entre os mercados atendidos, mas confirme a lista antes de prometer o recurso a um cliente com operação fora daqui.
O histórico vem junto — com limite
Na hora de conectar, o cliente escaneia um QR code no celular e escolhe se quer compartilhar o histórico. Optando por sim, a sincronização traz até seis meses de conversas e a lista de contatos para dentro da plataforma.
Duas ressalvas que evitam ligação de cliente nervoso. A primeira: a sincronização pode levar até 24 horas para terminar. Se logo depois de conectar a caixa de entrada parece vazia, é normal — está carregando. A segunda: esse recurso é da Meta, mas depende de o fornecedor ter implementado. Nem todo Tech Provider traz o histórico, mesmo oferecendo coexistência.
O que deixa de funcionar
Esta é a parte que raramente aparece em material de venda. Um número em coexistência perde recursos do aplicativo comum:
| Recurso | Situação com coexistência |
|---|---|
| Listas de transmissão | Não cria novas; as que existem ficam só para leitura |
| Editar ou apagar mensagem já enviada | Não funciona nas conversas individuais |
| Mensagens temporárias e Ver uma vez | Desativadas |
| Localização em tempo real | Desativada |
| Grupos | Não suportados pelo número em coexistência |
| Chamadas de voz e vídeo | Não suportadas |
| Status | Não suportado |
| Velocidade de envio | Teto de cerca de 20 mensagens por segundo |
Para quem atende venda, suporte e pedido, nada disso costuma fazer falta. Para quem usava grupo de clientes ou lista de transmissão como canal principal, a perda é real e precisa entrar na conta antes de migrar.
Como ativar, passo a passo
- Confirme que o seu fornecedor é Tech Provider e que ele oferece coexistência. É a pergunta que define se o resto é possível. Fornecedor que só revende acesso não consegue entregar o recurso.
- Atualize o aplicativo WhatsApp Business no celular que usa o número.
- Coloque o número no Gerenciador de Negócios, dentro do portfólio empresarial da empresa.
- Inicie a conexão pelo painel do fornecedor. Abre uma janela da Meta, onde você entra com o Facebook e escolhe o portfólio e a conta do WhatsApp.
- Escaneie o QR code com o celular que tem o número e escolha se quer trazer o histórico.
- Espere a sincronização. Pode levar minutos ou até um dia. Enquanto roda, evite desinstalar o aplicativo ou trocar o chip de aparelho.
Os erros que travam a ativação
Três problemas respondem por quase todas as tentativas frustradas. Vale conhecer antes de abrir chamado.
A tela de coexistência não aparece — só "Insira um novo número"
É o mais comum, e quase sempre dá o código #2494064. Tem duas causas distintas.
A primeira é de configuração do lado de quem conecta: se a configuração de login criada no painel da Meta incluiu o produto de mensagens de marketing, a plataforma ignora o pedido de coexistência e pula direto para o cadastro de número novo. O produto não pode ser trocado depois — é preciso criar uma configuração nova, apenas com a API do WhatsApp. Isso é tarefa do fornecedor, não sua.
A segunda é de permissão, e essa é sua: o Facebook usado no momento da conexão precisa ser administrador do portfólio empresarial ao qual aquele WhatsApp está ligado. Ser administrador apenas da Página não basta. Com o Facebook certo, a mesma configuração que falhava passa a mostrar a tela de coexistência.
"Error while pairing Cloud API" depois do QR code
Aparece quando o pareamento começa mas não conclui. As causas conhecidas são sincronização que ainda está em curso — esperar alguns minutos e repetir costuma resolver —, aplicativo desatualizado, região sem suporte ao recurso, conflito com a verificação em duas etapas do número, ou fornecedor sem o status de Tech Provider.
A conexão cai sozinha depois de semanas
Normalmente é o celular esquecido numa gaveta. O vínculo exige que alguém abra o aplicativo de tempos em tempos, na casa de duas semanas. Operação que conectou o número de um aparelho reserva e nunca mais tocou nele costuma descobrir isso da pior forma.
Quem já usava coexistência em integrações antigas precisa de atenção redobrada: o identificador técnico do recurso mudou de nome e as versões antigas do fluxo de conexão da Meta foram desativadas em 15 de outubro de 2026. Integração que não foi atualizada simplesmente para de oferecer a opção.
Coexistência ou migração completa?
Nem sempre coexistir é o melhor caminho. A régua:
- Vale coexistir quando o número já é conhecido pelos clientes, quando parte do time vai continuar atendendo pelo celular e quando você quer testar a automação sem virar a chave de uma vez.
- Vale migrar de vez quando ninguém mais vai atender pelo aparelho, quando a operação precisa de velocidade acima do teto de coexistência ou quando grupos e listas de transmissão fazem parte do processo e você prefere mantê-los em outro número.
Com o número conectado, o aplicativo abrindo normalmente e as conversas aparecendo nos dois lugares, a coexistência está funcionando — e você pode ligar a automação aos poucos, sem parar o atendimento.
Perguntas frequentes
O que é coexistência no WhatsApp?
É o recurso que permite usar o mesmo número no aplicativo WhatsApp Business e na API oficial ao mesmo tempo. O atendimento pelo celular continua, e o sistema da empresa enxerga as mesmas conversas, incluindo as mensagens enviadas pelo aparelho.
Como configurar a coexistência?
A ativação parte do painel de um fornecedor que seja Tech Provider: você entra com o Facebook administrador do portfólio empresarial, escolhe a conta do WhatsApp e escaneia um QR code no celular que tem o número. O histórico vem junto se você autorizar.
Preciso pagar a mais pela coexistência?
A Meta não cobra pelo recurso. O que se paga continua sendo a mensagem, pela tabela normal da API, mais o que o fornecedor cobrar pela plataforma dele.
Perco o histórico de conversas ao ativar?
Não. Na conexão você escolhe compartilhar o histórico, e a sincronização traz até seis meses de conversas e os contatos. O aplicativo no celular mantém tudo o que já tinha.
Qualquer plataforma oferece coexistência?
Não. Só empresas aprovadas pela Meta como Tech Provider conseguem entregar o recurso, e mesmo entre elas nem todas implementaram a sincronização de histórico. É a primeira pergunta a fazer antes de fechar contrato.
Dá para voltar atrás depois de ativar?
Dá — o número pode ser desconectado da API e seguir só no aplicativo. O que não volta automaticamente são os recursos que ficam indisponíveis enquanto a coexistência está ativa, como grupos e listas de transmissão novas.
Este tutorial faz parte do guia API oficial do WhatsApp: o que é, quanto custa e como ter. Veja também: Quanto custa a API oficial do WhatsApp: o preço por mensagem · API oficial da Meta ou solução não oficial: qual usar no WhatsApp da empresa · WhatsApp Cloud API: o que é e como começar sem servidor · Como contratar e ativar a API oficial do WhatsApp passo a passo · Disparo em massa no WhatsApp: o que a API oficial permite e o que derruba a conta · Meta Tech Provider: o que é e como se tornar um
