Visão geral
Existem dois problemas diferentes que costumam ser confundidos:
- Canal desconectado: afeta todas as mensagens daquela caixa de entrada. Nesse caso o número caiu ou perdeu a sessão — o tratamento está em Erros comuns de WhatsApp.
- Mensagem individual que falhou: apenas aquela bolha aparece com o status falhou, com o motivo do erro logo abaixo. O restante da conversa continua funcionando.
Quando um envio falha, a plataforma grava o motivo retornado pelo WhatsApp (ou pelo gateway) e marca somente aquela mensagem como falhou. Por isso o primeiro passo é sempre ler o motivo na própria bolha — ele aponta exatamente o que corrigir.
Pré-requisitos
- Um canal de WhatsApp conectado (Cloud ou Web). Se o canal estiver desconectado, todas as mensagens falham — resolva a conexão primeiro.
- Acesso de agente à conversa onde a mensagem falhou.
Passo a passo
- Abra a conversa e localize a bolha com o status falhou. O motivo do erro aparece junto da mensagem.
- Corrija conforme a causa (template, janela de 24h, mídia, tipo de conversa — veja a tabela abaixo).
- Reenvie a mensagem (ou componha uma nova já corrigida).
- Confirme com uma mensagem de teste que ela saiu — o status deve passar para enviado, entregue ou lido.
Configurações & opções
- Status da mensagem: enviado, entregue, lido, falhou.
- Motivo da falha: a plataforma exibe na bolha o erro retornado pelo WhatsApp/gateway, sem reescrevê-lo — é a orientação principal para o conserto.
Causas comuns
| Causa | Onde acontece | O que fazer |
|---|---|---|
| Template não encontrado ou inválido | Cloud | Use um template aprovado (nome + idioma corretos) ao responder fora da janela. |
| Janela de 24h fechada | Cloud | Reabra a conversa com um template aprovado; só depois envie mensagem livre. |
| Mídia muito grande ou tipo não suportado | Cloud e Web | Reduza o arquivo (limite padrão 40 MB) e use um formato aceito (imagem, vídeo, áudio, documento). |
| Comunidade só aceita anúncio em texto | Web | Em uma comunidade, envie apenas texto (sem mídia, enquete ou botões). |
| Recurso interativo recusado | Web | Botões/listas/carrossel/flow dependem do gateway e do WhatsApp; se vierem recusados, o motivo aparece na bolha. |
| Catálogo nativo não suportado pelo provedor | não-Cloud | A mensagem nativa de produto é só do Cloud; nos demais provedores ela cai no cartão de produto comum. |
| Número caiu/desconectado | Cloud e Web | Reconecte o canal — veja Erros comuns de WhatsApp. |
Cloud x Web
- WhatsApp Cloud segue as regras da Meta: tem janela de 24h e exige template aprovado para reabrir a conversa. O motivo exibido na bolha é a mensagem de erro da Meta, verbatim.
- WhatsApp Web não usa templates aprovados e não tem janela de 24h — toda resposta sai como mensagem de sessão. O motivo exibido vem do gateway conectado. Listas e flows só renderizam em conversas 1:1; em grupos chegam como texto.
Casos de uso
- Reabrir uma conversa de Cloud que passou de 24h, usando um template aprovado.
- Reenviar uma mídia que foi recusada por tamanho, depois de reduzir o arquivo.
- Entender por que um botão funcionou e a lista não apareceu em um grupo (no Web).
Dicas, limites e boas práticas
- No Cloud, mantenha templates aprovados prontos e respeite a janela de 24h.
- Evite mídias acima do limite de upload (padrão 40 MB) e prefira formatos comuns.
- No Web, lembre que lista e flow só aparecem em conversas 1:1; em grupo, use botões ou texto.
- Em comunidades, comunique apenas por texto.
- Para campanhas e disparos, siga Limites, anti-ban e boas práticas.
Solução de problemas
- "Template not found or invalid template name" (Cloud): o template informado não existe, está com idioma diferente ou não está aprovado. Escolha um template aprovado com nome e idioma corretos e reenvie.
- Falha por janela de 24h expirada (Cloud): passou mais de 24h desde a última resposta do cliente. Reabra com um template aprovado; depois disso a conversa volta a aceitar mensagem livre.
- Mídia rejeitada: o arquivo excede o limite (padrão 40 MB) ou o tipo não é aceito. Reduza o tamanho e use imagem/vídeo/áudio/documento em formato comum.
- Comunidade ("WhatsApp communities only accept text announcements..."): a mensagem tinha mídia, enquete ou botões. Em comunidade, envie apenas texto.
- Recurso interativo recusado (botões, listas, carrossel ou flow): a plataforma envia esses recursos sem bloqueio próprio — quem valida é o WhatsApp e o gateway. Se vier uma recusa (por exemplo, uma mensagem de permissão do gateway), o texto exato aparece na bolha; siga a orientação ou use um formato compatível.
- Número caiu/desconectado: se várias mensagens falham, o problema é a conexão, não a mensagem — veja Erros comuns de WhatsApp.