Etapas de automação

As etapas são o que uma execução faz depois que o gatilho dela dispara. Esta página lista todas as etapas por contexto, com as configurações e as regras delas, explica como as etapas se conectam em ramificações e mostra o que acontece quando uma etapa falha.

Adicionar e configurar etapas

Na aba Editor da automação (disponível enquanto a automação está em rascunho ou pausada):

• Adicionar uma etapa: selecione o botão de mais abaixo da última etapa, ou abaixo de Yes ou No em uma condição. Pesquise no seletor ou escolha em Actions.
• Configurar uma etapa: selecione-a no canvas. As configurações dela abrem em um painel lateral. Depois que a etapa for executada, uma aba Stats aparece ao lado de Configure.
• Remover uma etapa: selecione-a e selecione Delete step no painel lateral.
• Salvar: selecione Save. As etapas com problemas ficam destacadas com uma contagem de erros.

Etapas por contexto

As configurações das etapas podem incluir placeholders como {{contact.first_name}} ou {{payload.object.to}}, preenchidos em cada execução. Consulte Dados disponíveis para as etapas.

Send email

Envia um e-mail montado a partir de um dos seus templates.

Regras:

• O template é renderizado com o Temple. Nas automações do contexto Contact, os campos do contato ficam disponíveis diretamente, então {{first_name}}, {{email}} e {{custom_fields.plan}} funcionam. Todos os contextos também têm {{contact.*}}, {{payload.*}} e {{meta.*}}. As tags de mesclagem de campanhas, como {{cf.plan}} e {{unsubscribe_url}}, não são preenchidas.
• O remetente deve estar em um domínio verificado. A substituição em From ou o remetente do template devem usar um domínio verificado no workspace. Save verifica as substituições, e a etapa falha durante a execução se o domínio não estiver verificado.
• Um assunto e um conteúdo são obrigatórios, vindos do template ou das substituições.
• Cada e-mail custa 1 crédito, além dos 3 créditos da execução.
• Ela não verifica as inscrições. O e-mail é enviado mesmo que o contato tenha se descadastrado das suas listas de contatos. Os endereços suprimidos continuam bloqueados na entrega, e os workspaces em sandbox só podem enviar para os endereços das contas dos membros.
• Sem link de descadastro nem carregamentos e cliques. Os e-mails de automações não recebem cabeçalhos List-Unsubscribe, e os carregamentos e cliques não são rastreados.

As Stats da etapa acompanham cada e-mail enviado por ela em Accepted e Delivered e contam os bounces, as falhas e as reclamações.

Wait / Delay

Pausa a execução antes da próxima etapa.

Enquanto uma execução espera, ela continua em Running, e a etapa de espera aparece como aguardando. Pausar a automação não interrompe as execuções que estão esperando.

Condition (If/Else)

Envia a execução para a ramificação Yes quando as regras correspondem, ou para a ramificação No quando não correspondem.

• Regras: um campo, um operador e um valor, combinados com All rules match ou Any rule matches. Os operadores são os mesmos dos filtros de gatilho.
• Campos: nas automações do contexto Contact, Email, First name, Last name e os seus campos personalizados. Nas automações do contexto Email, os campos do evento do gatilho. Pela API, field pode ser qualquer caminho, com os prefixos contact., email., payload. e meta..
• Ramificações: adicione a próxima etapa em Yes, em No ou nas duas. Uma ramificação sem etapa termina a execução ali.

Add to audience

Contexto Contact. Inscreve o contato da execução na lista escolhida em Audience. Se o contato tiver se descadastrado dela, ele é inscrito de novo. A etapa falha se a lista tiver atingido o limite de inscritos. Ela não inicia automações Added to audience.

Remove from audience

Contexto Contact. Desativa a inscrição do contato na lista escolhida em Audience. O contato continua na lista como inscrito descadastrado, ao contrário de Remove from audience no painel, que exclui a participação.

Edit contact

Contexto Contact. Define um ou mais campos no contato da execução. Adicione uma linha por campo, com Field name e Value:

Os valores podem usar placeholders, por exemplo, {{payload.object.audience.name}}. A alteração não envia um evento contact.updated, então não inicia automações Contact updated nem webhooks.

