# Automações

> As automações executam etapas, como enviar um e-mail, esperar ou atualizar um contato, quando um gatilho dispara. Conheça os contextos, os status, as execuções, os créditos e a API.

Uma automação é um fluxo que começa sozinho: quando um gatilho dispara, como um contato entrando em uma lista de contatos ou um e-mail dando bounce, o Emailit inicia uma execução que percorre as etapas que você conectou, como enviar um e-mail, esperar um dia ou atualizar o contato. Use automações para e-mails de boas-vindas, sequências de onboarding, e-mails de aniversário, encaminhamentos e alertas.

> **As automações estão em beta:** As automações funcionam em todos os workspaces, mas algumas opções ainda estão sendo finalizadas. Quando o painel e a API são diferentes, estas páginas indicam isso.

## Como funciona

1. **Um gatilho dispara.** Toda automação começa com um gatilho, por exemplo, **Added to audience**. Filtros opcionais o restringem.
2. **O Emailit inicia uma execução** para o contato ou o e-mail que a causou e cobra 3 créditos.
3. **A execução percorre as etapas** conectadas ao gatilho, uma após a outra. As etapas **Wait** pausam a execução, e as etapas **Condition** a enviam para uma ramificação **Yes** ou **No**.
4. **A execução termina** quando chega à última etapa da sua ramificação, ou falha se uma etapa falhar.

Você monta o fluxo em um canvas no painel ou o envia para a API como uma lista de etapas e conexões. Consulte [Gatilhos](/pt/docs/automations/triggers/) e [Etapas](/pt/docs/automations/steps/).

## Contextos

Cada automação tem um contexto, que define a que se refere uma execução e quais gatilhos e etapas ficam disponíveis. Você o escolhe ao criar a automação, e ele não pode ser alterado depois.

| Contexto | Rótulo | Cada execução se refere a | Bom para | Gatilhos |
| --- | --- | --- | --- | --- |
| **Contact** | Easy | Um contato | Séries de boas-vindas, onboarding, reengajamento | Participação em listas, alterações em contatos, aniversários de datas |
| **Email** | Medium | Um e-mail | Tratamento de respostas, encaminhamento automático, alertas de bounce | Eventos de e-mail, como entregue, com bounce ou recebido |
| **Event** | Advanced | Uma chamada à API | Fluxos acionados pela API, integrações personalizadas | Um gatilho manual que você chama pela API |

No painel, o contexto **Event** mostra o selo **Soon** e ainda não pode ser selecionado. Você pode criar automações do contexto Event pela API.

## Criar uma automação

1. **Comece.** Acesse **Email Marketing → Automations** e selecione **New automation**.

2. **Escolha o contexto.** Escolha **Contact** ou **Email**.

3. **Escolha um modelo.** Escolha uma das [receitas prontas](/pt/docs/automations/recipes/) ou **Start from scratch** para um canvas em branco só com um gatilho.

4. **Dê um nome.** Preencha **Name** e, se quiser, **Description**, e depois selecione **Create**. A automação abre como rascunho.

5. **Monte o fluxo.** Na aba **Editor**, selecione o gatilho e cada etapa para configurá-los e adicione etapas com os botões de mais. Selecione **Save**.

6. **Inicie a automação.** Selecione **Start**. A partir de então, cada gatilho correspondente inicia uma execução.

A página da lista tem abas para as automações **Contact**, **Email** e **Event** e mostra **Name**, **Status**, o horário em **Last triggered** e a data em **Created** de cada uma.

## Status

| Status | Os gatilhos iniciam execuções | Editável no painel | Como chegar a ele |
| --- | --- | --- | --- |
| **Draft** | Não | Sim | Toda automação nova começa como rascunho. |
| **Running** | Sim | Não | Use **Start** em uma automação em rascunho ou pausada. |
| **Paused** | Não | Sim | Use **Pause** em uma automação em execução. **Start** a retoma. |
| **Stopped** | Não | Não | Apenas com o endpoint [stop](/pt/docs/api-reference/automations/stop/) da API, que também cancela todas as execuções em andamento. |

Pausar impede que novas execuções comecem, mas as execuções já em andamento continuam, incluindo as que estão esperando em uma etapa **Wait**. **Delete**, no menu no topo da automação, a exclui em qualquer status.

### Regras de edição

A aba **Editor** só fica disponível enquanto a automação está em rascunho ou pausada. Em uma automação em execução, a aba mostra **Pause to edit**.

**Save** verifica o fluxo inteiro e destaca as etapas que precisam de atenção, por exemplo, uma etapa **Send email** sem template ou uma espera de mais de 30 dias. Corrija-as e salve de novo antes de selecionar **Start**: iniciar não executa as verificações de novo.

