Condições, ramificações e atrasos

Os gatilhos iniciam uma automação e as ações fazem o trabalho. As etapas deste artigo decidem o que acontece no meio: qual caminho um membro segue, quando a próxima etapa é executada e com quais dados as etapas seguintes trabalham.

Abrir automações

Onde encontrar estas etapas

No editor, abra a biblioteca e mude para a aba Ações. As etapas deste artigo ficam no topo, em uma seção própria chamada Controle. Arraste uma delas para a tela ou clique nela e depois conecte-a como qualquer outra etapa.

Algumas regras valem para todas as etapas:

• A entrada fica à esquerda e as saídas ficam à direita. Etapas com mais de uma saída dão nome a cada saída, por exemplo Sim e Não.
• Cada entrada aceita uma conexão. Se você desenhar uma segunda linha para a mesma entrada, ela substitui a primeira. Para juntar dois caminhos, use Mesclar.
• Uma linha não pode voltar a uma etapa anterior. O editor não deixa você desenhá-la. Para repetir etapas, use Repetir.
• Uma saída sem nada conectado simplesmente encerra esse caminho.

Clique em uma etapa para abrir as configurações dela à direita. Campos marcados com uma estrela são obrigatórios. Quando a configuração de uma etapa tem um problema, o editor a marca com um aviso amarelo.

Criar uma automação

Verificar regras: Condição, Filtrar e Comparar

Como as regras funcionam

Condição e Filtrar verificam uma lista de regras. Cada regra tem uma chave, um operador e um valor. Adicionar regra adiciona uma, e o X ao lado da chave a remove.

A chave diz o que verificar:

• Um campo dos dados que a automação carrega, por exemplo email ou um campo que o gatilho entrega.
• member. seguido de um campo de membro, por exemplo member.email ou member.first_name.
• member.cf_ seguido do ID de um campo personalizado. Ele lê o valor como está armazenado: para um campo de escolha, é o valor da opção, não o rótulo dela, e um campo de data entrega a data armazenada. Um campo sem valor conta como vazio.
• member.tags ou member.groups. Os operadores mudam para tem e não tem, e você escolhe a tag ou o grupo em uma lista.
• Um valor de engajamento de e-mail, por exemplo email.opened_automation (1 quando o membro abriu um e-mail desta automação, senão 0), email.opened_this_step (um e-mail da etapa de e-mail mais próxima antes desta), email.opened_ever, email.opened_days_ago ou email.opens_7d. Os mesmos valores existem para cliques, por exemplo email.clicks_30d.

O campo da chave sugere esses valores enquanto você digita, incluindo os seus campos personalizados pelo nome. Ao escolher um, ele preenche member.cf_ e o ID, e abaixo da regra uma dica dá o nome do campo, por exemplo "Campo personalizado: Plano".

Os operadores são é igual a, não é igual a, contém, não contém, em (lista separada por vírgulas), não em (lista separada por vírgulas), está vazio, não está vazio e as comparações numéricas >, ≥, < e ≤. Tenha em mente:

• é igual a compara os valores como texto.
• contém procura o valor dentro do texto e diferencia maiúsculas de minúsculas.
• em (lista separada por vírgulas) aceita vários valores separados por vírgulas, por exemplo gold, silver, e é atendida quando a chave corresponde a um deles.
• As comparações numéricas só são atendidas quando os dois lados são números.

Correspondência decide como as regras se somam: Todas as regras devem ser atendidas ou Qualquer regra atendida.

Condição

Condição envia o membro por uma de duas saídas: Sim quando as regras são atendidas e Não quando não são. Sem nenhuma regra, toda execução segue pela saída Sim, e a etapa mostra Sempre sim.

Use-a para decisões reais entre uma coisa e outra, por exemplo um e-mail de boas-vindas para clientes novos e outro diferente para clientes que voltam.

Filtrar

Filtrar tem uma única saída. Em Manter quando você define as regras, e Correspondência funciona como acima. Quando as regras são atendidas, o caminho continua. Quando não são, o caminho para nesta etapa e a etapa conta como ignorada na execução. Sem regras, tudo passa.

Use Filtrar quando só um resultado importa, por exemplo "continuar só para membros do grupo Premium".

Comparar

Comparar verifica exatamente dois valores um contra o outro:

• Primeiro valor (obrigatório) e Segundo valor aceitam, cada um, um nome de campo dos dados, member. mais um campo de membro, member.cf_ mais o ID de um campo personalizado, um valor de e-mail como email.opens_7d, um marcador como {{score}} ou um valor fixo como 10. Este campo não faz sugestões. O ID de um campo personalizado é o do marcador {cf_…} dele, veja Gatilhos e ações.
• Operador oferece é igual a, não é igual a, contém, maior que, maior ou igual, menor que e menor ou igual.

As saídas são Corresponde e Sem correspondência.

Dividir e juntar caminhos: Dividir e Mesclar

Dividir

