> For the complete documentation index, see [llms.txt](https://docs.fortics.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/entendendo-as-variaveis-no-ambiente-fortics.md).

# Entendendo as variáveis no ambiente Fortics

As **variáveis** são o "cérebro" e a "memória" de qualquer fluxo inteligente no Chat Center. Sem elas, seu robô seria apenas um panfleto estático; com elas, ele se torna um atendente capaz de reconhecer o cliente, guardar informações e tomar decisões baseadas em dados.

Aqui está um resumo estratégico de como elas funcionam e por que são essenciais:

## O que são variáveis?

Pense nas variáveis como **caixas etiquetadas** onde o sistema guarda pedaços de informação durante a conversa. Se o cliente digita o CPF dele, você guarda esse dado em uma "caixa" chamada cpf\_cliente para usá-lo mais tarde na consulta de um boleto, por exemplo.

No Chat Center, as variáveis são identificadas pelo uso de chaves duplas: {{nome\_da\_variavel}}.\
\
**Exemplo:**\
Em vez de um "Olá, cliente", você usa "Olá, {{NAME}}”. Se o nome do cliente cadastrado for Marcelo, ele receberá a mensagem “Olá, Marcelo”.

## Tipos de variáveis do Chat Center

### Variáveis de Sistema

As variáveis predefinidas são criadas e preenchidas automaticamente pela plataforma. Você não precisa configurá-las, apenas chamá-las sempre que precisar exibir uma informação padrão do sistema.[ <mark style="color:$primary;">Veja a lista completa de variáveis da plataforma.</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/lista-de-variaveis-predefinidas-chat-center.md)

### Variáveis dos campos adicionais

Enquanto as variáveis de sistema são fixas, os [Campos Adicionais](/perguntas-frequentes/perguntas-frequentes-1/chat-center/criando-campos-adicionais-para-os-contatos.md) permitem que você crie variáveis personalizadas de acordo com a necessidade do seu negócio (como ID do cliente, número de pedido ou placa de veículo).

**A regra é:** Todo [Campo Adicional criado nas configurações da plataforma ](/perguntas-frequentes/perguntas-frequentes-1/chat-center/criando-campos-adicionais-para-os-contatos.md)torna-se automaticamente uma variável utilizável nos fluxos e nas mensagens. Se você criar um campo adicional chamado "codigo\_do\_cliente", poderá utilizá-lo no seu fluxo de automação ou em uma mensagem de texto escrevendo apenas {{codigo\_do\_cliente}}.

## Variáveis personalizadas: a memória de curto prazo

As [<mark style="color:$primary;">variáveis personalizadas servem para armazenar dados temporários</mark> ](/perguntas-frequentes/perguntas-frequentes-1/chat-center/criando-variaveis-personalizadas.md)ou específicos que surgem durante uma conversa. Elas são fundamentais para que o robô consiga "tomar notas" do que o cliente está dizendo e usar isso para decidir os próximos passos.

### Criando as variáveis

Existem dois caminhos para criar essas variáveis na plataforma:

**Pré-definição (estruturada):** Você pode[ <mark style="color:$primary;">criá-las antes de montar o robô</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/criando-variaveis-personalizadas.md)<mark style="color:$danger;">,</mark> acessando **Configurações > Variáveis personalizadas**. Este caminho é ideal para manter a organização e garantir que todos os seus fluxos utilizem os mesmos nomes de variáveis para dados padronizados.

**Criação no fluxo (dinâmica):** Você também pode criar uma nova variável diretamente enquanto constrói o seu fluxo de automação. Isso permite que você avance rapidamente na criação, sem precisar sair da tela de edição do robô.

<div align="left"><figure><img src="/files/cCVKH3ud9fRFeQ7n1BXt" alt=""><figcaption></figcaption></figure></div>

Um bom exemplo [<mark style="color:$primary;">acontece no componente script</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/componentes-do-fluxo/componente-fluxo-script.md)<mark style="color:$primary;">,</mark> onde o usuário pode criar uma variável durante a configuração do componente para salvar a informação retornada. No exemplo acima, ao clicar no ícone de “+”,  o usuário pode criar uma variável, definindo um nome e uma descrição para ela.

{% hint style="warning" %}
**## Dica**

Sempre que criar uma variável personalizada, pense nela como um "post-it". Ela é útil para o recado de agora, mas se a informação for algo que você precisará consultar daqui a seis meses no cadastro do cliente, o ideal é [<mark style="color:$primary;">usar um Campo Adicional.</mark>](/perguntas-frequentes/perguntas-frequentes-1/chat-center/criando-campos-adicionais-para-os-contatos.md)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fortics.com.br/perguntas-frequentes/perguntas-frequentes-1/chat-center/entendendo-as-variaveis-no-ambiente-fortics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.