Use este guia quando o agente tenta enviar uma mensagem pela IAra e ela falha, fica sem confirmação ou aparece como enviada mas a pessoa atendida não recebe.
Primeiro: enviada não quer dizer entregue
Em canais assíncronos, a mensagem pode passar por várias camadas antes de chegar à pessoa atendida: IAra, provedor, canal e destinatário. Por isso, o status enviada normalmente significa que uma camada aceitou a tentativa, mas ainda não prova que a pessoa atendida recebeu.
| Status | Como interpretar | O que fazer |
|---|---|---|
| Pendente | A mensagem foi registrada e ainda aguarda processamento ou confirmação. | Aguarde alguns minutos e veja se outros envios do mesmo canal também estão parados. |
| Em processamento | A IAra está tentando despachar a mensagem ou aguardando retorno do canal. | Evite reenviar em massa; teste uma mensagem simples. |
| Enviada | A tentativa foi aceita por uma camada anterior. | Confirme se evoluiu para entregue, lida ou falhou. |
| Entregue | O canal confirmou chegada ao destino. | Não reenvie; siga o atendimento normalmente. |
| Lida | O canal informou leitura. | Nem todo canal mostra leitura, então a ausência desse status nem sempre é erro. |
| Falhou ou rejeitada | Alguma regra, credencial, política, payload, limite ou destinatário bloqueou o envio. | Use o erro exibido e o tipo de canal para ir ao artigo específico. |
| Não suportada | O canal não aceita aquele formato, mídia ou tipo de mensagem. | Troque por texto, link ou formato suportado. |
Diagnóstico rápido
- Confirme o canal e a caixa de entrada usados no envio.
- Veja se o erro acontece com todos os contatos ou apenas com um contato.
- Envie uma mensagem curta, sem link, mídia, emoji, template ou automação.
- Se texto simples funcionar, investigue formato, mídia, template, variável ou automação.
- Se texto simples falhar também, verifique conexão do canal, permissão, limite ou instabilidade.
- Compare o horário da tentativa com qualquer alerta do canal ou do provedor.
- Colete evidências antes de pedir ajuda à Digi2B.
Se aconteceu isso, comece por aqui
| Sintoma | Causa mais provável | Próximo passo |
|---|---|---|
| Falha genérica sem código | A causa real ficou no canal, provedor ou regra de envio. | Teste texto simples e colete print, horário e ID da conversa. |
| Fica pendente ou em processamento | A confirmação do canal ainda não voltou ou há fila de envio. | Aguarde, teste outro contato e veja se o problema afeta o canal inteiro. |
| Aparece como enviada, mas cliente não recebeu | O canal aceitou a tentativa, mas a entrega final falhou ou não foi confirmada. | Valide se há status entregue/lido ou falha posterior. |
| Erro 403 | Permissão, token, conexão ou autorização insuficiente. | Reconecte o canal com a conta correta e aceite todas as permissões. |
| Erro 404 | Conversa, caixa, contato ou recurso não encontrado. | Confirme se o envio está na conta/canal certo e se o recurso ainda existe. |
| Erro 422 | Conteúdo, variável, mídia ou payload inválido. | Remova mídia/variáveis e teste texto simples. |
| Erro 429 | Limite de envio ou excesso de tentativas. | Reduza o ritmo e aguarde antes de reenviar. |
| Erro 5xx ou timeout | Instabilidade temporária do provedor/canal. | Aguarde, evite retries agressivos e monitore se normaliza. |
| Manual funciona, automação falha | A regra gerou mensagem fora de contexto ou payload inválido. | Revise gatilho, condição, template e identificador do contato. |
| Só mídia falha | Arquivo, URL, tamanho, formato ou tipo não aceito. | Use o artigo de anexos e mídias. |
Artigos específicos
- Códigos de erro do WhatsApp: causas e soluções
- Como diagnosticar falhas em templates do WhatsApp
- Anexos e mídias não enviam
- Erros de e-mail: SMTP, autenticação, DNS e bounces
- Erros em Facebook, Instagram e Messenger
- Falhas em automações, API e webhooks no envio
Evidências mínimas para o suporte Digi2B
- Print da conversa com status ou erro exibido.
- Canal e caixa de entrada usados.
- Horário exato da tentativa, com fuso horário.
- ID ou link da conversa.
- Tipo de mensagem: texto livre, template, mídia, resposta pronta, automação ou API.
- Nome e idioma do template, se aplicável.
- Arquivo ou tipo de mídia usado, se aplicável.
- Se afeta um contato, alguns contatos ou todos os envios do canal.
Quando tentar novamente
Tente novamente quando o erro for temporário: timeout, instabilidade, limite de envio, manutenção do canal ou falha intermitente. Aguarde alguns minutos e evite reenviar várias vezes para o mesmo contato em sequência.
Quando não reenviar sem corrigir
Não reenvie em massa quando o erro indicar template inválido, permissão ausente, número inválido, mídia incompatível, conteúdo rejeitado ou regra de política do canal. Nesses casos, a nova tentativa tende a falhar de novo e pode piorar a reputação do canal.