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

# Editor de Flows

> Monte um flow em blocos: escolha o gatilho, ligue os blocos, teste, publique e pause.

## Para que serve

No editor você desenha o caminho do flow: quando ele começa, o que envia e o que faz com o contato.

Aparece se a agência liberou o módulo Flows para a organização.

## Quem pode

* **Dono e Admin** editam, ativam, desativam e publicam.
* **Supervisor** abre em leitura e pode **Testar** e **Executar para um contato**.
* Os demais papéis não editam.

## Onde clicar

Em **Flows › Meus flows**, clique no flow, ou em **Criar flow** para um novo em branco. O editor tem duas abas: **Canvas** (o desenho) e **Gatilho** (quando começa).

## Passo a passo

**1. Escolha o gatilho**

Na aba **Gatilho**, abra o **Catálogo de gatilhos** e busque em **Buscar gatilho…**. Os gatilhos são agrupados em **MENSAGENS**, **CONTATO**, **AGENDA**, **TAREFAS**, **KANBAN**, **SLA**, **FORMULÁRIOS**, **PAGAMENTOS**, **LIGAÇÕES** e **INTEGRAÇÕES**. Exemplos: **Mensagem recebida**, **Tag adicionada**, **Webhook**, **Manual**. Escolha também em quais conexões ele vale. Um flow pode ter mais de um gatilho; qualquer um inicia o flow.

**2. Adicione blocos**

Na aba **Canvas**, abra o painel **Adicionar nó** (atalho Tab) e arraste um bloco para o desenho. Ligue um bloco no outro e clique nele para ajustar. Há categorias como **Envio WhatsApp**, **Ações**, **Calendário**, **Tarefas**, **Kanban** e **Controle de Fluxo**.

**3. Use os blocos principais**

**Enviar mensagem**, **Enviar mídia**, **Botões**, **Enviar template** (modelo aprovado, para fora das 24 h), **Condição** (sim ou não), **Aguardar** (pausa por um tempo), **Esperar resposta**, **Adicionar tag**, **Criar tarefa**, **Criar card**, **Passar para pessoa** e **Chamar webhook**.

**4. Ajuste as opções do flow**

Há as seções **Quando o contato responde** (**Parar quando o contato responder**) e **Objetivo** (**Encerrar quando o objetivo acontecer**), que fazem quem espera terminar na hora.

**5. Confira antes de publicar**

Releia os blocos e as mensagens. Se a tela mostrar "Testar está em manutenção.", o teste não está disponível agora. **Executar para um contato** envia mensagens de verdade e avisa: "Isto envia mensagens e cria registros DE VERDADE para o contato." Use só com um contato seu.

**6. Publique**

Clique em **Publicar**. A janela mostra o que muda desde a versão no ar e aceita uma nota em **O que mudou (opcional, aparece no histórico)**. Confirme em **Publicar v…**.

**7. Ative ou pause**

O botão liga/desliga ao lado de **Ativo** / **Inativo** ativa ou pausa o flow. Em **Meus flows**, o cartão de um flow desativado mostra "pausado".

## O que acontece depois

* O selo mostra **Publicado · v1 — tudo no ar** ou "alterações não publicadas". Sem publicar, o editor guarda **Rascunho salvo**.
* Execuções em andamento continuam na versão antiga até terminar. Quem entra depois já usa a nova.
* Em **Versões**, **Restaurar** copia uma versão antiga para o rascunho. Nada vai ao ar até você publicar.

## Erros comuns

* **Escolha ao menos uma conexão na aba Gatilho para ativar o flow.**
* **As conexões escolhidas saíram da organização ou estão desligadas.** Escolha outra na aba **Gatilho**.
* **Este gatilho ainda não dispara no motor de Flows** ou **depende do Call Center**. Escolha outro para ativar.
* **O módulo Pagamentos está desligado nesta organização** e **Conecte a Stripe da empresa em Ajustes › Pagamentos** (gatilhos de pagamento).
* **Esta automação está ligada a uma conexão que não existe mais.** Use **Escolher conexão**.
* **Campos que não existem neste flow.** Troque ou apague os campos; ou use **Publicar mesmo assim** (saem vazios na mensagem).
* **Falha ao publicar — a v… continua no ar.** Tente de novo.
* **Testar está em manutenção.** Mensagem da tela: o teste não está disponível enquanto ela aparecer.

## Próximo passo

* [Execuções e erros dos Flows](https://docs.stchat.app/subcontas/flows-execucoes-e-erros.md)
* [Como criar um flow por receita](https://docs.stchat.app/subcontas/criar-flow-por-receita.md)
* [Flows: visão geral](https://docs.stchat.app/subcontas/flows.md)


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