Visão geralBeta
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.
Como funciona
- Um gatilho dispara. Toda automação começa com um gatilho, por exemplo, Added to audience. 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, 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.
- 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 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, reengajamento | Participação em listas, alterações em contatos, aniversários de datas |
| 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.
-
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.
-
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 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 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.
Usar a API
A API de automações gerencia as automações e lê as execuções delas. Ela exige uma chave de API com Full Access.
| 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. |
| Listar execuções, obter uma execução, estatísticas e estatísticas das etapas | 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.
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 para ativá-la.