Por que meu cliente não recebe a mensagem?

Causas comuns

• A janela de 24 horas está fechada e você tentou enviar texto livre (sem modelo aprovado).
• O número do cliente é inválido, está incorreto ou ele não optou por receber mensagens (sem opt-in).
• O modelo de mensagem (HSM) ainda não foi aprovado pela Meta.
• Você atingiu o limite de envio de conversas iniciadas pela empresa.
• A conexão do WhatsApp está instável ou desconectada.

Como verificar cada uma

1. Janela de 24 horas fechada — como checar

A janela de 24 horas funciona assim: depois que o cliente te manda uma mensagem, você tem 24 horas para responder livremente (texto, áudio, imagem). Passado esse prazo, o WhatsApp só deixa você falar de novo usando um modelo aprovado pela Meta.

1. No Inbox, abra a conversa e veja o aviso de tempo da janela (indicação de quando o chat expira). Se aparecer Expirado, a janela fechou.
2. Se a janela está fechada, uma mensagem de texto comum não será entregue — você precisa de um modelo.

2. Número inválido ou sem opt-in — como checar

1. Confira o número do cliente na ficha do contato: confirme o DDI (código do país), o DDD e a quantidade de dígitos.
2. Lembre-se de que o cliente precisa ter um WhatsApp ativo naquele número e ter aceitado receber suas mensagens (opt-in).

3. Modelo não aprovado — como checar

1. Vá em Configurações → WhatsApp → aba Modelos de mensagem.
2. Verifique se o modelo que você quer usar já está aprovado. Modelos recém-criados passam por análise da Meta antes de poderem ser enviados.

4. Limite de envio atingido — como checar

A Meta define um limite de quantas conversas a sua empresa pode iniciar por dia. Esse limite aumenta conforme você usa bem o número (boa qualidade, sem bloqueios). Veja Limites de mensagens do WhatsApp para entender como funciona.

5. Conexão WhatsApp instável — como checar

1. No seletor de companhia (canto inferior esquerdo), observe o ponto de status: verde indica WhatsApp conectado; vermelho indica problema na conexão.
2. Se estiver vermelho, as mensagens não saem até a conexão voltar.

Como confirmar pelo Histórico

A forma mais direta de saber se a mensagem saiu é olhar o Histórico das suas transmissões.

1. Vá em Transmissão → aba Histórico.
2. Localize o disparo e leia as colunas:
   • Enviado — mostra entregues/total (por exemplo, 565/2306).
   • Falha — mensagens que não foram entregues (número inválido, sem opt-in, janela fechada).
3. Uma taxa de falha muito alta costuma indicar lista fria, sem opt-in ou números inválidos.

Como resolver

1. Janela fechada: use um modelo de mensagem aprovado para reabrir a conversa. Em transmissões, o disparo já começa com um modelo.
2. Número errado: corrija o número na ficha do contato (com DDI e DDD corretos).
3. Modelo pendente: aguarde a aprovação da Meta antes de disparar; acompanhe em Configurações → WhatsApp → Modelos de mensagem.
4. Conexão caída: verifique o status no seletor de companhia e reconecte o WhatsApp se necessário.
5. Lista fria: trabalhe o opt-in da sua base e siga boas práticas para evitar bloqueio.

Quando chamar o suporte

• O Histórico mostra Enviado com sucesso, mas o cliente garante que não recebeu.
• A conexão aparece verde, o modelo está aprovado, a janela está aberta e mesmo assim há falha em massa.
• O número foi marcado com qualidade baixa ou bloqueado pela Meta e você não sabe como recuperar.