Como configurar a etapa Definir variáveis?

Para que serve?

“Definir variáveis” grava um valor em uma ou mais variáveis. Se você der o nome de uma variável existente, o valor dela muda. Nas etapas seguintes, você usa o valor como {name}.

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 “Definir variáveis” 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 a etapa

1. Digite o nome da variável na primeira caixa de “Atribuições”. Uma nova atribuição sugere um nome que o agente ainda não usa; você pode mudá-lo.
2. Escolha o tipo de valor na lista ao lado e informe o valor abaixo.
3. Para outra variável, clique em “Adicionar atribuição”; remova as extras com o X na linha (“Excluir atribuição”).

Tipos de valor

• “Texto”: o texto digitado, que pode incluir variáveis ({first_name} {last_name}). Se ficar vazio, a variável é limpa.
• “Cálculo”: números, variáveis, + − × ÷ (ou * e /) e parênteses, por exemplo, {total} * 1.2. Multiplicação e divisão vêm primeiro. O resultado é um número com no máximo duas casas decimais (12.5).
• “Data”: soma um período a uma data inicial; a unidade é dias, semanas, meses ou anos. Se a caixa inicial estiver vazia (mostra “Hoje”), é usada a data de hoje do visitante; um valor negativo volta no tempo. O resultado fica como 05.10.2026. Uma data além do fim do mês vai para o último dia do mês: somar 1 mês a 31 de janeiro dá 28 (ou 29) de fevereiro.
• “Resumo de lista”: transforma uma lista em um único valor. A operação é “Contagem”, “Soma”, “Média”, “Menor”, “Maior” ou “Juntar”; Juntar escreve os valores lado a lado, separados por vírgulas. Para tudo menos Contagem, informe na caixa ao lado o campo do item a usar (por exemplo, price); sem campo, o próprio item é usado. Em uma lista vazia, contagem e soma são 0 e os outros ficam vazios.

As atribuições rodam em ordem; uma posterior pode usar o valor gravado por uma anterior. Um valor que não pode ser calculado (uma variável que não é número, divisão por zero, um início que não é data) limpa a variável, para o agente não seguir com um valor antigo ou errado.

Exemplo

Uma inscrição em evento tem três atribuições: total (“Cálculo”) {guests} * 25; total_with_tax (“Cálculo”) {total} * 1.2; due_date (“Data”, início vazio, 7 dias). Uma etapa Mensagem pode então dizer “Seu total é {total_with_tax}; pague até {due_date}.”

Pontos de atenção

O editor avisa quando: não há atribuições, o nome de uma atribuição é inválido, um valor “Cálculo” ou “Resumo de lista” está vazio ou um cálculo tem um erro de digitação.

Nomes de variáveis só podem usar as letras a–z, dígitos e sublinhados (_); letras acentuadas e espaços são descartados ao digitar. “system” é reservado para variáveis do sistema, então escolha outro nome.

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.