## Execuções

Uma execução é uma passagem pela automação para um contato, um e-mail ou uma chamada à API. Cada execução tem um status:

| Status da execução | Significado |
| --- | --- |
| **Running** | A execução está percorrendo as etapas ou esperando. |
| **Completed** | Todas as etapas do caminho da execução terminaram. |
| **Failed** | Uma etapa falhou, ou o workspace não tinha créditos suficientes quando a execução começou. |
| **Canceled** | A automação foi interrompida pela API enquanto a execução estava em andamento. |

Por padrão, cada gatilho inicia uma nova execução, mesmo que o mesmo contato ou e-mail já tenha uma em andamento. O mesmo evento nunca inicia duas execuções de uma automação. Consulte [Execuções e estatísticas](/pt/docs/automations/runs/) para o histórico de execuções e a depuração.

## Créditos

| Ação | Créditos |
| --- | --- |
| Cada execução | 3, cobrados quando a execução começa |
| Cada e-mail enviado por uma etapa **Send email** | 1 |
| Cada e-mail enviado por uma etapa **Forward email** | 1 |

Se o workspace não tiver 3 créditos quando um gatilho disparar, a execução é criada com o status **Failed** e o motivo `insufficient_credits` no `meta` dela. Se os créditos acabarem no meio de uma execução, a etapa **Send email** ou **Forward email** falha. Consulte [Créditos](/pt/docs/billing/credits/).

## Usar a API

A [API de automações](/pt/docs/api-reference/automations/) gerencia as automações e lê as execuções delas. Ela exige uma chave de API com **Full Access**.

| Endpoint | Use para |
| --- | --- |
| [Criar](/pt/docs/api-reference/automations/create/), [atualizar](/pt/docs/api-reference/automations/update/), [obter](/pt/docs/api-reference/automations/get/), [listar](/pt/docs/api-reference/automations/list/) e [excluir](/pt/docs/api-reference/automations/delete/) | Gerenciar automações. As etapas e as conexões são enviadas juntas. |
| [Iniciar](/pt/docs/api-reference/automations/start/), [pausar](/pt/docs/api-reference/automations/pause/) e [interromper](/pt/docs/api-reference/automations/stop/) | Alterar o status. |
| [Disparar uma execução](/pt/docs/api-reference/automations/trigger/) | Disparar um gatilho **Manual**, com um `payload` opcional. A automação precisa estar em execução. Isso só é possível pela API. |
| [Listar execuções](/pt/docs/api-reference/automations/runs/), [obter uma execução](/pt/docs/api-reference/automations/run/), [estatísticas](/pt/docs/api-reference/automations/stats/) e [estatísticas das etapas](/pt/docs/api-reference/automations/step-stats/) | Ler o histórico de execuções e os resultados por etapa. |

A API também aceita `settings` de automação que o painel ainda não mostra:

| Configuração | Padrão | Efeito |
| --- | --- | --- |
| `allow_reentry` | `true` | Defina como `false` para ignorar novas execuções de um contato ou e-mail que já tem uma execução em andamento. |
| `max_concurrent_runs` | `0` (sem limite) | Ignora novas execuções enquanto houver esse número de execuções em andamento. |
| `cooldown_seconds` | `0` | Ignora novas execuções de um contato ou e-mail que iniciou uma execução dentro desse número de segundos. |
| `on_step_failure` | `stop` | `stop` faz a execução falhar quando uma etapa falha. `skip` deixa a execução continuar. |

As execuções ignoradas não são criadas e não usam créditos.

```bash
curl https://api.emailit.com/v2/automations \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "contact",
    "name": "Welcome email",
    "settings": { "allow_reentry": false },
    "steps": [
      { "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
      { "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome" } }
    ],
    "connections": [
      { "from": "trigger-1", "to": "send_email-1", "branch": "default" }
    ]
  }'
```

A automação é criada como rascunho. Chame [Iniciar uma automação](/pt/docs/api-reference/automations/start/) para ativá-la.

## Próximos passos

  - [Gatilhos](/pt/docs/automations/triggers/): Todos os gatilhos e as opções deles.
  - [Etapas](/pt/docs/automations/steps/): Todas as etapas, as configurações delas e como as ramificações funcionam.
  - [Receitas](/pt/docs/automations/recipes/): Os seis modelos prontos.
  - [Execuções e estatísticas](/pt/docs/automations/runs/): Acompanhe as execuções e depure as falhas.

---
Fonte: https://emailit.com/pt/docs/automations/