Dividir abre o fluxo em vários caminhos. Número de ramificações define entre 2 e 5 saídas, chamadas Caminho 1, Caminho 2 e assim por diante. Cada caminho recebe os mesmos dados e segue por conta própria. Um atraso em um caminho segura só esse caminho.

Mesclar

Mesclar junta os caminhos de novo. Número de rotas de entrada define entre 2 e 5 entradas. Continuar quando decide como ela se comporta:

• Cada caminho continua de forma independente é o padrão. Cada caminho que chega continua sozinho pelas etapas depois de Mesclar, então essas etapas são executadas uma vez para cada caminho.
• Todas as rotas chegaram aguarda até que um caminho tenha chegado em cada entrada conectada e então continua uma única vez. Os dados de todos os caminhos são combinados. Quando dois caminhos trazem o mesmo campo, vale o do caminho que chegou por último. A espera também cobre caminhos que contêm um Atraso ou Aguardar até a data.

Se um caminho nunca chegar, por exemplo porque um Filtrar o parou ou uma Condição mandou o membro para outro lugar, Mesclar continua com os caminhos que chegaram assim que nada mais na execução estiver em andamento ou aguardando.

Aguardar: Atraso e Aguardar até a data

Atraso

Atraso pausa o caminho por um tempo fixo. Defina Duração (pelo menos

1. e Unidade: Minutos, Horas ou Dias. Um novo Atraso começa com 1 hora. Se a duração estiver vazia, o editor avisa "O atraso não tem duração."

Aguardar até a data

Aguardar até a data pausa até uma data que vem dos dados:

• Campo de data (obrigatório) indica o campo que contém a data, por exemplo renewal_date. Para um campo de membro, coloque member. antes do nome. Para um campo de data personalizado, escreva member.cf_ e o ID do campo.
• Direção do deslocamento, Deslocado e Unidade movem o momento. Depois da data (+) aguarda mais, Antes da data (-) continua antes. Três dias antes de uma renovação, por exemplo, é Antes da data (-) com 3 Dias.

Se o momento já passou, o caminho continua na hora. Se o campo estiver vazio ou contiver algo que não é uma data, o caminho continua sem aguardar, e a etapa mostra uma nota na execução, por exemplo "Nenhuma data encontrada em "renewal_date". O fluxo continuou sem aguardar." Uma data sem fuso horário é lida no fuso horário definido para a sua plataforma.

O que acontece durante uma pausa

Um Atraso ou Aguardar até a data não deixa nada ocupado. A execução guarda onde parou, e uma tarefa em segundo plano a retoma quando chega a hora. Enquanto aguarda, o histórico de execuções a mostra como Aguardando, com a data e a hora em Retoma. Quando você abre a execução e clica na etapa que está aguardando, a aba Execução mostra o mesmo.

Uma execução que está aguardando continua com a versão com que começou, mesmo que você publique uma nova versão nesse meio-tempo. Se você arquivar ou excluir a automação, as execuções que estão aguardando são canceladas quando chega a hora delas. Pausar a automação também as cancela, exceto as execuções de teste que você iniciou manualmente.

Testes e histórico de execuções

Trabalhar com os dados

Cada execução carrega dados: o que o gatilho entregou mais o que as etapas anteriores adicionaram. As três etapas a seguir alteram esses dados. Etapas posteriores podem usar cada campo como marcador, por exemplo {{discount_code}}.

Definir campos

Definir campos adiciona campos ou sobrescreve os existentes. Em Campos a definir, cada linha tem uma chave e um valor. Adicionar adiciona outra linha. Os valores podem conter marcadores, por exemplo Hello {{member.first_name}}.

Data e Hora

Data e Hora calcula uma data e a guarda em um campo. Ela não aguarda. Para aguardar até a data calculada, coloque Aguardar até a data depois dela.

• A partir de: Agora ou Uma data já presente nos dados. Com a segunda opção, aparece Campo de data, que indica o campo de partida: um campo dos dados, um campo de membro como member.created_at ou member.cf_ e o ID de um campo de data personalizado. Se esse campo estiver vazio ou ilegível, a etapa parte de agora.
• Direção (No futuro (+) ou No passado (-)), Deslocado e Unidade (Minutos, Horas, Dias, Semanas ou Meses) movem a data.
• Formato fica vazio para o formato padrão 2026-10-22T14:30:00+02:00, ou recebe um padrão como Y-m-d para 2026-10-22 ou d.m.Y para 22.10.2026.

A etapa calcula no fuso horário definido para a sua plataforma, o mesmo que Aguardar até a data usa. O formato padrão termina com o deslocamento, por exemplo +02:00, então um Aguardar até a data seguinte lê o mesmo momento.

• Armazenar no campo (obrigatório) indica o campo para o resultado. Ele começa como date.

Expressão

Expressão calcula um valor com uma fórmula curta e o guarda em um campo.

• Expressão (obrigatório) contém a fórmula. payload representa os dados e member os campos do membro, por exemplo payload["score"] * 2 ou member["first_name"] ~ " " ~ member["last_name"]. Você pode calcular com + - * /, comparar com ==, > ou <, combinar com and e or, escolher com condition ? a : b e juntar textos com ~.
• Armazenar resultado em (obrigatório) indica o campo para o resultado. Ele começa como result.

Dados sensíveis do membro, como a senha, não estão disponíveis. Se a fórmula não puder ser calculada, o campo fica vazio e a execução continua.

Repetir etapas: Repetir

Repetir executa as etapas depois dele uma vez para cada item de uma lista.

• Campo de lista (obrigatório) indica o campo que contém a lista, por exemplo items, ou member.tags para as tags do membro.
• Armazenar cada item como define o nome do campo para o item atual. Ele começa como item. A posição é guardada ao lado como item_index, contando a partir de 0.

Repetir tem uma única saída, e tudo o que vem depois dele é executado uma vez por item. Não há uma saída extra para "depois do último item". Se o campo estiver vazio ou não for uma lista, o caminho para na repetição.

Dois limites mantêm as execuções sob controle. Uma repetição processa no máximo 200 itens e ignora o resto. E uma execução executa no máximo 500 etapas antes de pausar ou terminar. Uma repetição com 200 itens e três etapas depois dela precisaria de 600 etapas, então a execução para com um erro. Mantenha as repetições curtas, ou passe o trabalho para uma automação separada com Executar workflow.

Chamar outra automação: Executar workflow

Executar workflow inicia outra automação como uma etapa e continua quando ela termina.

• Fluxo de trabalho (obrigatório) lista as suas automações ativas que têm uma versão publicada. A automação que você está editando não aparece na lista, porque uma automação não pode chamar a si mesma.
• Usar o resultado decide o que volta: Ignorar, manter os dados deste fluxo, Mesclar com os dados deste fluxo ou Armazenar num campo. Para a última opção, Nome do campo define o campo. Se você o deixar vazio, o resultado vai para sub.

A outra automação começa no gatilho dela com os dados e o membro desta execução, seja qual for o tipo de gatilho que ela tem, e aparece no próprio histórico de execuções. O resultado dela são os dados na etapa Fim dela, ou na última etapa concluída se ela não tiver Fim. Se ela pausar em um Atraso, este fluxo não aguarda: ele pega os dados alcançados até ali, e a outra automação continua depois por conta própria.

Quando algo dá errado:

• Se a outra automação falhar, não tiver versão publicada ou não existir mais, esta etapa falha, e a execução também.
• Se a outra automação estiver pausada, este fluxo continua sem ela, e a etapa mostra uma nota na execução.
• As automações podem chamar umas às outras em até cinco níveis de profundidade. Além disso, a etapa falha.
• Se nenhum fluxo de trabalho estiver selecionado, o caminho para nesta etapa. O editor avisa sobre isso antes: "Nenhum fluxo de trabalho selecionado em “Executar fluxo de trabalho”."

Responder a um webhook: Responder ao webhook

Responder ao webhook é para automações que começam com o gatilho Webhook de entrada. Ele decide o que o sistema que fez a chamada recebe de volta.

• Status HTTP oferece 200 OK, 201 Created, 202 Accepted, 400 Bad Request, 404 Not Found e 500 Server Error.
• Corpo da resposta começa como { "ok": true } e pode conter marcadores, por exemplo { "ok": true, "code": "{{discount_code}}" }. Um corpo em JSON válido sai como JSON, qualquer outra coisa como texto simples.

Assim que esta etapa vem depois do gatilho Webhook de entrada na versão publicada, uma chamada a esse webhook deixa de apenas iniciar a automação em segundo plano. A chamada aguarda enquanto a automação é executada, e a resposta sai quando a execução termina ou chega à primeira pausa. Uma etapa em um caminho que o gatilho do webhook nunca alcança, por exemplo atrás de outro gatilho, não muda nada. É por isso que a etapa só funciona antes de qualquer Atraso ou Aguardar até a data. Se um deles vier primeiro, quem chama recebe a resposta padrão {"ok": true, "triggers_fired": 1}, e o editor avisa: "Responder ao webhook é executado após uma etapa de atraso ou espera. Quem chamou o webhook recebe a resposta padrão."

A etapa não tem saída, então nada vem depois dela no caminho. Outros caminhos, por exemplo depois de um Dividir, continuam sendo executados.

Gatilhos e ações

Encerrar um caminho: Fim

Fim encerra o caminho em que está. Ele não tem configurações nem saída. Outros caminhos da mesma execução continuam, e a execução conta como concluída quando todos eles terminam.

Um caminho sem mais conexões também termina sozinho. Fim torna o final visível na tela e decide quais dados uma automação que faz a chamada recebe de Executar workflow.

Artigos relacionados

• Visão geral das automações
• Criar uma automação
• Gatilhos e ações
• Testes e histórico de execuções