> 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/criando-variaveis-personalizadas.md).

# Criando variáveis personalizadas

As variáveis personalizadas permitem que você armazene informações específicas coletadas durante a conversa (como um nome, um código de pedido ou uma preferência de produto) para usá-las mais tarde no fluxo ou em integrações externas.

## Tipos de variáveis

Para criar automações inteligentes, é essencial distinguir entre os três pilares de dados do Chat Center as [Variáveis Pré-definidas ](/perguntas-frequentes/perguntas-frequentes-1/chat-center/lista-de-variaveis-predefinidas-chat-center.md)(dados nativos como nome e protocolo), os [**Campos Adicionais** ](/perguntas-frequentes/perguntas-frequentes-1/chat-center/criando-campos-adicionais-para-os-contatos.md)(informações fixas de cadastro como CPF e CNPJ) e as **Variáveis Personalizadas** (criadas por você para lógicas específicas de fluxo). Saber quando utilizar cada uma garante um banco de dados organizado e uma experiência de atendimento personalizada e fluida para o usuário.

**Saiba mais**: Para um mergulho profundo em cada tipo, confira nosso [tutorial completo explicando o funcionamento das variáveis.](/perguntas-frequentes/perguntas-frequentes-1/chat-center/entendendo-as-variaveis-no-ambiente-fortics.md)

## 1. Como criar uma variável personalizada

Utilize o menu lateral esquerdo e navegue até **Configurações** **>** **Variáveis** **personalizadas**, como mostra a imagem abaixo.

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

\
Para criar uma nova **Variável** **personalizada**, clique no ícone “**+**”, localizado no canto superior direito da tela. Essa ação abre o formulário para o cadastro de um novo Campo Adicional.

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

**Nome**: Digite um nome para a variável. O campo não aceita espaços ou caracteres especiais; por isso, conforme você digita, esses caracteres não serão exibidos. No caso de espaços, eles serão automaticamente substituídos por “\_”.

{% hint style="danger" %}
\#**#Importante**

**O nome será utilizado como uma variável do sistema.**

Essa variável pode ser aplicada tanto na construção dos seus Fluxos de Atendimento (para definir regras de decisão) quanto no corpo das mensagens, utilizando o padrão {{nome\_da\_variável}}.
{% endhint %}

**Descrição**: Informe para que o campo seja utilizado na operação.

**Criptografado**: Protege os dados no banco do sistema contra vazamentos (essencial para a LGPD).

**Confidencial**: Ofusca visualmente a informação na tela, impedindo a leitura humana, mas permitindo o uso por robôs (requer criptografia ativa).

Após colocar os dados das variáveis, é só **salvar** e você pode utilizar a variável nos fluxos e mensagens.

## 2. Como editar uma variável

Na lista de variáveis personalizadas, localize o campo que deseja editar e **clique** **no** **ícone** **de** **três** **linhas** na coluna Ações, conforme ilustrado na imagem abaixo.

Em seguida, selecione a opção “**Editar**” para acessar as configurações da variável.

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

Você será direcionado para o mesmo formulário utilizado na **criação** **da** **variável** **personalizada**. Basta então ajustar as informações necessárias e **salvar** para aplicar as novas configurações.

### Editando opções na lista

Os campos **Criptografado** **e** **Confidencial** podem ser editados na lista de variáveis. Basta **clicar** **na** **chave** e confirmar se deseja mesmo editar o campo clicado.

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

## 3. Removendo uma variável personalizada

{% hint style="danger" %}
**##** **Importante**\
Antes de excluir uma variável, valide se ela não está referenciada em fluxos, componentes condicionais ou mensagens. A exclusão removerá de forma permanente e irreversível os dados associados em toda a plataforma, podendo gerar falhas na execução e impactar a experiência do cliente. **Revise** **sua** **estrutura** **antes** **de** **confirmar a exclusão.**
{% endhint %}

Na lista de variáveis, localize o item que deseja excluir e **confirme** para remover o campo adicional.

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

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

Na janela de confirmação, basta clicar em “**Sim, confirmar**” para concluir a ação.

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

### Excluindo múltiplas variáveis

Você também pode excluir múltiplas variáveis utilizando as caixas de seleção em cada uma das linhas desejadas e, em seguida, clicando no **ícone de lixeira,** na parte superior direita da lista de variáveis.

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


---

# 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/criando-variaveis-personalizadas.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.