A mensagem não saiu: as seis causas, em ordem de frequência
Na API Oficial, mensagem que não sai é frustrante por um motivo específico: o erro quase nunca explica o motivo em português. Aparece um código, ou nada,…
Na API Oficial, mensagem que não sai é frustrante por um motivo específico: o erro quase nunca explica o motivo em português. Aparece um código, ou nada, e a conversa fica parada.
A boa notícia é que a lista de causas é curta. Em ordem do que mais acontece:
1. A janela de 24 horas fechou
De longe a causa mais comum. Se o cliente não escreve há mais de 24 horas, mensagem livre não sai. É regra da Meta, e não há configuração que contorne.
Como reconhecer: o cliente respondeu ontem de manhã e agora é depois de amanhã. A conversa parece normal, mas a mensagem não vai.
O que fazer: use um modelo aprovado. É exatamente para isso que ele existe.
(A janela de 24 horas tem artigo próprio — é a regra que mais muda o dia a dia do atendente.)
2. O modelo não está aprovado
Você criou o modelo, submeteu, e ele ainda está em análise — ou foi reprovado e ninguém viu o aviso.
Como reconhecer: o modelo não aparece na lista dentro da conversa. Se não aparece, não está aprovado.
O que fazer: confira o estado do modelo. Reprovado costuma ser categoria errada ou variável mal posicionada.
3. O número desconectou
Vale para qualquer canal, e é a causa que assusta mais e resolve mais rápido.
⚠️ A IAZIS tenta reconectar sozinha. Desde julho de 2026, a reconexão automática cobre a maior parte das quedas — celular sem bateria, internet oscilando, aparelho reiniciado. Na maioria das vezes o problema resolve antes de alguém perceber.
Quando não resolve: a sessão foi encerrada de propósito no celular. Aí é ler o QR Code de novo.
Como reconhecer: a tela de conexões mostra o dispositivo desconectado. É o primeiro lugar para olhar, sempre, antes de investigar qualquer outra coisa.
4. O recurso não existe naquele canal
Você tenta mandar uma enquete numa conversa da API Oficial. Ela não existe lá.
Como reconhecer: o botão não aparece. A IAZIS esconde o que aquele canal não aceita, em vez de oferecer algo que vai falhar.
⚠️ Se um recurso sumiu ao trocar de canal, não é defeito — é o canal. Enquete, grupo e alguns tipos de anexo existem no WhatsApp Web e não na API Oficial.
5. O limite de envio foi atingido
A Meta define quanto você pode enviar, e esse limite cresce com o seu histórico. Operação nova, ou número cuja qualidade caiu, tem limite menor.
Como reconhecer: as mensagens saem normalmente até certo ponto do dia e depois param — sem que nada tenha mudado.
O que fazer: é o assunto do artigo sobre limites de envio. Resumo: o limite sobe com volume consistente e qualidade boa, e cai quando as pessoas bloqueiam ou denunciam.
6. O número do cliente não existe mais
Chip cancelado, número que virou de outra pessoa, número digitado errado no cadastro.
Como reconhecer: falha só naquele contato, sempre.
O que fazer: corrigir o cadastro. E se isso aparece muito numa campanha, a lista está velha — vale limpar antes do próximo disparo.
O roteiro de dois minutos
Antes de abrir chamado, nesta ordem:
1. O dispositivo está conectado? Tela de conexões. Resolve boa parte dos casos.
2. Falha em todos ou só num contato?
- Todos → conexão, limite ou qualidade
- Um só → janela de 24 horas, ou número inválido
3. É mensagem livre ou modelo?
- Livre e o cliente não escreve há um dia → é a janela
- Modelo que não aparece → não está aprovado
4. Já aconteceu antes no mesmo horário? Se para todo dia no mesmo ponto, é limite de envio.
⚠️ E o passo mais útil de todos: se a mensagem era de um fluxo automático, abra a conversa e leia o registro. A IAZIS mostra quais blocos executaram e onde parou. É a diferença entre saber o motivo e adivinhar.
A que não é falha e parece
Mensagem entregue com um tique só, que não vira dois. Isso não é falha de envio: significa que ela chegou ao WhatsApp e o aparelho do cliente ainda não recebeu. Celular desligado, sem sinal, ou com o aplicativo desatualizado.
Não adianta reenviar. Ela vai entregar quando o aparelho voltar.
Está com envio falhando e não achou a causa? Fale com a gente.