Construtor visual

O construtor de fluxos de trabalho é um canvas onde cada fluxo é desenhado como um grafo de nós conectados por linhas. Os gatilhos ficam no topo; as ações fluem para baixo; tudo é editável no lugar.

Abrir o construtor

Em Fluxos de trabalho, clique em um fluxo de trabalho existente para editar, ou no botão de criação para um novo.

O canvas

A área principal é uma superfície infinita de pan/zoom. Você pode:

• Arrastar o fundo para fazer pan.
• Rolar para dar zoom.
• Clicar em um nó para selecionar e abrir seu painel de configuração.
• Shift-clique em vários nós para movê-los juntos.
• Arrastar da alça inferior de um nó para a alça superior de outro nó para conectar.

O botão de layout automático endireita o grafo usando o Dagre — útil quando você ficou movendo nós manualmente e quer uma visão organizada.

Adicionar um gatilho

Cada fluxo de trabalho precisa de pelo menos um gatilho.

1. Clique no botão Adicionar gatilho (ou arraste um nó de gatilho para o canvas).
2. Escolha um tipo de gatilho — veja Gatilhos para o catálogo completo.
3. Configure as opções do gatilho no painel lateral. Alguns gatilhos precisam de configuração extra (ex.: schedule precisa de uma expressão cron, member.unit_assigned precisa de qual unidade).

Para fluxos de trabalho multi-gatilho, você pode adicionar mais gatilhos e conectá-los todos a um nó de junção de gatilhos que se ramifica para a sequência de ações compartilhada.

Adicionar uma ação

1. Clique no botão Adicionar ação ou arraste da biblioteca de ações à esquerda.
2. Escolha o tipo de ação no catálogo. Veja Ações para a lista completa.
3. Configure a ação no painel lateral.

Ações comuns para começar:

• Send message — escolha um canal, destinatários, template.
• Wait delay — pause por N horas / dias antes de continuar.
• Condition — ramifique com base em dados do membro.
• Update member — mude um campo personalizado, atribua a um grupo, etc.

Conectar nós

Arraste do ponto inferior de um nó para o ponto superior de outro. A linha representa "depois que isso terminar, faça aquilo em seguida."

Um nó condition tem duas saídas (verdadeiro / falso). Um nó split se ramifica para várias branches que executam todas.

O seletor de tokens de mesclagem

Onde quer que um campo de texto aceite dados dinâmicos (corpo da mensagem, payload do webhook, valor de set-variable), o seletor de tokens de mesclagem está a um clique. Ele mostra cada token disponível com base em:

• O tipo de gatilho (então member.created expõe {{member.first_names}}).
• As etapas anteriores da ação (então um resultado de find member expõe seus tokens para ações posteriores).
• Variáveis em nível de fluxo de trabalho que você definiu.

Salvar e versionamento

Clique em salvar para confirmar. Fluxos de trabalho têm modo rascunho — suas mudanças não entram em vigor nas execuções ao vivo até você publicar.

Cada salvamento incrementa um número de versão. Versões antigas são mantidas para que você possa ver como o fluxo de trabalho era no momento de qualquer execução histórica. Você ainda não pode voltar para uma versão anterior em um clique, mas pode ver o diff no log de atividades.

Ativar

Alterne o status do fluxo de trabalho de Rascunho para Ativo. A partir de agora o gatilho disparará execuções. Volte para Pausado para parar novas execuções sem excluir a definição.

WARNING

Definir um fluxo de trabalho como ativo imediatamente significa que eventos históricos de antes da ativação não disparam retroativamente. Se você construir um fluxo de trabalho "boas-vindas para novos membros" hoje, os membros de hoje não receberão a mensagem de boas-vindas retroativamente. Use o gatilho manual se precisar preencher.

Testar

Antes de ir ao ar, use o recurso de execução de teste. Escolha um membro de exemplo, clique em testar e veja a execução rodar de ponta a ponta. As mensagens vão para o seu próprio número, não para o membro real. Útil para pegar tokens de mesclagem digitados errado ou lógica de condição incorreta.

Dicas

• Nomeie seus fluxos de trabalho de forma específica. Boas-vindas para novos membros é ok; Fluxo de trabalho 1 você lamenta em três meses.
• Use comentários. Cada nó tem um campo de comentário opcional — deixe migalhas para o próximo admin.
• Construa pequeno primeiro. Faça funcionar um fluxo de trabalho de 1 etapa antes de adicionar atrasos e ramificações.
• Use o modo rascunho agressivamente. É muito mais barato achar um bug em teste do que depois de enviar 500 mensagens erradas.

Próximos passos

• Gatilhos — escolher o que dispara.
• Ações — escolher o que acontece.
• Multi-etapa e atrasos — sequência e tempo.
• Fluxo de acompanhamento de novos visitantes — veja um fluxo de trabalho real construído do zero.