# Organização e diagnóstico: fluxos legíveis e fáceis de depurar

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:

![Fluxo desorganizado](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMm9tQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--ff8d05d5be3e9696ce96d36598fe71656eb29ce2/tutorial-organizacao-01-antes.jpg)

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:

![Fluxo organizado automaticamente](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMnNtQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--a74d6cd092f94d39c8500599d7636241632f46bb/tutorial-organizacao-02-depois-organizar.jpg)

- **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:

![Painel de avisos](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMndtQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3092e9806604be545c717e1d07fc5aa63775d8fb/tutorial-organizacao-03-avisos.jpg)

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:

![Painel de execuções](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBMjBtQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--3622aa31ac659f742b42252f7963248573e2e3fc/tutorial-organizacao-04-execucoes.jpg)

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

1. ✅ Clicou em **Organizar** e o desenho está legível?
2. ✅ O selo de **avisos** está zerado (ou você sabe explicar cada aviso restante)?
3. ✅ Toda saída de **erro/fallback/padrão** está conectada a algum destino?
4. ✅ Fez um disparo de teste e conferiu o **registro da execução** de ponta a ponta?
5. ✅ 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! 🚀