Variaveis visiveis

A caixa Definir variáveis visíveis publica uma ou mais informações para o atendente humano. Use-a para apresentar, no atendimento, dados importantes que foram definidos ou coletados durante o fluxo, como:

• motivo do contato;
• protocolo ou número de pedido;
• indicação de urgência;
• data e hora de uma solicitação;
• qualquer outro contexto que ajude o atendente a começar o atendimento sem repetir perguntas ao cliente.

A caixa não envia uma mensagem ao cliente e não faz a transferência para o atendimento humano sozinha. Ela apenas prepara as informações visíveis e segue para a próxima caixa configurada. O uso mais comum é colocá-la imediatamente antes de Criar Ticket.

Importante: as informações são destinadas ao atendente. O cliente não recebe esses valores como mensagem por causa desta caixa.

Onde encontrar

1. Abra Configuração → Fluxos.
2. Crie ou abra uma versão do fluxo no editor.
3. Na barra de ferramentas, abra o grupo Variáveis.
4. Adicione a caixa Definir variáveis visíveis ao diagrama.
5. Selecione a caixa para abrir o painel de configuração.
6. Preencha as variáveis, clique em Aplicar e salve a versão do fluxo.

Como a caixa funciona

A execução segue este fluxo:

Fluxo automático
      │
      ▼
Definir variáveis visíveis
      │  prepara as informações para o atendimento
      ▼
Criar Ticket
      │
      ▼
Atendente recebe o ticket com o contexto configurado

Quando a caixa é executada:

1. cada variável configurada recebe o valor do tipo escolhido;
2. as informações ficam preparadas para serem exibidas no atendimento humano;
3. o fluxo segue para a caixa selecionada em Depois de definir as variáveis, vai para:;
4. quando o caminho chega a Criar Ticket, o atendente pode consultar essas informações no atendimento.

A caixa não aguarda resposta, não abre formulário e não interrompe a conversa para fazer uma pergunta.

Configuração da caixa

Nome

Identifica a caixa no diagrama. Use um nome que explique a finalidade da etapa, por exemplo:

• Preparar contexto do atendimento;
• Informações para o suporte;
• Dados da solicitação.

O nome da caixa não é o nome de nenhuma variável visível. Cada variável possui seu próprio nome no cartão correspondente.

Variável visível

A caixa começa com um cartão de variável. Cada cartão representa uma informação que será apresentada ao atendente.

Nome

É o rótulo da informação. Use um nome curto e claro, que permita ao atendente entender o valor sem consultar o fluxo.

Exemplos:

• Motivo do contato;
• Número do pedido;
• Atendimento urgente;
• Data da solicitação.

O nome deve ser preenchido. Evite usar nomes genéricos como valor1 ou campo2.

Tipo

Define o formato do valor da variável e quais campos aparecem no cartão:

String

Escolha String para textos. Informe o conteúdo em Valor.

Exemplo:

Boolean

Escolha Boolean quando o atendente precisar saber se uma condição está ligada ou desligada. Em Valor, selecione True ou False.

Exemplo:

Number

Escolha Number para valores numéricos. Informe somente um número no campo Valor.

Exemplo:

Não use texto, símbolos de moeda ou uma descrição junto do número. Se o valor precisar ser exibido com texto, como Pedido 15482, use String.

Data e hora atual em segundos

Escolha Data e hora atual em segundos quando precisar registrar o momento em que a caixa foi executada como um timestamp em segundos. Esse tipo não possui campo de valor manual: a plataforma calcula o valor durante a execução do fluxo.

Use-o quando outro recurso precisar de um timestamp numérico. Para exibir uma data legível ao atendente, prefira Data e hora formatados.

Data e hora formatados

Escolha Data e hora formatados para exibir o momento atual já formatado. Preencha:

• Formato: use um padrão como yyyy/MM/dd HH:mm:ss;
• Timezone: informe o fuso, por exemplo GMT-3.

Exemplo:

O resultado será uma data e hora formatada de acordo com as opções informadas no momento em que a caixa for executada.

Adicionar variável

Clique em Adicionar variável para incluir outro cartão na mesma caixa. Isso permite preparar várias informações de uma só vez, sem criar uma caixa para cada variável.

Mantenha pelo menos um cartão de variável. Quando existe apenas um cartão, a opção de removê-lo fica desabilitada.

Depois de definir as variáveis, vai para:

Selecione a próxima caixa do fluxo. No cenário mais comum, escolha Criar Ticket:

Definir variáveis visíveis → Criar Ticket

Escolha outro destino quando o fluxo precisar executar uma etapa intermediária antes de encaminhar a conversa para um atendente. Depois de renomear uma caixa de destino, confira se a referência da próxima caixa continua correta.

Exemplo completo — encaminhar um pedido urgente

Objetivo: informar ao atendente o motivo do contato, o número do pedido e se o atendimento é urgente antes de criar o ticket.

Configure a caixa Preparar contexto do pedido com estes valores:

O fluxo fica assim:

Coletar dados do pedido
          │
          ▼
Preparar contexto do pedido
          │
          ▼
Criar Ticket
          │
          ▼
Atendente visualiza o motivo, o pedido e a urgência

A caixa Definir variáveis visíveis não substitui a coleta das informações. Se o número do pedido vier do cliente, ele deve ser coletado ou definido em uma etapa anterior. A configuração mostrada acima é adequada quando os valores já são conhecidos ou são constantes para aquele caminho do fluxo.

Valores que mudam durante a conversa

A caixa é indicada para valores configurados no próprio painel e para os tipos automáticos de data e hora. Quando o valor que deve aparecer para o atendente precisa ser calculado a partir de uma variável da sessão, use uma caixa de código ou outro recurso que faça essa leitura e publique o valor dinamicamente.

Em uma caixa de código, a publicação pode ser feita com dialog.visible:

dialog.visible('Nome do cliente', dialog.get('nomeCliente'));
dialog.visible('CPF', dialog.get('cpf'));
dialog.toHuman();

Use essa alternativa somente quando a configuração visual da caixa não atender ao caso. Para obter orientação sobre caixas de código, consulte a referência de comandos dialog.*.

Diferença para “Definir variáveis”

As duas caixas pertencem ao grupo Variáveis, mas têm finalidades diferentes:

Use Definir variáveis quando o bot ainda precisa tomar uma decisão ou usar o dado em outra etapa automática. Use Definir variáveis visíveis quando o objetivo for dar contexto à pessoa que assumirá o atendimento.

É possível usar as duas no mesmo fluxo: primeiro guardar ou coletar um dado para a lógica do bot e, depois, preparar as informações relevantes para o atendente.

Boas práticas

• Coloque a caixa imediatamente antes de Criar Ticket, para que o contexto esteja preparado no momento do encaminhamento.
• Use nomes que o atendente reconheça rapidamente, como Motivo do contato e Número do pedido.
• Separe o rótulo do valor: não coloque Motivo: Cancelamento no nome; use Motivo como nome e Cancelamento como valor.
• Escolha o tipo correto: use Number para valores numéricos e String para códigos que não devem ser tratados como números.
• Use Data e hora formatados quando a informação for destinada à leitura humana; use Data e hora atual em segundos quando um timestamp numérico for necessário.
• Revise os dados pessoais que serão expostos ao atendente e publique somente o que for necessário para o atendimento.
• Teste o caminho completo até o ticket. A caixa pode estar configurada corretamente, mas não terá efeito se o fluxo não passar por ela.
• Depois de aplicar a caixa, salve a versão do fluxo que será usada no atendimento.