Erros durante a conexão
Clique em um erro para vê-lo no simulador à direita. Problemas após a conexão →
1 Gerenciador de Negócios
Primeira tela - criação ou seleção da conta comercial.
2 Conta do WhatsApp Business
Criar ou configurar a WABA.
3 Número de telefone
Adicionar número ao WhatsApp Business.
4 Verificação do número
Verificação por SMS ou ligação.
Aparece como: "Você fez tentativas demais", "Não foi possível verificar o código" ou "Você solicitou o código muitas vezes".
Espere 12 horas sem tentar. Depois, volte ao fluxo, selecione contas e números já existentes, e solicite novo código. Cada tentativa incorreta aumenta o tempo de espera.5 QR Code de conexão
Escanear o QR Code no WhatsApp Business do celular.
- Atualize o WhatsApp Business na loja
- Limpe a lente da câmera e melhore a iluminação
- Use o caminho correto: Configurações → Conta → Plataforma comercial
- Se nada funcionar: desinstale e reinstale o app
Problemas após a conexão
Se algo der errado depois de conectar, confira os casos abaixo.
"Conta com restrição" no Meta Business Manager
A conta do WhatsApp Business aparece desativada ou restrita no Gerenciador de Negócios.
O que significa: a Meta restringiu a conta (por exemplo, porque o site listado no perfil comercial não pôde ser encontrado ou por análise de conformidade). Enquanto estiver restrita, você não pode iniciar conversas, responder clientes nem adicionar números.
Onde solicitar a análise:
- Acesse o Meta Business Manager (business.facebook.com)
- Vá em Visão geral da conta / Portfólio comercial → Conta do WhatsApp
- Abra a conta restrita (botão "Abrir no Gerenciador do WhatsApp")
- Antes de pedir análise: atualize o perfil comercial com um site válido (link que funcione e corresponda ao escritório)
- Clique em "Pedir análise" (ou "Solicitar análise")
Texto sugerido para a análise (adaptar em nome do CNPJ/razão social do escritório):
Ajuste os colchetes e cole no campo da solicitação no Gerenciador do WhatsApp.
Solicitamos a análise em nome do CNPJ [número do CNPJ] – [Razão social do escritório]. Todas as pendências indicadas foram regularizadas: o perfil comercial foi atualizado com site válido e em conformidade com as políticas. Trata-se de um escritório de advocacia. O número de WhatsApp é utilizado exclusivamente para atendimento e tratativa com clientes (comunicação sobre processos, prazos, documentos e dúvidas jurídicas). A integração é feita via parceiro certificado pela Meta (Tech Provider), com uso adequado da API Oficial. Temos vários advogados e atendentes que utilizam o canal ao mesmo tempo, o que resulta em volume elevado de mensagens em períodos de maior demanda (prazos processuais, fechamento de contratos, etc.). Todo o uso é profissional e em conformidade com os Termos de Serviço. Pedimos a reativação do número para que possamos retomar a comunicação com nossos clientes. Agradecemos a revisão do caso.
Dica: envie uma única solicitação e aguarde a resposta da Meta (geralmente alguns dias). Enviar várias solicitações pode atrasar ou prejudicar a análise.
"Número não elegível"
Seu número de telefone não é elegível para se conectar à Plataforma WhatsApp Business.
O que significa: o número é muito recente no WhatsApp Business. A Meta exige um tempo mínimo de atividade.
O que fazer:
- Use o número normalmente por 7 a 60 dias antes de tentar conectar
- Não exclua e recrie a conta - isso reinicia o tempo de atividade
- Se o número já esteve em outra API antes: aguarde 1–2 meses
"Número já registrado em outra conta"
Este número está registrado em uma conta WhatsApp existente.
O que significa: o número estava (ou ainda está) conectado a outra plataforma (Z-API, Evolution, 360dialog, etc.).
O que fazer:
- Desconecte do provedor anterior
- Aguarde 3 minutos para liberar
- Tente novamente no fluxo de conexão
Se o número era da API antiga e não libera, aguarde 1–2 meses usando o número normalmente no WhatsApp Business App antes de tentar.
Erro ao vincular o Facebook
- Verifique se a Página do Facebook existe e está publicada
- Confirme que você é administrador no Facebook Business e na Página
- Dados da conta devem estar completos (nome, endereço, site)
Nome da empresa ficou errado
O nome da empresa é travado pela Meta após a ativação. Não pode ser alterado facilmente.
Para evitar: confira o nome com cuidado antes de confirmar durante a Etapa 2 da conexão.
Se já confirmou errado: entre em contato com o suporte da Meta. A aprovação não é garantida e pode demorar.
WhatsApp Windows não funciona
Isso é esperado. Após conectar a API, o WhatsApp para Windows (desktop) e o WearOS (relógio) deixam de funcionar.
O que continua funcionando:
- WhatsApp Web (pelo navegador)
- WhatsApp Mac
Preciso desconectar - como faço?
- Abra o WhatsApp Business
- Vá em Configurações → Conta → Plataforma comercial
- Toque no Chat Jurídico e confirme a desconexão