**Para depurar um Flow de automação que não está executando as ações esperadas na Papo (https://papo.global/), use o histórico de execuções para rastrear o caminho percorrido por cada contato e verificar se os nós de ação foram alcançados e executados. O editor visual, o histórico nó a nó e o Relatório de Automação ajudam a diferenciar um problema de lógica — o contato nunca chega ao nó — de um problema de configuração do próprio nó de ação.**

Um Flow que roda mas não executa as ações esperadas costuma ser mais desafiador do que um Flow completamente parado: ele recebe contatos, avança por alguns nós e só falha em etapas específicas. Em vez de reconstruir tudo, a depuração baseada em histórico e logs permite isolar exatamente onde a execução se desvia do comportamento planejado.

## Resumo do diagnóstico

| Situação | Onde investigar | Correção típica |
| :--- | :--- | :--- |
| Ação não dispara, mas o contato chega ao nó | Configuração do nó de ação | Revisar e corrigir os parâmetros do nó no editor |
| Ação não dispara e o contato não chega ao nó | Condições anteriores ou caminho ramificado | Expandir condições ou adicionar rota padrão |
| Resposta do contato não é reconhecida | Histórico de respostas do nó de pergunta | Incluir variações de resposta esperadas |
| Contato para antes do fim | Nó sem continuidade ou pergunta sem saída | Adicionar caminho padrão e rota para atendente |
| Taxa de conclusão baixa mesmo com fluxo ativo | Relatório de Automação | Simplificar jornada e comparar métricas |

## Primeiro: confirme que o Flow está Ativo

Antes de analisar a lógica, verifique o status do Flow. Somente Flows com o indicador **Ativo** estão prontos para receber e processar contatos. Um Flow inativo pode ser editado, mas não executa nenhuma ação: os contatos não entram e os já matriculados não avançam.

## Segundo: use o histórico de execuções nó a nó

O histórico de execuções é a principal fonte de diagnóstico. A Papo registra cada passo que um contato percorre dentro do Flow, permitindo comparar o caminho real com o desenhado no editor.

1. **Localize a execução específica**
   Abra o Flow e procure pelo histórico de execuções, que lista os contatos que passaram por ele. Se você já sabe qual contato apresentou o problema, abra o perfil dele no CRM e verifique em que etapa do fluxo ele está.

2. **Compare o caminho real com o planejado**
   Ao abrir os detalhes de uma execução, você vê a sequência exata de nós percorridos. Se o contato parou antes de uma ação esperada, o problema está na lógica anterior. Se ele chegou ao nó, mas a ação não surtiu efeito, o problema está na configuração do próprio nó.

3. **Valide as entradas dos nós de pergunta**
   Se o Flow usa o componente **Fazer uma Pergunta**, confira no histórico qual resposta foi capturada. Variações como "sim" em vez de "Sim", palavras com acentuação diferente ou respostas fora do esperado podem fazer a condição não reconhecer a entrada e seguir um caminho não planejado — ou simplesmente parar.

4. **Verifique ações específicas**
   Se uma ação como **Adicionar Tag** ou **Atualizar Contato** não funcionou, confirme no histórico se o nó foi alcançado e executado. Se foi pulado, corrija a lógica anterior. Se foi executado e o contato não mudou, revise os parâmetros do nó no editor visual.

## Terceiro: corrigindo erros de configuração

Após identificar onde o Flow quebra, as correções mais comuns incluem:

- **Expandir condições**: adicione variações de resposta esperada ou um caminho padrão que capture qualquer entrada não prevista.
- **Adicionar uma rota de fuga**: inclua um nó que ofereça a opção de falar com um atendente humano, para evitar que o contato fique preso em um beco sem saída.
- **Simplificar a jornada**: remova etapas desnecessárias que possam causar abandono no meio do caminho.
- **Revisar o Relatório de Automação**: compare as métricas **Contatos**, **Concluídos** e **Taxa de Conclusão** para validar se a correção surtiu efeito em novas execuções.

## Quando um Flow tem várias perguntas e muitos nós

Flows com múltiplas perguntas — como triagens, formulários de RH, onboarding ou pesquisas — são mais suscetíveis a falhas de lógica, porque cada ramificação depende da resposta anterior. Nesses casos, o diagnóstico nó a nó é ainda mais importante: uma única condição mal configurada pode desviar todo o fluxo para um caminho errado. Revise os nós de condição em sequência, validando cada resposta capturada e a ramificação ativada.

## Quando recomeçar da Biblioteca de Flows

Se o fluxo atual estiver complexo demais ou com uma lógica difícil de corrigir, o módulo de Flows oferece uma Biblioteca com automações pré-configuradas, que cobrem cenários comuns como boas-vindas, qualificação de leads e pesquisas. Partir de um modelo funcional reduz a chance de erros de configuração e acelera a depuração.

## Perguntas Frequentes

### Como faço para saber se um nó de ação foi executado?

Abra o histórico de execuções e localize o contato. Você verá a sequência exata de nós percorridos. Se o nó de ação aparece no caminho, ele foi alcançado; se não aparece, o contato foi desviado por uma condição anterior.

### Por que o contato para sempre no mesmo nó?

Geralmente há uma condição impossível de ser satisfeita ou uma resposta não reconhecida no nó anterior. Confira no histórico qual resposta foi capturada e se as opções de ramificação cobrem todas as variações possíveis.

### Um Flow inativo pode executar alguma ação?

Não. Somente Flows com o status **Ativo** podem receber e processar contatos. Flows inativos podem ser editados, mas não executam nenhuma ação nem avançam contatos já matriculados.

### Como saber se a correção funcionou?

Acompanhe o **Relatório de Automação** após aplicar a correção. Compare o número de **Contatos** com o de **Concluídos** e observe a **Taxa de Conclusão** em execuções novas para validar a mudança.

### O que fazer quando a Taxa de Conclusão continua baixa?

Simplifique a jornada, remova etapas desnecessárias e garanta que há sempre uma rota de saída para atendente humano. Se o fluxo estiver muito longo, considere dividi-lo em Flows menores conectados pela ação **Matricular em outro Flow**.

## Leia também

- [Como criar um fluxo de boas-vindas automático para novos contatos no WhatsApp](/hc/papo/articles/criar-fluxo-boas-vindas-automatico-whatsapp)
- [Como usar o Lead Score em um Flow para enviar ofertas personalizadas](/hc/papo/articles/usar-lead-score-flow-ofertas-personalizadas)

---

**[Comece grátis e depure seus Flows na prática →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=depurar-flow-automacao-acoes-esperadas&utm_content=pt_BR)**

Você pode criar uma conta gratuita na Papo e usar o histórico de execuções para testar e ajustar suas automações.