Erros mais comuns na conexão do WhatsApp Business via Coexistence e como solucionar

847 visualizações 1

Erro ao realizar a leitura do QR Code

Durante o escaneamento do QR Code, podem acontecer os principais erros, como:

1. Exibição da mensagem “QR Code inválido”
2. O pop-up da Meta retorna automaticamente para a etapa anterior

Estes principais problemas podem acontecer por diferentes motivos:

  • Verificação em duas etapas: caso esteja habilitada, o sistema exigirá o PIN de seis dígitos. Se o PIN não for informado corretamente ou expirar, o processo será interrompido.
  • Problemas de rede ou conexão: internet instável no celular ou no computador podem gerar falhas de sincronização.
  • Sincronização do aplicativo: se o app WhatsApp Business estiver desatualizado ou com processos em segundo plano ativos, a conexão pode falhar. A Meta recomenda manter o app do WhatsApp Business aberto durante todo o processo.
  • Permissões ou conta: erros menos comuns relacionados ao Meta Business Manager ou à Página do Facebook associada podem afetar a conexão.
  • Timeouts ou erros do sistema: a comunicação entre os servidores do Tintim e Meta podem falhar ou sofrer atrasos por instabilidades. Caso aconteça, recomece o processo.

Como Resolver?

  • Mantenha o app do WhatsApp Business atualizado na versão mais recente
  • Associe o número do WhatsApp Business diretamente à conta no Meta Business Manager antes de fazer a conexão com o Tintim.

Número não é elegível por pouco tempo de uso

Infelizmente a Meta não divulga critérios mínimos para que o número seja elegível. A meta pode bloquear a coexistence no número por identificar pouco histórico de atividades.

Como Resolver?

  • Construa um histórico de uso: utilize o WhatsApp Business ativamente por pelo menos 7 dias (ideal seria de 1 a 2 meses de uso diário)
  • Evite re-cadastros: ficar tentando excluir e cadastrar números pode zerar o histórico do WhatsApp
  • Verifique se houve cadastro anterior: se o número já foi vinculado anteriormente será necessário removê-lo do Meta e registrar novamente no app para criar um histórico, antes de tentar reconectar.

Funcionalidade indisponível em determinados países

Em alguns países não é permitido a integração do número de WhatsApp Business com a Coexistence. O número não pode ser de regiões atualmente não suportadas (ex.: União Européia, Reino Unido, Austrália, Japão, Nigéria, Filipinas, Rússia, Coreia do Sul, África do Sul, Turquia, Suíça).

Como Resolver?

  • Utilize um número telefone de um país suportado como: Índia, Brasil, México, Indonésia, EUA, Hong Kong ou Singapura.

Número previamente já cadastrado em outra conta

Se o número já foi integrado em outro provedor, a Meta não permite nova conexão sem antes remover o vínculo anterior.

Como Resolver?

  1. Você pode tentar excluir a conta vinculada ao WhatsApp Business
  2. Reinstalar o App do WhatsApp Business
  3. Cadastrar novamente o número
  4. Utilizar o app WhatsApp Business por um determinado tempo para criar histórico
  5. Tentar reconectar quando o número estiver elegível.

WhatsApp no Windows não exibe mensagens

Em alguns casos, conversas antigas deixam de aparecer no aplicativo para Windows, já que a Meta não oferece suporte de coexistence nesta versão.

Como Resolver?

  • Utilize versões compatíveis como WhatsApp Web ou WhatsApp para Mac.
  • Acompanhe as atualizações da Meta para que possam corrigir essa limitação.
  • Há relatos de usuários que esta condição normalizou de forma automática após 2 a 3 dias

Você alcançou o número máximo permitido de contas de anúncios

Mesmo que o erro pareça relacionado a anúncios, ele bloqueia a criação automática dos ativos necessários para ativar o WhatsApp Business Coexistence.

