> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Flow

> Automações: quando algo acontece, o Brainchat faz o resto. Gatilhos, passos, teste, publicação, versões e histórico.

O **Flow** automatiza tarefas: quando acontece algo (um registro criado, um horário, uma chamada externa), o Brainchat executa os passos que você montou. Abra em **Insights → Flow**.

Os fluxos são da organização, não de um canal. Cada execução conta no consumo de Flow do plano (veja [Minha Conta](https://docs.brainchat.app/organizacao/minha-conta.md)).

## Lista

![Lista de Flows com as abas Fluxos, Execuções e Métricas e o botão Novo fluxo](https://mintcdn.com/stegia/2sx_YUniIgU9qCdN/images/insights/flow-lista.png?fit=max\&auto=format\&n=2sx_YUniIgU9qCdN\&q=85\&s=d572ad5d01c13151e7bbc5b8dc2944c9)

Lista de Flows

As abas **Fluxos** e **Execuções** mostram os fluxos e o histórico. Filtre execuções por fluxo, status (**Concluída**, **Com erro**, **Em andamento**, **Aguardando**, **Na fila**), origem e período. Em cada fluxo: **Abrir e editar**, **Ver execuções**, **Duplicar**, **Métricas** e **Excluir fluxo**.

Clique em **Novo fluxo**, dê o **Nome do fluxo** e **Criar**.

## Gatilho (Quando acontecer)

![Editor do Flow com o gatilho Registro criado na tabela Contatos CRM e os passos Condição, Classificar, Esperar, Enviar mensagem e Atualizar registro](https://mintcdn.com/stegia/gqRqm3rIoPM4XJCc/images/insights/flow-editor.png?fit=max\&auto=format\&n=gqRqm3rIoPM4XJCc\&q=85\&s=682125c652c5ac01d8b2f86561385135)

Fluxo de exemplo: um contato novo na tabela recebe boas-vindas no WhatsApp

| Origem | Quando roda |
| - | - |
| **Uma tabela** | **Registro criado**, **Registro atualizado** (opcional: **Só quando estes campos mudarem**) ou **Registro excluído** |
| **Chamada externa (webhook)** | Quando alguém chamar o **Endereço para chamar** do fluxo (use **Copiar endereço**) |
| **Em um horário** | **A cada X horas**, **Todo dia**, **Em dias da semana**, **Todo mês** ou **Em horários específicos**, no fuso escolhido. Só roda depois de publicado |
| **Execução manual** | Quando você mandar rodar |
| **Formulário de ação** | Quando alguém preencher e enviar o formulário do botão de ação na ficha de um registro |

**Só continuar quando** é um filtro de entrada: se não combinar, o fluxo nem começa e nada aparece no histórico.

**Se o fluxo falhar** roda uma ação quando a execução termina com erro; use `{{falha.mensagem}}` e `{{falha.passo}}` nos valores.

## Passos

| Grupo | Passos |
| - | - |
| **Controle** | **Condição**, **Caminho** (ramos), **Repetição** (para cada item), **Esperar** (tempo, data ou janela de horário), **Esperar até** (e-mail aberto, clicado ou respondido, ou o contato responder) |
| **Tabelas** | **Buscar registro**, **Preencher campos** (do registro do gatilho), **Criar registro**, **Atualizar registro**, **Salvar lista na tabela**, **Criar nota no registro** |
| **WhatsApp** | **Enviar mensagem**, **Perguntar com opções** (botões), **Encaminhar atendimento**, **Liberar agente**, **Executar ação do agente**, **Enviar modelo** |
| **E-mail** | **Enviar e-mail** |
| **Gemini (IA)** | **Gerar texto**, **Extrair dados**, **Classificar** |
| **Dados da web** | **Coletar dados da web**: pesquisar, ler páginas e extrair campos |
| **Documentos** | **Gerar documento** (PDF, Word, HTML ou Markdown) |
| **Utilitários** | **Texto**, **Data e hora**, **Números**, **Listas e dados**, **Definir variáveis** |
| **Avançado** | **Chamada HTTP**, **Descriptografar** (com chave do cofre), **Código** (JavaScript) |

Passos de IA e de dados da web usam [créditos de IA](https://docs.brainchat.app/organizacao/creditos-ia.md). Valores dos passos anteriores e do gatilho entram nos campos pelo seletor de variáveis.

## Testar

* Em cada passo, **Testar** roda só aquele passo com os dados do gatilho.
* **Testar gatilho** roda o fluxo do começo até ali e mostra os dados que chegam, para usar como exemplo nos passos seguintes.
* **Registro para testar (opcional)** escolhe um registro real; em chamada externa, use **Testar com este evento** ou **Colar um exemplo em JSON**.
* **Só simular envios e gravações** testa sem mandar mensagens nem gravar nada.
* **Limpar resultados de teste** apaga os resultados mostrados.

## Publicar e versões

Clique em **Publicar**: a mensagem **Fluxo publicado e ligado** confirma. A aba **Versões** guarda cada publicação, com **Em produção** marcando a atual e **Restaurar** para voltar a uma anterior.

## Histórico e métricas

A aba **Histórico** do fluxo mostra cada execução com o resultado de cada passo (**Concluída**, **Concluída com avisos**, **Em andamento**, **Parada**, **Com erro**). **Métricas** resume execuções e falhas.

> [!TIP]
>
> Organize o desenho em **Vertical** ou **Horizontal** em **Orientação do fluxo**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.