Visão geralBeta
Automações
As automações executam etapas, como enviar um e-mail, esperar ou adicionar uma tag a um contato, quando um gatilho dispara. Conheça os contextos, as saídas, as metas, 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, recebendo uma tag ou atingindo uma pontuação de lead, o Emailit inicia uma execução que percorre as etapas que você conectou, como enviar um e-mail, esperar até uma data, verificar uma condição ou atualizar o contato. Use automações para séries de boas-vindas e sequências de onboarding, lembretes de carrinho e de webinar, lead scoring, e-mails de aniversário, encaminhamentos e alertas.
Como funciona
- Um gatilho dispara. Toda automação começa com um gatilho, por exemplo, Added to audience ou Tag added. Configurações e filtros opcionais o restringem.
- O Emailit inicia uma execução para o contato ou o e-mail que a causou e cobra 3 créditos.
- A execução percorre as etapas conectadas ao gatilho. As etapas Time delay e Wait until a pausam, as etapas Condition a enviam para uma ramificação Yes ou No, e as etapas de ação enviam e-mails, alteram o contato ou chamam outros sistemas.
- A execução termina quando chega à última etapa da sua ramificação, a uma etapa End automation ou a uma condição de saída, ou falha se uma etapa falhar.
Duas coisas podem mover uma execução sem que ela chegue à próxima etapa: uma condição de saída tira o contato assim que corresponde (por exemplo, quando ele compra), e uma etapa de meta puxa a execução para a meta quando o contato a atinge. As etapas de meta estão incluídas nos planos Pro, Business e Custom. Consulte Condições de saída e metas.
Você monta o fluxo em um canvas no painel ou o envia para a API ou para o servidor MCP como uma lista de etapas e conexões. Consulte Gatilhos e Etapas.
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, lembretes de carrinho e de webinar, lead scoring | Listas de contatos, tags, pontuação, alterações em contatos, datas, aberturas e cliques, formulários, eventos personalizados |
| 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
-
Comece. Acesse Email MarketingAutomations e selecione New automation.
-
Escolha o contexto. Escolha Contact ou Email.
-
Escolha um modelo. Escolha uma das receitas prontas ou Start from scratch para um canvas em branco só com um gatilho. Adicione a primeira etapa com o botão de mais abaixo do gatilho.
-
Dê um nome. Preencha Name e, se quiser, Description, e depois selecione Create. A automação abre como rascunho.
-
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.
-
Defina as saídas. Na aba Settings, adicione condições de saída, por exemplo, “uma compra acontece”, e escolha o que acontece quando um contato já está na automação. Nas novas automações do contexto Contact, a execução de um contato termina quando ele é removido ou se descadastra da lista de contatos que a iniciou.
-
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 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 Time delay ou Wait until. As condições de saída e as metas delas continuam funcionando enquanto a automação está pausada. 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. A aba Settings pode ser alterada em qualquer status, e as novas condições de saída valem para as execuções já em andamento.
Save verifica o fluxo inteiro e destaca as etapas que precisam de atenção, por exemplo, uma etapa Send email sem template ou uma etapa Wait until sem data. Corrija-as e salve de novo antes de selecionar Start: iniciar um fluxo salvo não executa as verificações de novo. Com alterações não salvas, Start as salva primeiro, executa as mesmas verificações e só inicia quando elas passam.
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 | A execução chegou ao fim do caminho dela ou a uma etapa End automation, ou passou para outra automação. |
| Failed | Uma etapa falhou, ou o workspace não tinha créditos suficientes quando a execução começou. |
| Canceled | Uma condição de saída correspondeu, o contato saiu da lista de contatos, alguém cancelou a execução ou removeu o contato, outra automação o removeu, ou a automação foi interrompida. |
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. Você pode cancelar uma execução na aba Runs. Consulte Execuções e estatísticas 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 |
Os e-mails de marketing ignorados porque o contato se descadastrou não usam créditos. 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.
Usar a API
A API de automações gerencia as automações e as execuções delas. Ela exige uma chave de API com Full Access. As mesmas operações são ferramentas do servidor MCP, então um assistente de IA pode montar um fluxo inteiro a partir de uma descrição.
| Endpoint | Use para |
|---|---|
| Criar, atualizar, obter, listar e excluir | Gerenciar automações. As etapas e as conexões são enviadas juntas. |
| Iniciar, pausar e interromper | Alterar o status. |
| Disparar uma execução | Disparar um gatilho Manual, com um payload opcional. A automação precisa estar em execução. Isso só é possível pela API. |
| Cancelar uma execução e remover um contato | Interromper uma execução, ou todas as execuções de um contato nesta automação. |
| Listar execuções, as execuções de um contato, obter uma execução, estatísticas e estatísticas das etapas | Ler o histórico de execuções e os resultados por etapa. |
As settings da automação, também na aba Settings:
| Configuração | Padrão | Efeito |
|---|---|---|
exit_conditions |
nenhuma | Cancela a execução de um contato assim que um evento ou uma condição corresponde. Consulte Condições de saída. |
exit_on_audience_removal |
false (true nas automações do contexto Contact criadas no painel) |
Cancela uma execução quando o contato é removido ou se descadastra da lista de contatos que a iniciou. |
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 continua depois da etapa com falha (depois de uma condição com falha, segue por No). |
As execuções ignoradas não são criadas e não usam créditos.
curl https://api.emailit.com/v2/automations \
-X POST \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"context": "contact",
"name": "Cart reminder",
"settings": {
"exit_on_audience_removal": true,
"exit_conditions": [{ "event": "contact.tag_added", "tag": "customer" }]
},
"steps": [
{ "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": { "audience_id": "aud_5hJ2kL8mNp4Qr" } },
{ "key": "wait-1", "type": "action", "action": "wait", "config": { "seconds": 3600 } },
{ "key": "send_email-1", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "cart-reminder" } }
],
"connections": [
{ "from": "trigger-1", "to": "wait-1", "branch": "default" },
{ "from": "wait-1", "to": "send_email-1", "branch": "default" }
]
}'A automação é criada como rascunho. Chame Iniciar uma automação para ativá-la.