Verifique o limite atual e o status da empresa

  1. Acesse o Business Manager em https://business.facebook.com/settings.
  2. Selecione o Business Manager vinculado à integração do WhatsApp Business.
  3. Verifique suas contas de anúncio existentes acessando no menu lateral Contas > Contas de anúncio.
  4. Verifique a lista de contas de anúncios associados à empresa.
  5. Caso o botão Adicionar > Criar nova conta de anúncio esteja desativado ou exiba erro, o limite foi atingido.
  6. Se possível remova contas inativas ou não utilizadas para liberar espaço.
  7. Verifique também a verificação da empresa acessando no menu lateral Central de Segurança ou vá para https://business.facebook.com/settings/security
  8. Em verificação de empresas, confira o status (tudo certo – verificado, ou clique em Iniciar Verificação – não verificado)

Como resolver?

Excluir contas de anúncios antigas
  1. Acesse https://business.facebook.com/settings/ad-accounts
  2. Selecione contas de anúncios que não estão em uso.
  3. Clique em Remover ou Encerrar conta de anúncios.
  4. Tente novamente conectar o número do WhatsApp após alguns minutos.
Verificar a empresa
  1. A verificação pode aumentar automaticamente o limite de contas.
  2. Após completar o processo de verificação, aguarde até 24 horas e refaça o onboarding do WhatsApp Business.
Solicitar aumento de limite à Meta
  1. Acesse o Suporte da Meta Business.
  2. Selecione Gerenciador de Anúncios → Problemas com contas de anúncios.
  3. Envie uma solicitação com a seguinte mensagem: “Estou tentando conectar um número do WhatsApp Business pelo processo da Coexistence, mas recebi a mensagem “Você atingiu o número máximo de contas de anúncios permitidas para sua empresa”. Você poderia aumentar nosso limite de contas de anúncios e nos ajudar a concluir este processo de integração do WhatsApp Business? Nossa empresa é verificada e está em situação regular.”

Número de telefone já vinculado a Eventos Automáticos

O erro que aparece no print abaixo é um conflito técnico clássico entre as automações nativas do aplicativo WhatsApp Business e a integração via API (Cloud API) que o Tintim utiliza.

O que está causando o erro?

No ecossistema da Meta, isso acontece quando o aplicativo WhatsApp Business (o app do celular) está com funções de automação ativas que “prendem” o fluxo da conversa antes mesmo de ela ser enviada para o Tintim.

É provável que o WhatsApp já esteja atrelado a IA da Meta para empresas, que funciona através de etiquetas e respostas automáticas inteligentes. Para que a IA funcione, ela precisa monitorar os eventos de entrada de mensagens em tempo real. Quando você tenta fazer a Conexão Coexistence ao Tintim, a Meta detecta que já existe um “processador” (a IA nativa) cuidando das mensagens e impede a conexão para evitar que dois sistemas (a IA da Meta e o Tintim) tentem responder ao mesmo tempo, o que geraria um loop ou mensagens duplicadas.

Como resolver?

O próprio aviso da Meta no print acima já dá o caminho das pedras, mas vamos detalhar para que você possa orientar o cliente:

  1. Desativar Etiquetas Automáticas:

    • No celular do cliente, abra o WhatsApp Business.
    • Vá em Ferramentas Comerciais (o ícone da lojinha).
    • Toque em Etiquetas.
    • Verifique se existem etiquetas configuradas como “automáticas” ou se há alguma configuração de IA ativa ali e desative-as.

  2. Desativar a IA da Meta (Temporariamente):

    • Para que a integração via API (Tintim) seja concluída, o número precisa estar “limpo” de automações nativas que conflitem com o protocolo de recebimento de mensagens. O cliente deve ir nas configurações de automação do app e desativar qualquer fluxo de IA ou saudação inteligente que esteja rodando diretamente pela Meta.

  3. A questão da “Coexistência”:

    • Embora a Meta permita a coexistência (App do Celular + API do Tintim), existem limitações. Se o Tintim exige que o número seja o “provedor principal” da lógica de atendimento, as automações nativas do App Business precisam ser sacrificadas em favor do Tintim.
Tags:

Isto foi útil?