Fluxo que cresce vira bagunça — nós sobrepostos, linhas cruzadas, e ninguém mais entende o desenho. E quando algo "não funciona", como descobrir o que aconteceu? Este guia fecha a série mostrando as ferramentas de organização e diagnóstico do editor.
Organize com um clique
Reconhece a cena? Nós amontoados depois de várias edições:
Clique no botão Organizar (varinha ✨ — na barra do rodapé do editor; em telas menores, dentro do menu ☰). O editor recalcula todas as posições a partir da estrutura do fluxo: camadas de cima para baixo, espaçamento uniforme, ramos paralelos lado a lado:
- Ctrl+Z desfaz se preferir o arranjo anterior
- As notas adesivas ficam onde estão (marcações suas não se movem)
- Ao arrastar nós manualmente, eles agora encaixam numa grade — alinhamento sem esforço
Avisos de configuração
O editor vigia os erros silenciosos mais comuns. Quando encontra algum, um selo âmbar ⚠️ aparece na barra — clique para ver a lista:
O que ele detecta:
- Saída de erro de Requisição HTTP desconectada — se a API falhar, o fluxo terminaria em silêncio
- Variável usada que nenhum nó produz — nome digitado errado ou mapeamento esquecido
- Templates WhatsApp de canais diferentes no mesmo fluxo — a resposta do contato cairia em outra conversa
- Corpo preenchido com "Enviar body" desligado — a API receberia uma requisição vazia
São avisos, não bloqueios — mas cada um representa um problema real que já custou horas de investigação de algum time. Vale resolver antes de ativar.
Registros de execuções: o raio-X do fluxo
"O contato disse que não recebeu nada" — e agora? Clique em Registros de execuções na barra do editor. Cada execução mostra o caminho completo, passo a passo:
Para cada execução você vê:
- Status geral (concluído, falha, rodando, aguardando resposta) e duração
- O trace nó a nó: quais executaram, por qual saída seguiram, quanto tempo levou cada um
- Respostas de APIs: o status HTTP e um trecho do que a API devolveu naquele nó — dá para ver na hora um erro 400 ou um "status: pendente"
- Variáveis da execução: tudo que o fluxo coletou e mapeou (CPF informado, nome retornado pela API…)
- Link direto para a conversa do contato
💡 Fluxos com gatilho Webhook têm ainda o log próprio de Requisições recentes no nó de gatilho — mostra cada chamada que o sistema externo fez, com o payload recebido.
Checklist de qualidade antes de ativar
- ✅ Clicou em Organizar e o desenho está legível?
- ✅ O selo de avisos está zerado (ou você sabe explicar cada aviso restante)?
- ✅ Toda saída de erro/fallback/padrão está conectada a algum destino?
- ✅ Fez um disparo de teste e conferiu o registro da execução de ponta a ponta?
- ✅ O fluxo está Ativo e salvo?
Com isso você fecha a série de Fluxos: criação, gatilhos, mensagens, decisões, APIs, integrações externas e — agora — organização e diagnóstico. Bons fluxos! 🚀