Fluxos: visão geral do Flow Builder

O Flow Builder é o construtor visual de automações do Rishi CRM. Você arrasta blocos (chamados de nós) numa tela, conecta eles entre si, e desenha o caminho que cada cliente vai percorrer quando um evento acontece — um pedido novo, uma tag adicionada, um carrinho abandonado, qualquer coisa.

Cada fluxo pertence a um site e tem um único gatilho (ponto de partida) que define quando ele dispara.

Conceitos fundamentais

Como você constrói um fluxo

1. Acesse CRM → Fluxos e clique em Criar Fluxo.
2. Selecione o site e dê um nome ao fluxo.
3. Na tela do builder, configure o gatilho clicando no nó Início:
   • Escolha o tipo (Pedido novo, Carrinho abandonado, Tag adicionada, etc.)
   • Defina filtros se aplicável (UUID da tag, segmento específico, etc.)
4. Arraste novos nós da palette lateral pra tela.
5. Conecte os nós arrastando das handles (pontos de conexão nas bordas).
6. Clique em qualquer nó pra abrir o Inspector lateral e configurar os campos do nó.
7. Salve. O fluxo entra como Rascunho — não dispara ainda.
8. Quando estiver tudo pronto, ative o fluxo no botão superior.

Tipos de nó disponíveis

Cada tipo cobre um propósito específico. Os artigos detalhados:

• Gatilhos — todos os tipos de evento que podem iniciar um fluxo
• Aguardar — pausa o fluxo por minutos, horas ou dias
• Condições — bifurca o fluxo em Sim/Não baseado em dados do pedido ou cliente
• Mensagem — envia WhatsApp (via QR Code ou API Oficial)
• Webhook — chama URL externa com dados do fluxo
• Cupom — gera cupom de desconto único na loja
• Tag — marca/desmarca o cliente com uma tag

Existem também três nós auxiliares:

• E-mail — envia e-mail transacional usando template do site (exige SMTP configurado)
• Interromper fluxo — cancela execuções em andamento de outro fluxo pro mesmo cliente
• Fim — marca o término explícito de um ramo (apenas sinaliza intenção; não tem efeito funcional)

Variáveis: a cola que liga tudo

Quase todo nó suporta variáveis no formato {{caminho.do.dado}}. Você usa elas pra personalizar mensagens, calcular cupons, montar payloads de webhook.

Exemplos:

Olá {{customer.first_name}}, seu pedido #{{order.external_id}} de {{order.total}} foi confirmado!

Cupom de boas-vindas: {{coupon_code}}

O Inspector mostra um painel Variáveis disponíveis aqui quando você seleciona um nó. Ele lista as variáveis em duas categorias:

• Sempre — disponíveis em todos os caminhos que chegam até esse nó
• Às vezes — dependem do caminho (ex: {{coupon_code}} só existe se o nó Cupom rodou antes)

Clicar em uma variável copia {{var}} pro clipboard.

Variáveis legacy

Por compatibilidade com fluxos antigos, alguns aliases continuam funcionando:

Use os novos em fluxos novos.

Como um fluxo é executado

Quando o evento acontece (ex: pedido criado), o ciclo é:

1. Disparo — um listener específico (StartAutomationFlowsListener, StartTagAutomationFlowsListener, etc.) é acionado.
2. Eligibilidade — StartFlowExecution confere quais fluxos ativos têm o gatilho correspondente e atendem os filtros (ex: tag específica).
3. Cria execução — uma FlowExecution é criada com status running e despacha ExecuteFlowJob na fila flow.
4. Engine — o FlowEngine percorre os nós a partir do gatilho. Cada nó vira um FlowExecutionStep.
5. Processamento — ProcessFlowStepJob executa cada nó (na fila flow para Aguardar/Condição, e na fila actions pras outras ações).
6. Continuação — após cada nó, moveToNextStep() decide qual aresta seguir.
7. Fim — quando chega no fim da árvore, a execução fica completed. Em erro, fica failed.

Tudo é assíncrono em fila. O fluxo nunca bloqueia outras execuções — cada delay vira um job agendado.

Estados do fluxo

Mudar pra Rascunho não cancela execuções já em andamento — elas seguem até o fim ou ficam Pausadas se o sistema detectar.

Estados de execução

Deduplicação: cliente entra uma vez por fluxo

Por padrão, cada cliente entra no fluxo apenas uma vez — não importa quantas vezes o evento aconteça. Isso vale pra gatilhos como Tag adicionada e Segmento.

A exceção são os gatilhos de pedido (Novo pedido, Pedido pago, etc.): cada novo pedido dispara o fluxo, mesmo que seja do mesmo cliente — o que faz sentido, já que cada pedido é um evento separado.

Criando fluxo com IA

Quer começar mais rápido? Use o assistente de IA:

1. Na lista de fluxos, clique em Criar com IA.
2. Descreva o que você quer em linguagem natural ("quero mandar mensagem 30 minutos após carrinho abandonado, depois 3 horas com cupom de 10%, e cancelar se a pessoa pagar").
3. O agente gera a definição JSON do fluxo.
4. Revise no builder visual e ajuste antes de ativar.

Templates prontos

A galeria de templates inclui fluxos já desenhados pra cenários comuns:

• Carrinho Abandonado (3 toques: 30min, 3.5h com verificação de pedido recente, fechamento com cupom de 10%)
• Outros vão sendo adicionados — confira a galeria ao criar fluxo novo.

Próximos passos

• Comece pelo artigo de Gatilhos pra entender quando cada tipo de evento dispara.
• Cada nó tem seu próprio artigo detalhado em Fluxos (Flow Builder).