O CoEx (Coexistência) é o modo de conexão oficial da Meta que permite usar o mesmo número ao mesmo tempo no app WhatsApp Business do celular e conectado ao Agendor, seja no Agendor Chat ou no WhatsApp Sync.
É o que permite conectar seu WhatsApp ao Agendor sem trocar de número e sem perder o histórico de conversas, você continua usando o aplicativo do WhatsApp normalmente no celular.
Durante esse processo de conexão, alguns erros podem ocorrer.
Neste artigo, você vai ver:
Os erros mais comuns durante a conexão, possíveis causas e como resolver
Limitações da Meta que podem afetar a conexão
Dúvidas frequentes
Por que esses erros acontecem?
A Meta é rigorosa com essa conexão porque o número continua ativo no app do celular ao mesmo tempo em que passa a ser operado 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 seu Portfólio Empresarial. Quando alguma dessas condições não é atendida, o fluxo exibe um erro.
Como essas condições são avaliadas pela Meta, a solução quase sempre está no app do WhatsApp Business ou no Portfólio Empresarial da sua empresa e não em uma configuração do Agendor. Abaixo, cada erro com a causa e o passo a passo para resolver.
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) dentro do Portfólio Empresarial, e não à empresa que você selecionou no fluxo de conexão.
Causas possíveis:
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 ao Parceiro correto, o Agendor.
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 Contas do WhatsApp Business (WABAs) por Portfólio Empresarial, 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.
⚠️ Cuidado ao excluir. Só exclua contas que você tem certeza de que não estão em uso. Excluir uma conta que ainda tenha um número ativo desconecta esse número e interrompe as integrações ligadas a ele. Na dúvida, confirme com quem administra o portfólio antes.
⚠️ Importante: o limite de contas por portfólio varia conforme o nível de verificação e o histórico do portfólio. 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 app WhatsApp Business para a Meta liberar o 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.
Causas possíveis:
Uso recente do número no aplicativo WhatsApp Business, sem tempo suficiente de atividade (a Meta costuma exigir pelo menos 7 dias, sendo mais seguro esperar de 30 a 60 dias);
Perfil da empresa incompleto no aplicativo (sem nome, foto, categoria ou descrição);
Pouco ou nenhum histórico de conversas reais com clientes;
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 internamente, então quanto mais consistente for o uso do aplicativo antes da tentativa, maiores as chances de aprovaçã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, a Meta Business Agent, este é um recurso nativo da própria Meta. 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.
Causa possível:
Parceiro vinculado ao número no portfólio: 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:
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 novamente.
Erro: HTTP 500 no popup do Embedded Signup/Coexistência
A tela de conexão (Embedded Signup/Coexistência) é 100% renderizada pela Meta. Esse erro tem duas causas possíveis, vale checar as duas antes de descartar como só instabilidade passageira.
Causas possíveis:
Instabilidade momentânea na infraestrutura da Meta (causa mais comum): o erro aparece de forma esporádica e some ao tentar novamente em outro momento ou navegador.
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: tente novamente
Feche e reabra o popup do Embedded Signup/Coexistência;
Teste em aba anônima ou outro navegador;
Confirme que o número digitado está correto e tente a conexão novamente em alguns minutos.
⚠️ Atenção: se o erro persistir mesmo depois de repetir esses passos em horários e navegadores diferentes, não é instabilidade passageira. Siga para a Opção 2.
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 novamente.
Erro: Restrição de acesso a anúncios bloqueia a conexão
Se a conta da empresa na Meta tem uma restrição ou pendência de publicidade, a Meta bloqueia a criação dos recursos necessários para a conexão (mesmo sem envolver anúncios de fato). Essa restrição é aplicada pela própria Meta e não pode ser removida pelo Agendor
Causas possíveis:
Conta de anúncios desabilitada anteriormente: histórico de desativação por parte da Meta em alguma conta de anúncios ligada ao mesmo Business Manager ou perfil.
Detecção automática de risco pela Meta: sistemas de revisão automatizados da Meta podem restringir o acesso preventivamente sem uma violação explícita, por padrões que a Meta considera suspeitos.
Como resolver:
Opção 1: revisar a restrição na conta
Acesse business.facebook.com;
Vá em Configurações > Qualidade da conta;
Verifique o motivo da restrição e siga o processo de revisão indicado pela Meta;
Depois que a restrição for retirada, tente a conexão novamente.
Opção 2: usar outro portfólio empresarial
Verifique se a empresa tem outro portfólio empresarial na Meta sem restrição;
Caso tenha, refaça a conexão selecionando esse outro portfólio;
Caso não tenha, será necessário criar um novo portfólio para concluir a conexão. 👉 Como criar e preparar seu Portfólio Empresarial.
Erro: Meta exige campo "Site" obrigatório
Durante o fluxo de conexão de um número, ao criar ou selecionar o Portfólio Empresarial, a Meta pode exibir uma tela pedindo o campo "Site" como obrigatório.
Caso você não tenha um site próprio, você pode usar o link do seu Instagram ou do Facebook da empresa nesse campo.
Como resolver:
Quando a tela pedir o campo "Site", cole o link do Instagram ou do Facebook da sua empresa;
Confirme que o link está completo, começando com https://
Siga normalmente com a conexão.
Ainda com problema? Se você está conectando pelo WhatsApp Sync, confira também WhatsApp Sync: como conectar seu número de WhatsApp ao Agendor CRM e o painel em Configurações > WhatsApp Sync.
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 app WhatsApp Business (CoEx) que também podem impedir ou dificultar o processo:
País não suportado: a conexão oficial do app WhatsApp Business (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.
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 app WhatsApp Business (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 app WhatsApp Business (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 da conexão oficial do app WhatsApp Business (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?
Quem pode reconectar ou desconectar um número?
No WhatsApp Sync, essa ação fica com o administrador da conta do Agendor CRM, no painel em Configurações do CRM. No Agendor Chat, com o administrador da conta do Chat.
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 app WhatsApp Business, o que costuma atrasar ainda mais a liberação da conexão oficial do app WhatsApp Business 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! 🙋♀️