Como configurar a etapa Condição?

Para que serve?

A etapa “Condição” olha variáveis e envia o agente por um dos seus caminhos.

Os visitantes não veem esta etapa e o avatar não diz nada; o agente continua sem esperar o visitante.

Para adicioná-la, clique em “Adicionar etapa” na aba “Editor” e depois em “Condição” na categoria “Lógica”; a etapa é adicionada no meio da tela. As configurações ficam na aba “Conteúdo” do painel que abre à direita quando você clica na etapa.

Esta etapa não tem “Texto na tela”; em vez disso, há uma “Nota da etapa” no fim do painel. A nota é só para você: os visitantes não a veem, e ela não é falada nem traduzida.

Nos valores, você usa variáveis de etapas anteriores, como {city}. Para um campo dentro de uma resposta, adicione o nome do campo depois de um ponto: {order.status}. O botão “Inserir variável” nas caixas lista as variáveis que você pode usar naquele ponto. Uma variável ainda não preenchida conta como texto vazio.

Configurar caminhos

Uma nova etapa abre com um caminho; clique em “Adicionar caminho” para ter mais.

1. Dê um nome ao caminho (por exemplo, Projeto grande). Sem nome, a tela mostra um resumo da regra do caminho.
2. Escreva a regra. Cada regra é uma linha: à esquerda o valor a verificar (por exemplo, {budget}), no meio o botão de comparação e à direita o valor de comparação (um valor fixo ou outra variável).
3. Para outra regra, clique em “E” ou “Ou”. Regras ligadas com E precisam ser todas atendidas; com Ou, basta um lado. E vale primeiro: “A e B ou C” significa “(A e B) ou C”. Você pode mudar a ligação depois com a chave E | Ou entre as regras.
4. Escolha na lista abaixo do caminho a etapa para onde ele vai (ela mostra “Nenhuma etapa de destino selecionada” enquanto vazia) ou conecte a alça do caminho a uma etapa na tela.
5. Escolha também uma etapa para “Caso contrário”, no fim: se a condição de nenhum caminho for atendida, o fluxo vai para lá.

Os caminhos são verificados de cima para baixo; o primeiro com condição atendida é seguido e o resto não é verificado. Mude a ordem com os botões de seta (“Mover para cima”, “Mover para baixo”) e remova um caminho com “Excluir caminho”. Se o caminho seguido não tiver etapa escolhida, o agente termina ali; ele não passa para o caminho seguinte.

Tipos de comparação

O botão de comparação pede primeiro um tipo e depois a comparação. O tipo decide como os valores são comparados:

• “Texto”: “é igual a”, “não é igual a”, “contém”, “não contém”, “começa com”, “não começa com”, “termina com”, “não termina com”. Maiúsculas, espaços no início e no fim e acentos não importam: “REEMBOLSO” é igual a “reembolso”.
• “Número”: “é igual a”, “não é igual a”, “é maior que”, “é menor que”, “é maior ou igual a”, “é menor ou igual a”. Formatos como 1,250.50 e 1.250,50 também são lidos, e símbolos de moeda são ignorados. Se um lado não for um número, a regra não é atendida.
• “Data”: “é o mesmo dia”, “é outro dia”, “é depois de”, “é antes de”, “é no dia ou depois”, “é no dia ou antes”. As datas são comparadas por dia; tanto 2026-12-31 quanto 31.12.2026 são lidas.
• “Sim / não”: “é verdadeiro (sim)” e “é falso (não)”. “yes”, “true” e “1” contam como verdadeiro; “no”, “false” e “0” como falso.
• “Lista”: “contém o item”, “não contém o item” e comparações da contagem (“a contagem de itens é igual a”, “a contagem de itens é maior que” …). Uma resposta de múltipla escolha, a lista de uma ferramenta ou ação e o resultado de Editar lista são lidos como listas.

Todo tipo também tem “está vazio” e “não está vazio”, que não precisam de segundo valor. Por exemplo, a regra {coupon} “está vazio” é atendida se o visitante não informou um código de cupom.

Exemplo

Em um agente de orçamento, o caminho “Projeto grande” vai para uma etapa Solicitação com a regra {budget} · “Número” · “é maior ou igual a” · 50000. O caminho “Cidade próxima” vai para um formulário de reserva com as regras {city} “é igual a” São Paulo “Ou” {city} “é igual a” Campinas. “Caso contrário” está conectado a uma etapa Mensagem dizendo que o orçamento será enviado por e-mail.

Pontos de atenção

O editor marca a etapa quando: não há caminhos; um caminho não tem regras (nunca é seguido); uma regra está incompleta (um dos valores está vazio, então nunca é atendida); um valor fixo que não é número ou data está onde se espera um; um caminho não tem etapa de destino; ou “Caso contrário” não está conectado.

Etapas lógicas não esperam o visitante. Se você as conectar (ou outras etapas que não esperam, como Mensagem, Chamada de ferramenta ou Ação de integração) em círculo, o agente fica dando voltas: o editor avisa “Em um loop que nunca espera o visitante; o fluxo fica preso aqui.”, e na conversa o agente termina com um erro. Para repetir algo, use a etapa Loop ou coloque no círculo uma etapa que espere o visitante (Pergunta, Seleção, Formulário).

Problemas não impedem de salvar: o agente é salvo, mas a etapa incompleta não funcionará como esperado na conversa. Corrija as etapas marcadas e teste o agente com “Prévia”. Para encontrar as etapas marcadas, veja o editor de fluxos.