> ## 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.

# Solução de Problemas de Cadastro

> Solucione problemas comuns ao habilitar a Coexistência do WhatsApp para seu negócio

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.

<img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1855687476.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=26efc773d5bfc5977697152d6c6eb827" alt="Visão Geral da Coexistência" width="726" height="409" data-path="images/1855687476.png" />

## Lista de Verificação Rápida

Antes de solucionar problemas, verifique estes requisitos:

<CardGroup cols={2}>
  <Card title="Versão do App" icon="mobile">
    Confirme a versão do WhatsApp Business App **2.24.17** ou mais recente
  </Card>

  <Card title="Provedor de Solução" icon="handshake">
    Trabalhe com um Provedor de Solução WhatsApp oficial
  </Card>

  <Card title="Uso Ativo" icon="clock">
    Garanta mínimo **7 dias** de uso ativo no Business App
  </Card>

  <Card title="Período de Espera" icon="hourglass">
    Delete WABA antigo e respeite **1-2 meses** de espera se aplicável
  </Card>
</CardGroup>

<Tip>
  Faça backup das conversas importantes antes de começar. A Coexistência do WhatsApp suporta até 6 meses de capacidade de sincronização.
</Tip>

## Problemas Comuns e Soluções

### 1. Número de Telefone Não Elegível

<Warning>
  **Mensagem de Erro:** "Seu número de telefone não é elegível para conectar à Plataforma WhatsApp Business."
</Warning>

**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

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    - 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**
  </Accordion>
</AccordionGroup>

### 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.

<Steps>
  <Step>
    <h3>Fase 1: Meta Business Suite (O Lado da Nuvem)</h3>
    <p><strong>Navegar:</strong> Abra Meta Business Suite → WhatsApp Manager</p>
    <p><strong>Localizar Número:</strong> Vá para a aba Números de Telefone</p>
    <p><strong>Configurações:</strong> Clique no ícone de Configurações/Engrenagem no lado direito do número de telefone específico</p>
    <p><strong>Desativar 2FA:</strong> Selecione a opção para Desativar a Verificação em Duas Etapas</p>
    <p><strong>Verificação:</strong> 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.</p>
  </Step>

  <Step>
    <h3>Fase 2: Dispositivo do Cliente (O Lado Local)</h3>
    <p><strong>Desconectar:</strong> No Aplicativo WhatsApp Business no telefone do cliente, use o recurso "Toque para Desconectar" (se acessível)</p>
    <p><strong>Desinstalação Completa:</strong> 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.</p>
  </Step>

  <Step>
    <h3>Fase 3: Reonboarding</h3>
    <p><strong>Reinstalar:</strong> Baixe uma versão nova do Aplicativo WhatsApp Business</p>
    <p><strong>Registrar Novamente:</strong> Siga o fluxo de onboarding padrão para reconectar seu número</p>
  </Step>
</Steps>

### 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

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    **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
  </Accordion>
</AccordionGroup>

### 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.

<img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1855689918.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=9ea625c3abd770697baecfc36c98c23f" alt="Transição de Provedor" width="739" height="416" data-path="images/1855689918.png" />

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    * 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
  </Accordion>
</AccordionGroup>

### 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

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    - 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+
  </Accordion>
</AccordionGroup>

### 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

<img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1855690369.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=788c5b924ceefcad55d1add79650c1b6" alt="Problema do Código QR" width="667" height="733" data-path="images/1855690369.png" />

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    * 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
  </Accordion>
</AccordionGroup>

### 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

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    - 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
  </Accordion>
</AccordionGroup>

### 7. Não Consegue Desabilitar a Coexistência

<Info>
  A Coexistência é controlada pelo lado do WhatsApp Business App. A interface Cloud API não expõe uma opção direta de "desabilitar".
</Info>

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    * 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
  </Accordion>
</AccordionGroup>

### 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

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    - 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
  </Accordion>
</AccordionGroup>

### 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.

<AccordionGroup>
  <Accordion title="Soluções" icon="wrench">
    * 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)
  </Accordion>
</AccordionGroup>

## Ponto Chave

<Info>
  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.
</Info>

## Precisa de Ajuda?

Se você tiver alguma dúvida ou precisar de mais assistência, sinta-se à vontade para entrar em contato conosco em [hey@eazybe.com](mailto:hey@eazybe.com). Ficaremos felizes em ajudar!