Workflow não dispara
Sintoma: workflow configurado, ativo, mas não executa em caso esperado.
Causas comuns
Seção intitulada “Causas comuns”1. Workflow não está ativo
Seção intitulada “1. Workflow não está ativo”Diagnóstico: lista de workflows → toggle “Ativo” está OFF.
Solução: ligue o toggle.
2. Condições não bateram
Seção intitulada “2. Condições não bateram”Diagnóstico:
- Logs do workflow → veja execuções “ignoradas”.
- Sistema mostra qual condição falhou.
Solução: ajuste condições ou caso de uso.
3. Gatilho errado
Seção intitulada “3. Gatilho errado”Workflow inscrito em “Mensagem recebida” não dispara para “Conversa criada”.
Diagnóstico: confirme gatilho correto.
Solução: ajuste gatilho ou crie workflow adicional.
4. Inbox não tem workflows ativos
Seção intitulada “4. Inbox não tem workflows ativos”Workflow aplica-se a inbox específico. Conversas em outros inboxes não disparam.
Diagnóstico: veja Aplica-se a na configuração.
Solução: expanda escopo ou crie workflow por inbox.
5. Loop bloqueado
Seção intitulada “5. Loop bloqueado”Workflow X aciona Y que aciona X → app.smart bloqueia após 5 saltos.
Diagnóstico: logs mostram “loop detected”.
Solução: quebre a cadeia.
6. Erro em ação (sem afetar outras)
Seção intitulada “6. Erro em ação (sem afetar outras)”Workflow disparou, primeira ação falhou. Padrão é continuar próximas.
Diagnóstico: logs mostram ação X falhou.
Solução: corrija ação problemática.
7. Permissão da conta
Seção intitulada “7. Permissão da conta”Plano não suporta o recurso usado.
Diagnóstico: ação avançada (Brain, webhook complexo) requer plano superior?
Solução: upgrade ou ajustar workflow para recurso disponível.
Como debugar
Seção intitulada “Como debugar”1. Verifique logs do workflow
Seção intitulada “1. Verifique logs do workflow”
Config. → Automação → Workflows → abra o workflow → aba Execuções:
- Disparou? Quando?
- Resultado: Concluído, Concluído com erros, Rodando, Pausado, Falhou ou Pendente
- Detalhes de cada ação
2. Teste manual
Seção intitulada “2. Teste manual”No editor existe Simular: percorre o fluxo com um evento de exemplo sem executar nada. Para ver de verdade, o teste é provocar o gatilho e olhar as execuções:
- Use conversa real como input
- Veja se ações executam
- Ajuste se necessário
3. Compare com workflow funcionando
Seção intitulada “3. Compare com workflow funcionando”Tem workflow similar que funciona? Compare:
- Mesmo gatilho?
- Mesmas condições?
- Mesmo escopo?
Encontre diferença.
Erros comuns por gatilho
Seção intitulada “Erros comuns por gatilho””Mensagem recebida” não dispara
Seção intitulada “”Mensagem recebida” não dispara”- Mensagem foi de agente (não cliente)?
- Conversa estava resolvida (reabertura conta diferente)?
- Inbox vinculado correto?
”Conversa criada” dispara mas filtros excluem
Seção intitulada “”Conversa criada” dispara mas filtros excluem”- Filtro de inbox específico?
- Filtro de idioma do contato?
- Hora do dia restrita?
”Deal movido” não dispara
Seção intitulada “”Deal movido” não dispara”- Movimentação foi para fase específica configurada?
- Pipeline correto?
- Foi humano ou outro workflow que moveu (configuração pode excluir)?
Workflow em loop
Seção intitulada “Workflow em loop”Sinal: app.smart bloqueia após 5 saltos.
Causa típica:
Workflow A: ao receber mensagem → aplica etiqueta XWorkflow B: ao aplicar etiqueta X → atribui agenteWorkflow C: ao atribuir agente → envia mensagemWorkflow D: ao enviar mensagem → workflow A dispara de novo... loopSolução: adicione condição de controle:
Workflow A:- Gatilho: mensagem recebida- Condição: tipo da mensagem = "incoming" (não "outgoing")- Etiqueta X só se ainda não temEvita reativação.
Performance lenta
Seção intitulada “Performance lenta”Workflow demora 30+ segundos para executar?
Causas:
- Ação webhook lenta
- Brain com modelo grande (gpt-4o demora)
- KB grande consultada
Otimize:
- Use modelo menor (mini)
- Webhook deve responder em <5s
- Cache de dados estáticos
Quando escalar
Seção intitulada “Quando escalar”Reporte ao suporte se:
- Workflow simples não dispara mesmo com lógica óbvia
- Logs não mostram clareza do problema
- Múltiplos workflows falhando simultaneamente
Inclua:
- ID do workflow
- Conversa/evento que deveria ter disparado
- Print dos logs
- O que esperava vs o que aconteceu