Gatilho: Mensagem enviada falhou

O gatilho Mensagem enviada falhou dispara quando uma mensagem enviada pela Omnifox não pôde ser entregue, por qualquer motivo: erro do provedor, janela de 24 horas do WhatsApp vencida, saldo insuficiente, entre outros.

Quando usar

• Avisar a equipe quando um envio crítico falha (por exemplo, uma confirmação de pagamento).
• Tentar novamente por outro canal se o WhatsApp falhar (por exemplo, cair para SMS ou e-mail).
• Sinalizar especificamente erros de carteira/saldo para evitar uma interrupção do serviço.

Filtros disponíveis

• Tipo de canal, Canal específico.
• O código de erro contém: por exemplo BSP_INSUFFICIENT_WALLET, SEND_FAILED, RETRY_FAILED.

Variáveis disponíveis

• $message.id, $message.text, $message.direction (sempre outbound)
• $message.error_code, $message.error_message, $message.failed_at
• Variáveis de conversa e contato

Como criar

1. Acesse Workflows → Novo fluxo de trabalho.
2. Arraste o Gatilho → escolha Mensagem enviada falhou (categoria Mensagens).
3. Para isolar um tipo de erro, preencha O código de erro contém (ex. BSP_INSUFFICIENT_WALLET).
4. Adicione uma ação como Avisar equipe usando $message.error_message.
5. Salve e ative.

Exemplo

Fluxo "Alerta de saldo insuficiente": filtra pelo código contendo BSP_INSUFFICIENT_WALLET → Avisar equipe (espaço "Faturamento"): ⚠️ Falha ao enviar para {{contact.display_name}}: {{message.error_message}}.

Dicas

Crie um fluxo separado só para erros de carteira/saldo — geralmente exigem ação administrativa imediata, diferente de uma simples nova tentativa de envio.

Solução de problemas

Se o gatilho nunca disparar, revise o histórico da mensagem enviada dentro da conversa — muitas "falhas silenciosas" na verdade ficam em fila para nova tentativa automática e só contam como falha definitiva depois de esgotar as tentativas.