Este guia abrangente aborda problemas comuns ao habilitar a Coexistência do WhatsApp, que permite às empresas usar o Aplicativo WhatsApp Business e a API Business simultaneamente com o mesmo número de telefone.Documentation Index
Fetch the complete documentation index at: https://help.eazybe.com/llms.txt
Use this file to discover all available pages before exploring further.
Lista de Verificação Rápida
Antes de solucionar problemas, verifique estes requisitos:Versão do App
Confirme a versão do WhatsApp Business App 2.24.17 ou mais recente
Provedor de Solução
Trabalhe com um Provedor de Solução WhatsApp oficial
Uso Ativo
Garanta mínimo 7 dias de uso ativo no Business App
Período de Espera
Delete WABA antigo e respeite 1-2 meses de espera se aplicável
Problemas Comuns e Soluções
1. Número de Telefone Não Elegível
Causas Raiz:- Histórico de uso insuficiente (requer mínimo 7 dias no Business App)
- Números recém-registrados ou baixa atividade de chat
- Vinculação anterior de WABA bloqueando elegibilidade
Soluções
Soluções
- Troque conversas reais por mínimo 7 dias; 30-60 dias recomendados
- Evite deletar e re-registrar o número repetidamente
- Remova a configuração WABA antiga e mantenha período de espera de 1-2 meses
2. Forçar Reonboarding para Números Presos
Objetivo: Forçar um reonboarding de um número de telefone que está atualmente preso ou vinculado incorretamente ao Aplicativo WhatsApp Business, contornando o período de resfriamento padrão da Meta.Fase 1: Meta Business Suite (O Lado da Nuvem)
Navegar: Abra Meta Business Suite → WhatsApp Manager
Localizar Número: Vá para a aba Números de Telefone
Configurações: Clique no ícone de Configurações/Engrenagem no lado direito do número de telefone específico
Desativar 2FA: Selecione a opção para Desativar a Verificação em Duas Etapas
Verificação: Meta enviará um link de redefinição/desativação para o e-mail do administrador registrado. Abra o e-mail, clique no link e confirme via OTP fornecido.
Fase 2: Dispositivo do Cliente (O Lado Local)
Desconectar: No Aplicativo WhatsApp Business no telefone do cliente, use o recurso “Toque para Desconectar” (se acessível)
Desinstalação Completa: Desinstale completamente o Aplicativo WhatsApp Business do dispositivo móvel. Isso limpa o cache local e os tokens de registro que muitas vezes causam loops de onboarding.
Fase 3: Reonboarding
Reinstalar: Baixe uma versão nova do Aplicativo WhatsApp Business
Registrar Novamente: Siga o fluxo de onboarding padrão para reconectar seu número
3. País ou Região Não Suportado
Causas Raiz:- Conformidade da Meta e restrições regulatórias em regiões específicas
- Nigéria e África do Sul comumente não são suportados
Soluções
Soluções
Países suportados incluem:
- Índia, Brasil, México, Indonésia
- EUA, Hong Kong, Singapura
- Monitore a documentação da Meta para suporte regional em expansão
- Considere canais de mensagens alternativos enquanto aguarda
3. Número Previamente Usado Com WhatsApp Business API
Causa Raiz: A Meta aplica períodos de espera obrigatórios entre transições de provedores.
Soluções
Soluções
- Delete a configuração WABA antiga completamente
- Re-registre no Business App e mantenha status ativo por 1-2 meses
- Evite apressar a reconexão da API durante o período de espera
4. Atrasos ou Falhas na Sincronização de Chats
Causas Raiz:- Históricos de chat grandes e listas de contatos estendem o tempo de sincronização
- Conectividade instável ou app fechado durante a sincronização
Soluções
Soluções
- Mantenha o telefone desbloqueado com o app aberto durante a sincronização
- Mantenha Wi-Fi confiável ou dados móveis fortes
- Permita 4-6+ horas para históricos grandes
- Escaneie novamente o código QR se travar; verifique versão 2.24.17+
5. Código QR Não Aparece ou Não Escaneia
Causas Raiz:- Versão desatualizada do WhatsApp Business App
- Navegação incorreta do fluxo de cadastro
- Problemas de câmera ou serviços temporários da Meta
Soluções
Soluções
- Atualize para versão 2.24.17 ou mais recente
- Siga o caminho correto: Configurações > WhatsApp > Cadastrar com Facebook
- Limpe a lente da câmera e otimize a iluminação
- Feche e tente novamente após aguardar; reinstale se persistir
6. Problemas de Vinculação com Página do Facebook
Causas Raiz:- Falta Página do Facebook ou Conta Meta Business
- Permissões de administrador insuficientes
- Restrições a nível de conta da Meta
Soluções
Soluções
- Crie ou conecte a Página do Facebook via configurações de Ferramentas Business
- Verifique acesso de administrador na Página e Conta Business
- Complete a configuração da Meta Business Account com todos os detalhes necessários
7. Não Consegue Desabilitar a Coexistência
A Coexistência é controlada pelo lado do WhatsApp Business App. A interface Cloud API não expõe uma opção direta de “desabilitar”.
Soluções
Soluções
- Use desconexão do app: Configurações > Conta > Plataforma Business
- Evite desinstalar o app
- Contate seu provedor ou suporte da Meta se o status não atualizar
8. Dispositivos Complementares Não Suportados
Causas Raiz:- Apenas WhatsApp Web e apps de desktop oficiais são suportados
- Mensagens de dispositivos não suportados não sincronizam com a API
Soluções
Soluções
- Vincule via WhatsApp Web ou app de desktop oficial do Mac/Windows
- Monitore atualizações do provedor para suporte de dispositivos em expansão
- Observe os avisos de marcador de posição em mensagens não suportadas
9. Nome do Negócio Bloqueado Após Cadastro
Causa Raiz: A Meta aplica identidade de negócio consistente em todas as plataformas após a conclusão do cadastro.Soluções
Soluções
- Finalize o nome do seu negócio antes de iniciar o cadastro
- Solicite alterações pós-cadastro via suporte da Meta (aprovação não garantida)
Ponto Chave
Com a preparação e solução de problemas corretas, a maioria dos problemas de integração podem ser resolvidos rapidamente. Se os problemas persistirem, contate a equipe de suporte do seu provedor de solução WhatsApp.