Pular para o conteúdo
Docs

Guia prático

Condições de saída e metas

Tire contatos de uma automação no momento em que eles compram ou saem de uma lista de contatos, faça execuções pularem para uma meta e mova contatos entre automações.

Atualizado em 20 de out. de 2026

Normalmente, uma execução percorre as etapas dela até o fim da ramificação. As condições de saída e as metas mudam isso assim que o contato faz algo, onde quer que a execução esteja, inclusive enquanto ela espera: uma condição de saída encerra a execução, e uma meta a leva adiante até a etapa da meta.

Você quer Use
Parar os lembretes de carrinho quando o contato compra Uma condição de saída na compra
Parar uma sequência quando o contato sai da lista de contatos que a iniciou Sair da lista de contatos
Pular os lembretes restantes e enviar um agradecimento Uma meta
Tirar quem comprou de todas as automações promocionais Uma etapa Remove from automations
Interromper a execução de um contato manualmente ou a partir da sua aplicação Cancelar a execução ou remover o contato

As etapas Goal, e as condições de saída, metas e esperas com eventos do workspace ou personalizados, estão incluídas nos planos Pro, Business e Custom. No Pay as you go, salvar uma automação que as adiciona retorna 403 com "error": "plan_required". As automações que já as têm continuam com elas depois de um downgrade.

Condições de saída

As condições de saída ficam na aba Settings da automação, em Exit conditions. Quando uma delas corresponde para um contato, a execução dele nesta automação é cancelada na hora: as etapas em espera são descartadas, e nenhuma outra etapa é executada. O status da execução passa a ser Canceled, com a observação Met an exit condition.

Há dois tipos:

  • Quando algo acontece: um evento do contato, escolhido como um gatilho, com as opções dele. Por exemplo, Custom event purchase enviado com a API de eventos (os eventos do script de rastreamento não encerram execuções), Tag added customer, Contact updated com Field that changed Purchased, ou Unsubscribed. Os eventos personalizados e os pedidos aceitam um filtro opcional, por exemplo, apenas os pedidos com total maior que 50.
  • Quando o contato corresponde: regras sobre o contato, como em uma etapa Condition. Por exemplo, “tem a tag customer” ou “Purchased é verdadeiro”. Elas são verificadas sempre que o contato muda e antes de cada etapa, então um contato que já se enquadra nunca recebe o próximo e-mail, mesmo que a alteração tenha chegado um instante antes.

As condições de saída valem para as execuções já em andamento assim que você as salva, continuam funcionando enquanto a automação está pausada e exigem uma automação do contexto Contact. Uma automação pode ter até 20.

A equipe do Emailit também pode usar como saída Placed an order e Abandoned a cart, do e-commerce, e Removed from segment, de um segmento rastreado, além de usar regras Segment e Purchases nas condições. Esses recursos estão em alfa, como o e-commerce e os segmentos. Os contatos que saem de um segmento porque alguém editou as regras dele não saem da automação.

Sair quando for removido da lista de contatos

Nas automações iniciadas por Added to audience, ative Leave when removed or unsubscribed from the audience that started the run. A execução de um contato é então cancelada quando ele é removido dessa lista, se descadastra dela ou se descadastra de todos os e-mails de marketing, por exemplo, quando a sua loja o remove de uma lista “Abandoned carts” depois de uma compra. A observação da execução é Left the audience. Uma etapa Remove from audience ou Subscribe / unsubscribe da própria execução não encerra essa execução.

As automações do contexto Contact criadas no painel têm essa opção ativada. As automações criadas pela API a têm desativada, a menos que você defina exit_on_audience_removal: true. Sem ela, uma execução continua depois que o contato sai da lista; os e-mails de marketing continuam ignorando os contatos que se descadastraram.

Pela API

Defina settings.exit_conditions ao criar ou atualizar a automação. Cada item é um critério de evento (a chave do gatilho em event e as opções dele) ou { "condition": { "match", "rules" } }:

JSON
{
  "settings": {
    "exit_on_audience_removal": true,
    "exit_conditions": [
      { "event": "contact.on_event", "event_name": "purchase" },
      { "event": "contact.on_event", "event_name": "c:order.completed", "filter": { "match": "all", "rules": [{ "field": "properties.total", "operator": "greater_than", "value": 50 }] } },
      { "event": "contact.tag_added", "tag": "customer" },
      { "condition": { "match": "all", "rules": [{ "field": "custom_fields.purchased", "operator": "is_true" }] } }
    ]
  }
}

Metas

Uma etapa Goal marca um ponto ao qual a execução deve chegar assim que o contato atingir a meta. Quando o contato a atinge, a execução dele pula para lá de onde quer que esteja: as etapas e as esperas no meio do caminho são ignoradas (marcadas como skipped na execução), a meta é marcada como alcançada, e a execução continua com as etapas depois da meta. As metas estão incluídas nos planos Pro, Business e Custom.

Por exemplo, uma sequência do período de teste envia uma dica a cada três dias, com uma meta “Tag added paid” perto do fim, seguida de um e-mail de agradecimento. Um contato que faz upgrade no dia 2 pula as dicas restantes e recebe o agradecimento na hora.

Configuração Observações
Goal is met when Something happens (um evento do contato) ou The contact matches a condition (verificada a cada alteração do contato).
When a contact reaches the goal without meeting it Continue anyway, Wait until the goal is met (por até 365 dias; depois disso, a execução termina) ou End the automation for them.

Uma execução alcança cada meta no máximo uma vez, e as metas dentro de uma ramificação de random split não voltam ao split depois. Como as condições de saída, as metas continuam funcionando enquanto a automação está pausada.

Pela API, uma meta é uma etapa goal: { "event": { "event": "contact.tag_added", "tag": "paid" }, "if_not_met": "continue" } ou { "condition": { ... } }.

Mover contatos entre automações

  • Start automation inicia outra automação para o contato. Ative Move the contact para encerrar a execução atual em seguida.
  • Remove from automations cancela as execuções do contato em outras automações que você escolher, ou em Every other automation.

Por exemplo, quando a sua loja adiciona a tag customer a quem compra pela API, uma automação “Buyers” iniciada por essa tag pode remover essas pessoas de todas as automações promocionais e movê-las para o onboarding:

JSON
{
  "steps": [
    { "key": "bought", "type": "trigger", "trigger": "contact.tag_added", "config": { "tag": "customer" } },
    { "key": "leave", "type": "action", "action": "exit_automation", "config": { "all": true } },
    { "key": "onboard", "type": "action", "action": "run_automation", "config": { "automation_id": "aut_3Mv8Xq2nKp5Lt", "exit_current": true } }
  ],
  "connections": [
    { "from": "bought", "to": "leave", "branch": "default" },
    { "from": "leave", "to": "onboard", "branch": "default" }
  ]
}
Wait until, Goal, Remove from automations e outras.
Veja por que uma execução foi cancelada e cancele execuções.

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.