O WhatsApp Coexistence (ou CoEx) é o modo de conexão oficial da Meta que permite usar o mesmo número de telefone ao mesmo tempo no aplicativo WhatsApp Business para celular e na API oficial conectada ao Agendor Chat ou ao WhatsApp Sync.
Isso resolve um problema comum de quem já usa o WhatsApp no dia a dia: não é preciso trocar de número nem perder o histórico de conversas para conectar seu WhatsApp a outra ferramenta.
Porém, durante esse processo de conexão, alguns erros aparecem com frequência e travam a etapa de cadastro do número.
Neste artigo, você vai ver:
O que é o WhatsApp CoEx e por que alguns erros acontecem
Os erros mais comuns durante a conexão e como resolver cada um
Outras limitações da Meta que podem afetar a conexão
Exemplos práticos de situações reais
Dúvidas frequentes
Por que esses erros acontecem?
A Meta é rigorosa com o processo de conexão do WhatsApp Coexistence porque o número continua ativo no aplicativo do celular ao mesmo tempo em que passa a operar pela API.
Para autorizar isso, ela verifica uma série de condições: histórico de uso do número, vínculos anteriores com outras contas, configurações automáticas ativas no aplicativo e limites do portfólio no Meta Business Manager.
Quando alguma dessas condições não é atendida, o fluxo de conexão exibe um erro ou trava sem aviso nenhum.
Os erros abaixo estão organizados do mais comum para o mais específico, com a causa e o passo a passo de resolução para cada um.
Erro: número não associado à empresa selecionada
Esse erro acontece quando o número informado está vinculado a outra conta do WhatsApp Business (WABA, ou WhatsApp Business Account) dentro do portfólio da Meta, e não à empresa que você selecionou no fluxo de conexão.
Causas mais comuns:
O número foi registrado em outra conta do Meta Business;
O número não foi adicionado ao portfólio empresarial correto;
Durante a conexão, o portfólio errado foi selecionado;
O número está associado a outro WABA.
Como resolver:
Opção 1: desconectar e reconectar o número
Clique no link "desconecte o número de telefone" que aparece na própria mensagem de erro;
Confirme a desconexão;
Volte ao fluxo de conexão e informe o número novamente.
Opção 2: verificar o portfólio no Meta Business Manager
Acesse business.facebook.com;
Vá em Configurações > Contas > Contas do WhatsApp;
Confirme se o número está vinculado à empresa correta.
Opção 3: usar outro número
Se o número pertence a outra empresa ou conta, informe um número diferente que já esteja associado corretamente ao seu portfólio.
Erro: limite de contas do WhatsApp atingido
A Meta permite um número limitado de WABAs (contas do WhatsApp Business) por Business Manager, e esse limite foi atingido no portfólio usado na conexão.
Como resolver:
Acesse business.facebook.com;
Vá em Configurações > Contas > Contas do WhatsApp;
Identifique alguma conta antiga ou que não está mais em uso;
Clique nos três pontinhos ao lado dela e selecione Excluir;
Volte ao fluxo de conexão e tente novamente.
⚠️ Importante: o limite de contas por portfólio varia de acordo com o nível de verificação e o histórico do Business Manager. A Meta não divulga esse número de forma fixa e pode alterá-lo a qualquer momento.
Erro: número não qualificado para o WhatsApp CoEx
Esse erro acontece quando o número não tem atividade suficiente no aplicativo WhatsApp Business para a Meta liberar o WhatsApp CoEx.
No CoEx, a exigência é maior do que em uma migração comum para a API, justamente porque o número continua ativo no aplicativo ao mesmo tempo em que passa a usar a API.
O que a Meta costuma exigir para liberar a conexão:
Uso ativo e recorrente do número no aplicativo WhatsApp Business, geralmente por pelo menos 7 dias, sendo mais seguro esperar de 30 a 60 dias;
Perfil da empresa completo no aplicativo;
Histórico de conversas reais com clientes;
Nenhum vínculo recente e mal encerrado com outra conta de API.
Como resolver:
Continue usando normalmente o WhatsApp Business com esse número;
Complete o perfil da empresa no aplicativo (nome, foto, categoria e descrição);
Mantenha conversas reais e ativas com clientes;
Evite excluir e recadastrar o número várias vezes, isso reinicia a contagem do histórico;
Depois de alguns dias de uso, tente a conexão novamente.
⚠️ Importante: a Meta não divulga um critério fixo de tempo mínimo de uso. Ela avalia o histórico do número de forma interna, então quanto mais consistente for o uso do aplicativo antes da tentativa de conexão, maiores as chances de aprovação.
Erro: número já registrado em outra conta do WhatsApp
Esse erro acontece quando o número ainda está ativo no WhatsApp ou no WhatsApp Business App do celular e precisa ser desconectado antes de ser usado na conexão.
Como resolver:
Abra o WhatsApp no celular com esse número;
Vá em Configurações > Conta > Excluir conta;
Confirme a exclusão;
Aguarde 3 minutos e tente a conexão novamente.
⚠️ Atenção: esse erro é diferente do número vinculado a outra empresa no Meta Business Manager (veja o primeiro erro deste artigo). Aqui, o número ainda está ativo no aplicativo do celular, não é uma questão de portfólio.
Se o número já foi usado com outra API antes: exclua primeiro a configuração antiga junto ao provedor anterior, recadastre o número no WhatsApp Business App e use-o ativamente por 1 a 2 meses antes de tentar o WhatsApp CoEx novamente. Tentar reconectar o número muito cedo depois de removê-lo de outro provedor costuma resultar em nova reprovação.
Erro: número vinculado a etiquetas automáticas
Esse erro ocorre quando o WhatsApp Business App tem etiquetas configuradas para funcionar automaticamente, e isso cria eventos que conflitam com o fluxo de conexão da API.
Como resolver:
Abra o WhatsApp Business App no celular;
Vá em Ferramentas para empresas;
Toque em Etiquetas;
Desative todas as etiquetas automáticas;
Volte ao fluxo de conexão e tente novamente.
Erro: número vinculado à IA da Meta
Esse erro acontece quando o número já tem a IA de respostas automáticas do WhatsApp Business ativada (este é um recurso nativo da própria Meta, diferente da IA do Agendor Chat). Ele pode ter sido ligado sem que você tenha percebido.
Como resolver:
Abra o WhatsApp Business App no celular, com o número em questão;
Vá em Ferramentas para empresas;
Toque em Sua Business AI;
Entre em Respostas da IA;
Toque em Desconectar IA.
Erro: fluxo reduz etapas sozinho e trava na inserção do número
Nesse caso, não aparece nenhuma mensagem de erro. Durante a conexão, a quantidade de etapas diminui automaticamente e, ao chegar na etapa de inserção do número, o botão Avançar não responde.
Causas possíveis:
Aplicativo de terceiros conectado ao Meta Business: algum aplicativo externo está vinculado ao Meta Business da empresa e impede a conclusão da associação do número ao Agendor Chat.
Parceiro vinculado ao número no portfólio: se a opção acima não resolver, verifique se o número tem apenas um parceiro vinculado no portfólio do Meta Business Manager. Nesse caso, basta remover o parceiro e aguardar alguns minutos antes de tentar novamente.
Como resolver:
Opção 1: remover aplicativos de terceiros
Acesse business.facebook.com;
Vá em Configurações > Contas > Apps;
Verifique se existe algum aplicativo de terceiros vinculado ao negócio;
Caso exista, remova o aplicativo e tente a conexão com o Agendor Chat novamente.
⚠️ Atenção: só remova o aplicativo se tiver certeza de que ele não está sendo usado por outra integração. Removê-lo pode interromper o funcionamento de outros sistemas conectados ao WhatsApp ou ao Business Manager.
Opção 2: remover parceiro vinculado
Acesse business.facebook.com;
Vá em Configurações > Contas > Contas do WhatsApp;
Ao clicar no número, vá para a aba Parceiros e veja se existe algum parceiro vinculado;
Caso exista, clique no botão Gerenciar para remover o parceiro e tente a conexão com o Agendor Chat novamente.
Outras limitações da Meta que podem afetar a conexão
Além dos erros acima, existem outras restrições da Meta, comuns a qualquer conexão via WhatsApp CoEx (não específicas do Agendor Chat), que também podem impedir ou dificultar o processo:
País não suportado: o WhatsApp CoEx não está disponível em algumas regiões específicas. Números de países como o Brasil, porém, costumam ser aceitos.
QR Code inválido ou tela retorna à etapa anterior: costuma acontecer por verificação em duas etapas ativada no número, instabilidade de internet ou aplicativo do WhatsApp Business desatualizado. Mantenha o aplicativo aberto e atualizado durante todo o processo de leitura do QR Code.
Sincronização de conversas lenta ou incompleta: o histórico de conversas pode levar algumas horas para sincronizar. Mantenha o celular desbloqueado e o WhatsApp Business App aberto durante esse período, e evite fechar o aplicativo no meio do processo.
Limite de contas de anúncio atingido: mesmo parecendo um erro de anúncios, essa mensagem pode bloquear a criação automática dos recursos necessários para ativar o WhatsApp CoEx. Vale verificar as contas de anúncio no Meta Business Manager e remover as que não estão em uso.
Dispositivos não suportados: mensagens enviadas por aplicativos como WhatsApp para Windows ou por relógios inteligentes não sincronizam com a API. Use WhatsApp Web ou WhatsApp para Mac como dispositivos vinculados.
Nome da empresa bloqueado após a conexão: depois que o WhatsApp CoEx é ativado, a Meta trava alterações no nome da empresa para manter consistência entre o aplicativo e a API. Confirme o nome antes de iniciar a conexão.
Dúvidas frequentes
Perder o histórico de conversas é um risco real durante a conexão
Perder o histórico de conversas é um risco real durante a conexão
Não, esse é justamente o objetivo do WhatsApp CoEx: manter o número ativo no aplicativo e sincronizar o histórico de conversas com a API, sem precisar trocar de número.
Quem pode reconectar ou desconectar um número no Agendor Chat?
Quem pode reconectar ou desconectar um número no Agendor Chat?
Em geral, essa ação fica disponível para o Administrador da conta no Agendor Chat. Se você não encontrar a opção, verifique seu perfil de acesso com quem administra a conta.
Um erro pode ter mais de uma causa ao mesmo tempo?
Um erro pode ter mais de uma causa ao mesmo tempo?
Sim. É comum que um número esteja, por exemplo, com pouco histórico de uso e, ao mesmo tempo, com etiquetas automáticas ativadas. Se o problema persistir depois de resolver a primeira causa identificada, revise as demais possibilidades listadas neste artigo.
Excluir e recadastrar o número várias vezes ajuda a resolver o erro mais rápido?
Excluir e recadastrar o número várias vezes ajuda a resolver o erro mais rápido?
Não. Excluir e recadastrar o número repetidamente reinicia a contagem de histórico de uso no WhatsApp Business App, o que costuma atrasar ainda mais a liberação do WhatsApp CoEx.
O que fazer se nenhuma das soluções acima resolver o erro?
O que fazer se nenhuma das soluções acima resolver o erro?
Reúna o número afetado, a mensagem de erro exibida (ou uma captura de tela, se o fluxo travar sem mensagem) e entre em contato com o suporte do Agendor para uma análise mais detalhada.
Ficou com alguma dúvida? Estamos à disposição em nossos canais de atendimento! 🙋♀️