Um fluxo é um desenho de caixas ligadas. Cada caixa é um passo, e eles rodam em ordem, de cima para baixo: quando algo acontece, faça isto, depois aquilo.
Exemplo: trazer os dados do ERP, atualizar o painel de vendas e mandar um e-mail dizendo que está pronto, com o número de linhas que chegaram.
Diferença para o agente: no desenho do agente, ligar uma caixa dá uma permissão a ele. No fluxo, a ligação é ordem — a caixa de baixo roda depois da de cima e pode usar o que ela produziu.
A lista#
Onde fica: menu IA → Fluxos.
Cada linha mostra o nome, se o fluxo já foi publicado (e qual versão roda) e como foi a última execução — Deu certo, Falhou, Rodando ou Nunca rodou.
Para criar, escolha um modelo pronto — Atualizar os dados e avisar por e-mail, Avisar quando um pipeline falhar, Atualizar os dados todo dia de manhã, Conferir e pedir aprovação antes de avisar, Relatório diário no WhatsApp, Resumo semanal por e-mail com IA — ou Começar do zero. O fluxo abre no editor para você completar.
Como um fluxo começa#
Todo fluxo tem uma caixa de começo (o gatilho). Escolher outra na lista troca a atual, sem perder as ligações.
| Gatilho | Quando o fluxo começa |
|---|---|
| Quando eu clicar em Executar | quando alguém clica em Executar agora |
| Em um horário | sozinho, a cada hora, todo dia, de segunda a sexta, uma vez por semana ou por mês — sempre em horário de Brasília, em passos de 15 minutos |
| Quando algo acontecer | quando um pipeline termina bem ou falha, um painel é atualizado (ou falha) ou um alerta de painel dispara — de um item escolhido ou de qualquer um. Começa em até 15 minutos |
| Quando outro sistema chamar | quando um sistema de fora chama o endereço secreto do fluxo (webhook) |
Os gatilhos automáticos (horário, acontecimento e webhook) só valem com o fluxo publicado e ligado. Ao publicar, o fluxo fica Ligado; o botão Pausar para os disparos automáticos (executar à mão continua possível) e Ligar volta a valer a partir de agora — o que passou enquanto estava pausado não roda atrasado.
O endereço do webhook
Na caixa Quando outro sistema chamar, o botão Gerar endereço mostra o
endereço e um segredo uma única vez — guarde os dois. Gerar outro endereço
desliga o anterior na hora. O outro sistema chama o endereço com o método POST; o que
ele mandar fica disponível para as próximas caixas em "o que o sistema mandou"
(por exemplo {{no:inicio.corpo.pedido}} para o campo pedido).
Para quem programa o outro sistema:
- marque Exigir assinatura para recusar chamadas sem o cabeçalho
x-ingestia-assinatura: sha256=<HMAC-SHA256 do corpo com o segredo>; - mande
Idempotency-Keypara a mesma chamada repetida nunca rodar duas vezes; - respostas: 202 aceito, 401 assinatura errada, 404 endereço desconhecido ou fluxo pausado, 413 corpo acima de 256 KB, 429 mais de 60 chamadas por minuto.
O editor#
À esquerda ficam as caixas, por grupo (Como começa, Pipelines e painéis, Avisar alguém…). Clique numa delas (ou arraste) para pô-la no fluxo; ela já entra ligada na última caixa. Para ligar à mão, puxe a bolinha de baixo de uma caixa até a de cima da próxima. O botão Arrumar organiza o desenho em coluna, sem mudar o que o fluxo faz.
Clique numa caixa para preencher o que ela precisa:
| Caixa | O que você escolhe |
|---|---|
| Em um horário | a frequência, o dia e o horário (Brasília) |
| Quando algo acontecer | o acontecimento e de qual pipeline ou painel |
| Rodar pipeline | qual pipeline, e se espera terminar antes de seguir |
| Atualizar painel | qual painel |
| Enviar e-mail | para quem, o assunto e a mensagem |
| Consultar dados | a tabela, até 3 filtros (botão Acrescentar filtro), a ordem e quantas linhas — sem escrever SQL. Só leitura; colunas com dado pessoal sensível não aparecem |
| Pedir à IA | o que a IA deve fazer e com quais dados — ela resume, analisa, escreve uma mensagem ou classifica numa das categorias que você listar. Tem custo de IA |
| Agente de IA | qual agente publicado e a pergunta; a resposta segue para as próximas caixas. Ações que o agente propuser esperam em Agentes → Aprovações |
| Enviar WhatsApp | os números e a mensagem. Quem pediu para sair não recebe |
| Chamar outro sistema | o endereço https, o método e o que enviar; a resposta vira dado para as próximas caixas |
Decidir, repetir e esperar
| Caixa | O que faz |
|---|---|
| Se / então | compara um dado ("é maior que", "contém", "está vazio"…) e segue por Sim ou Não. Números podem ser escritos do jeito brasileiro (1.234,56). Um caminho sem ligação termina o fluxo ali |
| Para cada linha | repete o que estiver ligado em Para cada uma vez por linha de uma lista (até 500); o que estiver em Depois roda uma vez, no fim. Lá dentro, "a linha da vez" traz os campos da linha |
| Esperar | espera minutos, horas ou dias (até 7) antes de seguir — sem ocupar nada |
| Juntar caminhos | ponto de encontro: espera os caminhos que estão em uso (por exemplo, o Sim e o Não de um Se) e segue uma vez só |
| Pedir aprovação | para e espera alguém decidir. Segue por Aprovado ou Recusado; sem decisão no prazo, conta como recusado |
Quando um fluxo pede aprovação, a lista de Fluxos mostra "fluxo esperando aprovação" e a caixa fica amarela no desenho. Clique nela, escreva um comentário se quiser e use Aprovar ou Recusar. Quem administra o workspace pode decidir; o campo Avisar por e-mail manda o link para quem precisa decidir.
Nos campos de texto, o botão Inserir dado lista o que as caixas anteriores produzem — por exemplo "Trazer os dados → linhas". O dado entra no texto, e logo abaixo aparece como a frase vai ficar.
Salvar, publicar e executar#
- O rascunho se salva sozinho a cada mudança.
- Publicar confere o desenho e o transforma na versão que roda. Enquanto faltar algo, a tela lista em português o que é — "Rodar pipeline: escolha qual pipeline rodar." — e o botão espera.
- Executar agora roda a versão publicada. Mudou o desenho depois? A tela avisa que as mudanças só valem depois de publicar de novo.
Durante a execução, cada caixa ganha a cor do resultado: Rodando…, Deu certo, Falhou ou Não precisou rodar. Clique na caixa para ver o que ela produziu ou o erro.
Se um fluxo falhar 5 vezes seguidas, ele é pausado sozinho, e o motivo aparece no alto do editor. O mesmo acontece se quem criou o fluxo perder a permissão de executar fluxos: ele para de começar sozinho em nome dessa pessoa.
Execuções#
O botão Execuções lista as 100 mais recentes: quando, como começou, o resultado, a duração e a versão. Ver no desenho abre o editor com aquela execução pintada sobre as caixas.
Quem pode o quê#
| Papel | Pode |
|---|---|
| Visualizador e membro | ver os fluxos e as execuções |
| Administrador e dono | criar, editar, publicar e executar |
Ambiente de teste#
Fora da produção nada sai de verdade: e-mail, WhatsApp e chamadas a outros sistemas aparecem na saída da caixa como simulado, e a consulta de dados pode trazer dados de demonstração — sempre escrito na saída, nunca disfarçado de real.