Pular para o conteúdo principal
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.

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

OperadorDescriçãoExemplo
IgualO valor é exatamente igual{{$memory.status}} igual a active
DiferenteO valor é diferente{{$memory.status}} diferente de cancelled

Comparação numérica

OperadorDescriçãoExemplo
Maior queO valor é estritamente maior{{$memory.age}} maior que 18
Maior ou igualO valor é maior ou igual{{$memory.score}} maior ou igual a 70
Menor queO valor é estritamente menor{{$memory.attempts}} menor que 3
Menor ou igualO valor é menor ou igual{{$memory.debt}} menor ou igual a 0

Busca em texto

OperadorDescriçãoExemplo
ContémO texto inclui a palavra ou frase{{$message.text}} contém ajuda
Não contémO texto não inclui a palavra ou frase{{$message.text}} não contém cancelar
Começa comO texto começa com o valor{{$user.email}} começa com admin
Não começa comO texto não começa com o valor{{$user.phone}} não começa com +55
Termina comO texto termina com o valor{{$user.email}} termina com @empresa.com

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

Os operadores É e Não é 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:
TipoO que valida
AlfanuméricoLetras e números combinados
AlfabéticoSomente letras
Nome(s)Formato de nome de pessoa
NúmeroSomente valores numéricos
E-mailFormato de endereço de e-mail
Número de IDNúmero de documento de identidade
URLFormato de link web
DataFormato de data
ImagemArquivo de imagem
CPF/CNPJRegistro de contribuinte
LocalizaçãoCoordenadas ou endereço
Exemplo: {{$memory.email}} ÉE-mail verifica se o que o usuário digitou tem formato de endereço de e-mail.

Verificação de vazio

OperadorDescriçãoExemplo
VazioA variável não tem valor atribuído{{$memory.name}} está vazio
Não vazioA variável tem algum valor{{$memory.name}} não está 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)

OperadorDescriçãoExemplo
Regex correspondeCorresponde ao padrão regex{{$message.text}} regex corresponde ^\d{10}$
Regex não correspondeNão corresponde ao padrão regex{{$message.text}} regex não corresponde [<>]
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.
O Caminho 1 é atendido?
  └─ Sim → Executar rota do Caminho 1
  └─ Não → O Caminho 2 é atendido?
            └─ Sim → Executar rota do Caminho 2
            └─ Não → O Caminho 3 é atendido?
                      └─ Sim → Executar rota do Caminho 3
                      └─ Não → Executar rota "Caso contrário" (fallback)
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

O que você precisaComo configurar
Todas as condições atendidas ao mesmo tempoAdicionar várias regras dentro do mesmo caminho
Qualquer uma das condições atendidaCriar caminhos separados, um para cada condição

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.

Exemplos práticos

Verificação de idade

Um fluxo que precisa verificar se o usuário é maior de idade:
CaminhoRegraVariávelOperadorValor
Adulto1{{$memory.age}}Maior ou igual18
Caso contrário
O caminho “Adulto” é ativado se a idade for 18 ou mais. Qualquer outro caso continua por “Caso contrário”.

Roteamento por país e tipo de cliente

Um fluxo que direciona clientes premium da Colômbia para um fluxo especial:
CaminhoRegraVariávelOperadorValor
Premium Colômbia1{{$user.country}}IgualColombia
2{{$memory.customer_type}}Igualpremium
Regular Colômbia1{{$user.country}}IgualColombia
Caso contrário
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”.

Validação de formato de entrada

Um fluxo que valida se o usuário digitou um endereço de e-mail:
CaminhoRegraVariávelOperadorTipo
E-mail válido1{{$memory.email}}ÉE-mail
Caso contrário
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.

Detecção de intenção a partir do texto

Um fluxo que detecta palavras-chave na mensagem do usuário:
CaminhoRegraVariávelOperadorValor
Quer cancelar1{{$message.text}}Contémcancelar
Quer ajuda1{{$message.text}}Contémajuda
Saudação1{{$message.text}}Contémolá
Caso contrá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.