> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Solução de Problemas do WhatsApp

> Problemas comuns e soluções para integração do WhatsApp Business

## Problemas do Remetente

### Remetente Preso em Status "Criando" ou "Pendente"

**Sintomas:**

* Status do remetente mostra "Criando" por mais de alguns minutos
* Remetente preso em "Pendente" após completar cadastro no Meta

**Soluções:**

1. **Complete o fluxo de cadastro do Meta**
   * Certifique-se de ter terminado todos os passos no popup do Facebook
   * Você deveria ter visto uma confirmação antes de ser redirecionado de volta

2. **Verifique que você criou uma conta NOVA**
   * Você deve criar uma nova Conta WhatsApp Business durante o cadastro
   * Selecionar uma conta existente fará a integração falhar

3. **Verifique seleção do número de telefone**
   * Você clicou em "Adicionar novo número" no popup do Meta?
   * Você selecionou o número pré-verificado correto?

4. **Aguarde e atualize**
   * Às vezes a configuração demora alguns minutos para completar
   * Atualize a página após 5 minutos

5. **Contate o suporte**
   * Se o problema persistir por mais de 30 minutos, contate o suporte

### Verificação Falhou

**Sintomas:**

* Processo de verificação falha
* Mensagem de erro sobre timeout de verificação

**Soluções:**

1. **Aguarde antes de tentar novamente**
   * Meta pode limitar temporariamente solicitações de verificação
   * Aguarde 5-10 minutos antes de tentar novamente

2. **Tente um número diferente**
   * Alguns números podem ter problemas com a verificação do Meta
   * Tente usar um número de telefone diferente

3. **Verifique tipo do número**
   * Apenas números do tipo "normal" podem ser usados para WhatsApp
   * Números SIP ou especiais não são suportados

### Remetente Mostra "Offline"

**Sintomas:**

* Remetente estava funcionando mas agora mostra "Offline"
* Não consegue enviar ou receber mensagens

**Soluções:**

1. **Verifique violações de política**
   * Revise emails do Meta sobre problemas de política
   * Altas taxas de bloqueio ou relatórios de spam podem causar status offline

2. **Verifique classificação de qualidade**
   * Baixa classificação de qualidade pode desencadear status offline
   * Revise suas práticas de mensagens

3. **Re-autentique**
   * Às vezes a conexão precisa ser atualizada
   * Contate o suporte para assistência

### Remetente Suspenso

**Sintomas:**

* Status do remetente mostra "Suspenso"
* Erro menciona violação de política

**Soluções:**

1. **Revise motivo da suspensão**
   * Verifique a mensagem de erro para detalhes específicos
   * Motivos comuns: relatórios de spam, conteúdo proibido, altas taxas de bloqueio

2. **Resolva o problema**
   * Pare campanhas de mensagens problemáticas
   * Revise políticas de comércio do Meta

3. **Apele da suspensão**
   * Contate suporte do Meta através do Facebook Business Manager
   * Forneça evidências de conformidade

## Problemas de Template

### Template Rejeitado

**Sintomas:**

* Status do template mostra "Rejeitado"
* Motivo da rejeição exibido

**Motivos Comuns de Rejeição e Soluções:**

| Motivo                            | Solução                                        |
| --------------------------------- | ---------------------------------------------- |
| Conteúdo promocional em Utilidade | Mude categoria para Marketing                  |
| Amostras de variáveis ausentes    | Adicione valores de amostra claros e realistas |
| Encurtadores de URL               | Use URLs completas e de marca                  |
| Linguagem agressiva               | Suavize tom, remova ameaças                    |
| Categoria errada                  | Selecione categoria correta para o conteúdo    |

### Template Preso em "Pendente"

**Sintomas:**

* Template está pendente por mais de 24 horas

**Soluções:**

1. **Aguarde revisão**
   * Templates de marketing podem demorar até 48 horas
   * Templates complexos podem demorar mais

2. **Verifique por problemas**
   * Revise conteúdo do template para possíveis problemas de política
   * Garanta que valores de amostra são claros e apropriados

3. **Crie uma alternativa**
   * Se urgente, crie um novo template com nome diferente
   * Use conteúdo mais simples que tem mais probabilidade de ser aprovado

### Template Desabilitado

**Sintomas:**

* Template anteriormente aprovado agora mostra "Desabilitado"

**Causas:**

* Baixa pontuação de qualidade do feedback do cliente
* Template recebeu muitos bloqueios ou relatórios

**Soluções:**

1. **Revise padrões de uso**
   * Você estava enviando para clientes que não esperavam mensagens?
   * O conteúdo era relevante para os destinatários?

2. **Crie uma nova versão**
   * Crie um novo template com conteúdo melhorado
   * Considere seleção de audiência mais direcionada

## Problemas de Mensagens

### Mensagens Não Entregando

**Sintomas:**

* Mensagens de template não chegando aos destinatários
* Nenhuma confirmação de entrega

