Skip to main content
O nó Condicional funciona como um ponto de decisão dentro do seu fluxo: ele avalia informações que você já tem sobre o usuário e decide qual caminho seguir. Pense nele como uma bifurcação no caminho — dependendo do que o usuário responde ou dos dados que possui, a conversa seguirá uma rota ou outra. O painel do nó é organizado em duas abas:
  • Geral — define os caminhos, suas regras e a proteção de dados sensíveis (DLP).
  • Eventos — registra eventos de acompanhamento que disparam quando o nó é executado, alimentando suas métricas.

​
Conceito-chave: caminhos e regras

Antes de configurar, é importante entender dois conceitos:
  • Caminho: uma rota que a conversa pode seguir. Cada caminho tem um nome descritivo e uma ou mais regras que devem ser atendidas para que ele seja ativado.
  • Regra: uma condição individual que compara uma variável com um valor. Por exemplo: “a idade do usuário é maior ou igual a 18”.
Se um caminho tem várias regras, todas elas devem ser atendidas para que esse caminho seja ativado (lógica AND). Se você precisar que ele seja ativado quando qualquer uma das condições for atendida, crie caminhos separados para cada uma.

​
Caminho padrão: “Caso contrário”

Todo nó Condicional inclui automaticamente um caminho chamado “Caso contrário” (fallback). Este caminho é ativado quando nenhum dos outros caminhos é atendido. É a sua rede de segurança para garantir que a conversa sempre tenha um caminho a seguir.

​
Configuração passo a passo

1

Criar um novo caminho

Clique em “Novo caminho” para adicionar sua primeira condição. Dê a ele um nome descritivo que ajude a identificar rapidamente o que ele avalia (por exemplo: “Adulto”, “Cliente Premium”, “Horário comercial”).
2

Configurar a primeira regra

Cada regra tem três partes:
  1. Variável — os dados que você deseja avaliar (por exemplo, {{$memory.age}})
  2. Operador — como você quer comparar esses dados (por exemplo, “Maior ou igual”)
  3. Valor — o que você compara com (por exemplo, 18)
3

Adicionar mais regras se necessário

Se você precisar que várias condições sejam atendidas ao mesmo tempo, clique em ”+” dentro do mesmo caminho para adicionar regras adicionais. Todas as regras dentro de um caminho são avaliadas com lógica AND (todas devem ser verdadeiras).
4

Criar caminhos adicionais

Repita o processo para cada rota alternativa que você precisar. Cada caminho é avaliado em ordem: o primeiro que for atendido será o executado.
5

Conectar os nós seguintes

Cada caminho (incluindo “Caso contrário”) tem um ponto de conexão à direita. Arraste uma linha de cada ponto para o nó que deve ser executado nessa rota.

​
Operadores disponíveis

Os operadores definem como a variável é comparada ao valor. Eles são organizados em quatro categorias:

​
Comparação de igualdade

​
Comparação numérica

​
Busca em texto

​
Validação de tipo (É do tipo / Não é do tipo)

Os operadores É do tipo e Não é do tipo permitem verificar se uma variável corresponde a um tipo de dado específico. Em vez de inserir um valor, você seleciona o tipo de uma lista: Exemplo: {{$memory.email}} É do tipo → E-mail verifica se o que o usuário digitou tem formato de endereço de e-mail.

​
Verificação de vazio

Os operadores Vazio e Não vazio não exigem um valor de comparação — eles apenas avaliam se a variável tem conteúdo ou não.

​
Expressões regulares (Regex)

Expressões regulares são uma ferramenta avançada. Se você não está familiarizado com regex, os outros operadores cobrem a maioria dos cenários comuns.

​
Lógica de avaliação

O nó Condicional avalia os caminhos de cima para baixo, na ordem em que aparecem no painel. O primeiro caminho cujas regras forem atendidas será o executado.
Você pode reordenar os caminhos arrastando-os com o ícone de mover (⠿) que aparece à esquerda de cada caminho. Isso é importante porque a ordem afeta qual é avaliado primeiro.

​
Lógica AND vs OR

​
Modos de visualização

O painel de configuração oferece dois modos de exibição que você pode alternar com o botão de visualização no canto superior:
  • Visualização expandida: mostra cada regra como um cartão com rótulos descritivos (Variável, Operador, Valor). Ideal quando você está configurando condições pela primeira vez.
  • Visualização compacta: mostra cada regra em uma única linha horizontal. Ideal quando você já conhece as condições e quer uma visão geral mais rápida.
Além de reordenar caminhos, você pode excluir qualquer um deles com o ícone de lixeira no cabeçalho de cada cartão e adicionar regras a um caminho com o botão +. Ao excluir um caminho, o nó conectado a essa saída é desconectado automaticamente.

​
DLP (Prevenção de Perda de Dados)

Na parte inferior do painel Geral está a seção DLP, que mascara automaticamente os dados sensíveis que passam pelo nó antes de serem armazenados em logs ou enviados para integrações. Ative o toggle “Habilitar DLP” para acessar o seletor de tipos de informação.
1

Habilite o DLP

Ative o toggle para exibir o seletor de tipos.
2

Selecione os tipos de dados sensíveis

Escolha quais tipos devem ser detectados e mascarados:
Número de cartão de crédito está sempre selecionado e não pode ser desabilitado: é o tipo mínimo protegido sempre que o DLP está ativo.
O DLP é aplicado sobre os valores que o nó avalia. Não modifica a mensagem que o usuário vê nem o conteúdo da sua memória — apenas mascara as informações sensíveis nos registros deixados pela execução do nó.

​
Eventos

A aba Eventos permite registrar até 10 eventos de acompanhamento por nó, cada um com um nome e até 5 propriedades personalizadas no payload. Sempre que o Condicional é executado, os eventos ativos disparam e alimentam seus painéis de Métricas.
1

Adicione um evento

Clique em “Adicionar evento” e escreva um nome em snake_case (por exemplo, caminho_premium_ativado). Se o nome não estiver no formato, você verá o erro “Deve ser snake_case”.
2

Defina o payload (opcional)

Em “Propriedades do evento”, adicione até 5 pares de chave/valor. O valor pode ser texto explícito ou uma variável avaliável como {{$context.user_id}} ou {{$memory.tipo_cliente}}.
3

Ative ou desative eventos

Cada evento tem um toggle independente. Os eventos desativados não disparam, mas são mantidos para que você possa reativá-los depois. No menu de cada item você pode editá-los ou excluí-los.
Consulte o guia completo de eventos de nó para conhecer limites, boas práticas e exemplos de análise.

​
Exemplos práticos

Um fluxo que precisa verificar se o usuário é maior de idade:O caminho “Adulto” é ativado se a idade for 18 ou mais. Qualquer outro caso continua por “Caso contrário”.
Um fluxo que direciona clientes premium da Colômbia para um fluxo especial:Em “Premium Colômbia”, ambas as regras devem ser atendidas (AND): o país deve ser Colômbia e o tipo de cliente deve ser premium. Se apenas a primeira for atendida, o fluxo passa para avaliar “Regular Colômbia”.
Um fluxo que valida se o usuário digitou um endereço de e-mail:Se os dados tiverem formato de e-mail, continua por “E-mail válido”. Caso contrário, você pode usar o caminho “Caso contrário” para pedir ao usuário que insira novamente.
Um fluxo que detecta palavras-chave na mensagem do usuário:Cada caminho é independente (lógica OR): se a mensagem contém “cancelar”, segue a primeira rota; se contém “ajuda”, a segunda, e assim por diante.