Sign inGet Started

Flows, nós e conexões

Um flow é o conjunto conectado de etapas que define uma automação. O canvas mostra onde uma execução começa, quais decisões ela toma e onde pode terminar.

Automations is in Early access. Your workspace permissions determine which actions you can perform.

As partes de um flow

TermoSignificado
TriggerO evento ou agendamento que inicia uma execução. Um flow tem um trigger.
Nó ou etapaUma tarefa, como enviar um e-mail, verificar uma condição ou aguardar.
Caminho de saídaUm resultado possível de uma etapa, como sucesso, falha, correspondência ou timeout.
ConexãoA rota de um caminho de saída até a próxima etapa.
ExecuçãoUma execução de um flow publicado com seus próprios dados iniciais e histórico.

Por exemplo, um flow de lembrete pode seguir esta sequência:

Exemplo de código
Appointment event → Delay until reminder time → Send SMS → Wait for delivery
                                                           ├─ Matched → Finish
                                                           └─ Timeout → Notify team

As conexões controlam qual etapa é executada a seguir. Um mapeamento de campos seleciona separadamente os dados que uma etapa lê. Conectar Get contact a Send email não preenche o destinatário do e-mail automaticamente.

Um caminho por vez

Uma execução segue um caminho ativo. Um Branch verifica as condições em ordem e segue o primeiro caminho correspondente. O caminho Otherwise é aplicado quando nenhuma condição corresponde.

Os caminhos podem se reconectar em uma etapa compartilhada. A etapa compartilhada pode ler dados produzidos antes da divisão e no caminho que a execução seguiu. Uma etapa em um caminho não tomado não tem saída para essa execução.

O builder atual não executa loops, ramificações paralelas nem uma ação automática para cada membro da audiência. Uma conexão de volta a uma etapa anterior cria um ciclo e bloqueia a publicação. Uma lista de contatos permanece como dado até que uma ação compatível a utilize.

Como uma execução termina

Uma etapa bem-sucedida pode encerrar a execução quando a saída escolhida não tem próxima etapa. Uma falha de ação não conectada falha a execução. Conectar um caminho de falha permite que você decida como lidar com essa falha.

Use Exit quando quiser um encerramento explícito de sucesso ou falha, um motivo de resultado ou um resultado retornado. Por exemplo, no_matching_contact explica uma execução bem-sucedida que deliberadamente não enviou nenhuma mensagem. Um exit encerra a execução e não tem conexão de saída.

Uma execução bem-sucedida significa que o flow completou o caminho configurado. Verifique o status da mensagem no canal ou adicione uma espera de entrega quando precisar de evidência de entrega.

Rascunhos e versões publicadas

O rascunho é o seu flow editável. Salvá-lo preserva o seu trabalho sem alterar a versão usada pelas execuções ativas.

Publicar cria uma versão para novas execuções. Uma execução mantém a versão com a qual começou, inclusive quando aguarda durante uma publicação posterior. Editar o rascunho não pode alterar um workflow já em execução.

Próximos passos

Continue com a documentação, guias e exemplos sobre este tópico.