---
title: "Variaveis visiveis"
slug: "variaveis-visiveis"
updated: 2026-10-23T17:08:19Z
published: 2026-10-23T17:08:19Z
canonical: "docs.omnisiga.ai/variaveis-visiveis"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnisiga.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

| Tipo | Quando usar | Campo de valor exibido |
| --- | --- | --- |
| **String** | Textos, códigos, descrições ou identificadores que devem ser tratados como texto. | **Valor** — campo de texto. |
| **Boolean** | Informações com apenas duas possibilidades. | **Valor** — selecione `True` ou `False`. |
| **Number** | Quantidades, números de protocolo ou valores numéricos. | **Valor** — campo numérico. |
| **TimeInSeconds** | Registrar o momento atual como timestamp em segundos. | Nenhum campo adicional; o valor é gerado na execução. |
| **FormattedDatetime** | Mostrar o momento atual em um formato de data e hora legível. | **Formato** e **Timezone**. |

#### String

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

Exemplo:

| Nome | Tipo | Valor |
| --- | --- | --- |
| `Motivo do contato` | `String` | `Cancelamento de contrato` |

#### Boolean

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

Exemplo:

| Nome | Tipo | Valor |
| --- | --- | --- |
| `Atendimento urgente` | `Boolean` | `True` |

#### Number

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

Exemplo:

| Nome | Tipo | Valor |
| --- | --- | --- |
| `Número do pedido` | `Number` | `15482` |

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:

| Nome | Tipo | Formato | Timezone |
| --- | --- | --- | --- |
| `Data da solicitação` | `FormattedDatetime` | `yyyy/MM/dd HH:mm:ss` | `GMT-3` |

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:

| Campo | Valor |
| --- | --- |
| **Nome da caixa** | `Preparar contexto do pedido` |
| **Variável 1 — Nome** | `Motivo do contato` |
| **Variável 1 — Tipo** | `String` |
| **Variável 1 — Valor** | `Cancelamento de contrato` |
| **Variável 2 — Nome** | `Número do pedido` |
| **Variável 2 — Tipo** | `Number` |
| **Variável 2 — Valor** | `15482` |
| **Variável 3 — Nome** | `Atendimento urgente` |
| **Variável 3 — Tipo** | `Boolean` |
| **Variável 3 — Valor** | `True` |
| **Depois de definir as variáveis, vai para** | `Criar Ticket` |

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:

| Caixa | Finalidade |
| --- | --- |
| **Definir variáveis** | Guarda valores de sessão para que o fluxo possa reutilizá-los em decisões, mensagens e integrações. |
| **Definir variáveis visíveis** | Prepara informações para que o atendente humano as consulte no atendimento. |

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.

---