> For the complete documentation index, see [llms.txt](https://docs.hominy.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hominy.com.br/guia-do-produto/automacoes.md).

# Automações

As **automações** fazem o trabalho repetitivo rodar sozinho. Cada automação segue o padrão **gatilho → condições → ação**: *quando* algo acontece, *se* certas condições baterem, *então* execute uma ação.

São configuradas visualmente no builder de cada fluxo, sem código.

## Gatilhos (quando)

| Gatilho                                 | Dispara quando…                                                     |
| --------------------------------------- | ------------------------------------------------------------------- |
| **Card criado**                         | um card é criado no fluxo.                                          |
| **Card entra na fase**                  | um card chega a uma fase específica.                                |
| **Card sai da fase**                    | um card deixa uma fase.                                             |
| **Campo atualizado**                    | um campo específico muda (requer indicar o campo).                  |
| **Atividade recorrente**                | em uma frequência agendada (a cada 30 min, hora, dia, semana, mês). |
| **Alerta (SLA)**                        | um card estoura o prazo/SLA configurado.                            |
| **Cards conectados movidos**            | um card conectado (pai/filho) é movido.                             |
| **Botão clicado na interface** *(Beta)* | um botão de ação no card é acionado.                                |
| **E-mail recebido** *(Beta)*            | um e-mail chega vinculado ao card.                                  |
| **Resposta HTTP recebida** *(Beta)*     | uma chamada HTTP da automação retorna.                              |

## Condições (se)

As condições filtram quando a ação roda. Suportam **grupos E/OU** e operadores:

`igual`, `diferente`, `contém`, `começa com`, `termina com`, `maior que`, `menor que`, `está vazio`, `não está vazio`.

## Ações (então)

| Ação                          | O que faz                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------ |
| **Mover card**                | move o card para outra fase.                                                                           |
| **Atualizar campo**           | grava um valor num campo do card/registro.                                                             |
| **Criar card**                | cria um card novo.                                                                                     |
| **Criar card conectado**      | cria um card vinculado (pai/filho).                                                                    |
| **Mover card pai**            | move o card pai do card atual.                                                                         |
| **Distribuir responsáveis**   | atribui pessoas automaticamente.                                                                       |
| **Aplicar fórmula**           | calcula e grava um valor.                                                                              |
| **Aplicar SLA**               | aplica regras de prazo.                                                                                |
| **Requisição HTTP**           | chama uma API externa (com proteção anti-SSRF).                                                        |
| **Enviar template de e-mail** | dispara um e-mail com variáveis do card.                                                               |
| **Enviar mensagem (chat)**    | posta no **Slack / Discord / Teams / Telegram** (veja [Integrações](/guia-do-produto/integracoes.md)). |
| **Peça à IA**                 | usa IA (Gemini) para gerar conteúdo.                                                                   |
| **Enviar tarefa**             | cria uma tarefa atribuível.                                                                            |

## Variáveis nos templates

Ações de texto (e-mail, mensagem de chat, HTTP) aceitam **placeholders** que são substituídos pelos dados do card no momento da execução:

```
Card {{card.title}} entrou na fase. Responsável: {{card.assignees}}.
Valor: {{field.valor_total}}
```

* `{{card.*}}` — propriedades do card (título, id, número, prazo, etc.).
* `{{field.NOME}}` — o valor de um campo dinâmico.

## Como as automações rodam

A maioria das automações roda **de forma síncrona** no momento da ação (criar/mover/atualizar um card). As automações **agendadas** (recorrentes e de alerta/SLA) são processadas por um **worker BullMQ** que varre os tenants periodicamente.

> **Prevenção de loop:** cada execução carrega um `chain_depth` com **limite de 5 cascatas** — uma automação que dispara outra não entra em loop infinito.

Cada execução é registrada com status (sucesso, erro, ignorada), visível na tela de **logs de automação** do fluxo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hominy.com.br/guia-do-produto/automacoes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.