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

# Workflows e automações

> Como funcionam os workflows no gu1: gatilhos, condições, ações, standby e criação na UI ou API — no motor de automações gu1 com gatilhos e ações.

## O que é um workflow

No gu1, **workflows** são **automações**: **QUANDO** \[evento] → **SE** \[condições] → **ENTÃO** \[ações]. Configure em **Automações** ou via [API](/pt/api-reference/automations/list-automations) (veja **API Reference** no menu).

<Info>
  Não confunda com o **motor de regras AML**. Regras podem **disparar** um workflow quando fazem match.
</Info>

## Guia (conceitos)

| Tópico                                                  | Descrição                                                                                       |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| [Gatilhos](/pt/workflows/triggers)                      | Cada `triggerType`, filtros e contextos de condição.                                            |
| [Ações](/pt/workflows/actions)                          | Todas as ações do motor e o que leem/escrevem em `event.data`.                                  |
| [Sinergia](/pt/workflows/synergy)                       | Quais gatilhos permitem quais ações e pares ação → próxima ação válidos.                        |
| [Contexto e standby](/pt/workflows/context-and-standby) | Contexto compartilhado, refresh ao retomar, limites do standby, padrões KYC, URLs em templates. |
| [Construir fluxos](/pt/workflows/building-flows)        | Grafo vs passos, ramificações, fan-out, validação ao salvar, teste vs produção.                 |
| [Regras e workflows](/pt/workflows/rules-and-workflows) | Como as regras AML invocam automações (`rule_triggered`).                                       |

## Modos de execução (resumo)

| Modo       | Descrição                                                                                                 |
| ---------- | --------------------------------------------------------------------------------------------------------- |
| **Grafo**  | Nós trigger / condition / action; ramos verdadeiro/falso. Com grafo válido, o motor prioriza o **grafo**. |
| **Passos** | Blocos sequenciais; se as condições do bloco falham, o bloco inteiro é ignorado.                          |

* Conecte saídas **verdadeiro** e **falso** para IF/ELSE real.
* Várias saídas de um nó de **ação:** o motor executa **todas** essas ramificações **em sequência**.

## Standby (breve)

Só entra em pausa com **`runAutomationById`** (ex.: **`POST /automations/:id/run`** com gatilho **execução manual**, regras, agendado). Eventos só reativos **não** pausam mesmo com “espera” marcada.

Veja [Contexto e standby](/pt/workflows/context-and-standby) e a API: [Continuar execução](/pt/api-reference/automations/continue-execution), [Cancelar execução](/pt/api-reference/automations/cancel-execution).

## Criar um workflow (UI)

**Automações** → **Nova** → gatilho e filtros → condições e ações → salvar. O produto valida **sinergia** e forma do grafo ([Sinergia](/pt/workflows/synergy)).

## Teste vs produção

* **`POST .../execute`** — teste com `processEvent` (sem standby).
* **`POST .../run`** — com **`manual_execution`**; **`runAutomationById`**; standby quando aplicável.

## Documentação

* **API Reference** — [List automations](/pt/api-reference/automations/list-automations), etc.
