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 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 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.
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 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 (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! 🙋♀️