Forward email

Contextos Email e Event. Envia uma cópia do e-mail da execução, com o conteúdo e os anexos originais, para o endereço em Forward to. O assunto passa a ser “Fwd: ” seguido do assunto original. O e-mail deve vir de um domínio de envio verificado no workspace, e cada encaminhamento custa 1 crédito. Consulte Encaminhar com automações.

Add to suppressions

Contextos Email e Event. Adiciona um endereço à sua lista de supressão com o tipo recipient, que bloqueia todos os envios para ele, e com o motivo informado em Reason (padrão automation). Nas automações do contexto Email, o endereço é o destinatário do e-mail. Nas automações do contexto Event, defina email pela API, por exemplo, {{payload.email}}. A etapa envia um evento suppression.created.

Remove from suppressions

Contextos Email e Event. Remove o endereço da lista de supressão: o destinatário do e-mail nas automações do contexto Email, ou o email definido pela API nas automações do contexto Event.

Create contact

Contextos Email e Event. Cria um contato e, se você escolher uma lista em Audience (optional), inscreve o contato nela.

• Nas automações do contexto Email, o contato é o endereço do destinatário do e-mail. Nos e-mails recebidos, é o endereço para o qual o e-mail foi enviado. Para criar um contato para o remetente, defina email como {{email.mail_from}} pela API.
• Nas automações do contexto Event, defina email e, se quiser, first_name pela API.
• Se o contato já existir, ele é mantido como está e apenas inscrito na lista.
• A etapa não inicia automações Added to audience.

Etapas exclusivas da API

Estas etapas podem ser adicionadas pela API, mas ainda não no editor do painel. Elas funcionam em todos os contextos.

{
  "key": "notify-crm",
  "type": "action",
  "action": "call_webhook",
  "config": {
    "url": "https://crm.acme.com/hooks/new-subscriber",
    "method": "POST",
    "headers": { "Authorization": "Bearer crm_token" },
    "body": { "email": "{{contact.email}}", "source": "emailit" }
  }
}

Ramificações e conexões

Pela API, uma automação é uma lista de steps, cada uma com uma key única, e uma lista de connections da chave de uma etapa para a próxima:

{
  "steps": [
    { "key": "trigger-1", "type": "trigger", "trigger": "contact.added_to_audience", "config": {} },
    { "key": "is-pro", "type": "action", "action": "condition", "config": {
      "filter": { "match": "all", "rules": [{ "field": "custom_fields.plan", "operator": "equals", "value": "pro" }] }
    } },
    { "key": "send-pro", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome-pro" } },
    { "key": "send-free", "type": "action", "action": "send_email", "config": { "type": "template", "template_id": "welcome-free" } }
  ],
  "connections": [
    { "from": "trigger-1", "to": "is-pro", "branch": "default" },
    { "from": "is-pro", "to": "send-pro", "branch": "yes" },
    { "from": "is-pro", "to": "send-free", "branch": "no" }
  ]
}

• branch é default para uma próxima etapa normal, yes ou no depois de uma condição e a chave de uma variante depois de um random split.
• Uma condição só segue a ramificação que escolheu. Uma conexão default saindo de uma condição nunca é seguida.
• Uma etapa com várias conexões de saída na mesma ramificação inicia todas elas, e as ramificações são executadas lado a lado.
• Toda etapa deve ser alcançável a partir de um gatilho. Nas automações dos contextos Contact e Email com vários gatilhos, todos os gatilhos devem se conectar à mesma primeira etapa.
• Envie steps e connections juntos ao atualizar uma automação. As etapas cujas chaves não mudam mantêm o histórico e as estatísticas.

Quando uma etapa falha

Por padrão, uma etapa com falha faz a execução inteira falhar, e as etapas restantes não são executadas. O erro fica salvo na etapa, e você pode lê-lo nos detalhes da execução na aba Runs. Defina on_step_failure como skip nas settings da automação pela API para que as execuções continuem depois de etapas com falha.

Consulte Execuções e estatísticas para saber como encontrar e corrigir execuções com falha.

Veja também