**Soluções:**

1. **Verifique formato do número de telefone**
   * Deve estar no formato E.164: +\[código do país]\[número]
   * Exemplos: +5511999999999, +14155551234

2. **Verifique se destinatário tem WhatsApp**
   * O destinatário deve ter WhatsApp instalado
   * Número deve estar registrado no WhatsApp

3. **Verifique status do remetente**
   * Remetente deve estar "Online" para enviar mensagens
   * Verifique na página de Remetentes WhatsApp

4. **Revise limites de mensagens**
   * Novos remetentes têm capacidade diária limitada
   * Verifique seu nível e limites atuais

### Mensagens de Formato Livre Falhando

**Sintomas:**

* Não consegue enviar mensagem de formato livre
* Erro sobre janela de 24 horas

**Soluções:**

1. **Verifique a janela de 24 horas**
   * Mensagens de formato livre só funcionam dentro de 24 horas da última mensagem do cliente
   * Use mensagem de template em vez disso

2. **Verifique se conversa existe**
   * O cliente deve ter mandado mensagem primeiro
   * Verifique histórico da conversa

### IA Não Respondendo às Mensagens

**Sintomas:**

* Mensagens do cliente chegam mas não há resposta da IA
* Mensagens aparecem na conversa mas nenhuma resposta é enviada

**Soluções:**

1. **Verifique conexão do assistente**
   * Verifique se um assistente está conectado ao remetente
   * Garanta que "IA Habilitada" está ligado

2. **Revise status do assistente**
   * Assistente deve estar ativo e configurado corretamente
   * Teste o assistente na interface de chat de teste

3. **Verifique por erros**
   * Revise conversa para qualquer mensagem de erro
   * Verifique logs do sistema para problemas

## Qualidade e Limites

### Classificação de Qualidade Caiu

**Sintomas:**

* Classificação de qualidade mudou de Alta para Média ou Baixa
* Limites de mensagens reduzidos

**Causas:**

* Altas taxas de bloqueio
* Relatórios de spam de destinatários
* Baixas taxas de resposta

**Soluções:**

1. **Revise campanhas recentes**
   * Verifique quais mensagens desencadearam bloqueios ou relatórios
   * Identifique conteúdo ou audiências problemáticas

2. **Melhore direcionamento**
   * Envie mensagens apenas para clientes que esperam ouvir de você
   * Remova contatos desengajados das listas

3. **Revise conteúdo das mensagens**
   * Garanta que conteúdo é valioso e relevante
   * Evite linguagem agressiva ou spam

4. **Aguarde recuperação**
   * Classificação de qualidade pode melhorar ao longo do tempo com boas práticas
   * Foque em qualidade sobre quantidade

### Atingindo Limites de Mensagem

**Sintomas:**

* Não consegue enviar mais mensagens
* Erro sobre limite diário atingido

**Soluções:**

1. **Aguarde reset**
   * Limites resetam diariamente (janela móvel de 24 horas)
   * Planeje campanhas dentro dos seus limites atuais

2. **Melhore qualidade**
   * Classificações de qualidade mais altas desbloqueiam limites maiores
   * Foque em engajamento e evite bloqueios

3. **Espalhe envios**
   * Não envie todas as mensagens de uma vez
   * Implemente delays nos fluxos de automação

## Problemas de Conexão

### Popup de Cadastro do Meta Não Aparece

**Sintomas:**

* Clicar em "Entrar com Facebook" não faz nada
* Popup bloqueado ou não carregando

**Soluções:**

1. **Permitir popups**
   * Verifique configurações do bloqueador de popup do navegador
   * Permita popups do domínio

2. **Limpar cache**
   * Limpe cache e cookies do navegador
   * Tente em modo incógnita/privado

3. **Tente navegador diferente**
   * Alguns navegadores têm políticas de popup mais restritivas
   * Chrome ou Firefox normalmente funcionam melhor

### Redirecionado de Volta Sem Completar Configuração

**Sintomas:**

* Popup fecha mas remetente não é criado
* Preso no passo 3

**Soluções:**

1. **Complete todos os passos**
   * O fluxo do Meta tem múltiplos passos
   * Garanta que você completou todos eles

2. **Verifique por erros**
   * Procure mensagens de erro no popup
   * Meta pode ter rejeitado a solicitação

3. **Tente novamente o processo**
   * Volte ao passo 2 e selecione seu número novamente
   * Complete o fluxo de cadastro do Meta cuidadosamente

## Obtendo Ajuda

Se ainda estiver enfrentando problemas:

1. **Verifique nossa página de status** para quaisquer problemas da plataforma em andamento
2. **Revise documentação do Meta** para políticas específicas do WhatsApp
3. **Contate o suporte** com:
   * Seu ID de remetente
   * Mensagens de erro (texto exato)
   * Passos que você já tentou
   * Capturas de tela se aplicável