# Campos customizáveis

{% hint style="info" %}
A tela de campos customizáveis é responsável por gerenciar informações adicionais que você deseja incluir em um contato.
{% endhint %}

<figure><img src="/files/IstSQsFNYFdyJGs5XpzW" alt=""><figcaption></figcaption></figure>

Nessa página, você encontrará uma listagem de campos customizáveis com as colunas ID, Nome, Tipo e Data de Criação. Cada campo possui um botão de edição para que você possa realizar alterações quando necessário.

**Adicionar novos campos:**\
\
No canto superior direito da tela, há um botão de adicionar mais campos customizáveis.

<figure><img src="/files/KqMyLxJyULFwYmgyLMf1" alt=""><figcaption></figcaption></figure>

Ao clicar nesse botão uma janela será aberta permitindo que você preencha dois campos: nome do campo e o tipo de dados que serão inseridos (texto, número, data, imagem, áudio, vídeo, documento).

<figure><img src="/files/ZdzA3suYWB38c7OG5sWj" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
O campo de nome é case-insensitive, ou seja, tanto faz o uso de maiúscula ou minúscula. Isso significa que, por exemplo, uma variável {empresa} é igual a variável {Empresa} ou {EMPRESA}.
{% endhint %}

{% hint style="warning" %}
Não é possível criar um *campo customizável* com o mesmo nome.
{% endhint %}

{% hint style="warning" %}
Existem alguns **nomes reservados pelo sistema**, que são os [*Campos de Sistema*](/crm/administracao/personalizacao/campos-customizaveis/campos-de-sistema.md), e que não poderão ser utilizados para nomear campos customizáveis, são eles: nome, primeiro-nome, ultimo-nome, telefone, protocolo, telefone, canal, cpf, rg, data-de-nascimento, codigo, email, data-de-cadastro, nome-agente, saudacao, endereco, numero-endereco, complemento-endereco, bairro, CEP, estado, UF, profissão e status.

Um adendo: Apesar de não ser possível criar campos customizáveis com tais nomes, é perfeitamente possível salvá-los pelo *Fluxo de Conversa* e depois recuperar o valor deles. Para mais informações, vide [Definir valor para um Campo Customizável ou de Sistema](/crm/administracao/fluxo-de-conversa-chatbot.md#definir-valor-para-um-campo-customizavel-ou-de-sistema).
{% endhint %}

Com a possibilidade de personalizar os campos, você pode incluir informações específicas para o seu negócio, tornando o gerenciamento de contatos mais eficiente e adequado às suas necessidades.

**Filtro de busca:**

Ao lado do botão de adicionar campos customizáveis há duas formas de filtrar os resultados na listagem: pelo nome do campo e/ou tipo.

<figure><img src="/files/8UOvVcgE32Gcz1hvOK8H" alt=""><figcaption></figcaption></figure>

**Aplicações práticas:**

Com a ferramenta de campos customizáveis, você pode, por exemplo, criar um campo denominado 'Cidade' para armazenar informações específicas de um contato. Para fazer isso, basta acessar a página de campos customizáveis e adicionar um novo campo com esse nome.

<figure><img src="/files/WQvhF06qyijcYeUDUafl" alt=""><figcaption></figcaption></figure>

Em seguida, você pode utilizar esse campo customizável no Fluxo de Conversa. Por exemplo, ao inserir um nó de 'Conteúdo' com o item 'Salvar', é possível perguntar qual é o nome da cidade do contato e selecionar o campo customizável 'Cidade'.

<figure><img src="/files/IKTzz9vhWgOEqcSxcX4U" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/mhp1C6rbVOxCPo9i9nXu" alt=""><figcaption></figcaption></figure>

Quando o contato responder à pergunta, o nome será salvo nesse campo customizável.

{% hint style="success" %}
Dessa forma, você pode personalizar as informações que são coletadas dos seus contatos e adaptá-las às necessidades específicas do seu negócio.\
Informações adicionais: [Salvar uma informação em um Campo Customizável](/crm/administracao/fluxo-de-conversa-chatbot.md#salvar-uma-informacao-em-um-campo-customizavel).
{% endhint %}

### Usos especiais do campo do tipo Data:

É possível usar variáveis do tipo data de uma forma mais personalizada com a finalidade de trazer dados específicos da respectiva variável.

Os comandos são:

* {variavel}
* {variavel}(dia)
* {variavel}(diaT)
* {variavel}(mes)
* {variavel}(mesT)
* {variavel}(ano)
* {variavel}(hora)
* {variavel}(data)

Exemplo prático: se uma variável de data denominada ''Entrevista" tivesse o valor *<mark style="color:purple;">2024-04-23T18:25:07.540Z</mark>*, então, os resultados seriam os seguintes ao digitar as variáveis especiais no chat:

&#x20;         • {Entrevista}  &#x20;

&#x20;                   <mark style="color:purple;">23/04/24</mark>

&#x20;         • {Entrevista}(dia)&#x20;

&#x20;                   <mark style="color:purple;">23</mark>

&#x20;         • {Entrevista}(diaT)     <mark style="color:orange;">\<o T precisa ser maiúsculo></mark>

&#x20;                   <mark style="color:purple;">Sexta-feira</mark>

&#x20;         • {Entrevista}(mes)&#x20;

&#x20;                  <mark style="color:purple;">04</mark>

&#x20;         • {Entrevista}(mesT)    <mark style="color:orange;">\<o T precisa ser maiúsculo></mark>

&#x20;                  <mark style="color:purple;">Abril</mark>

&#x20;         • {Entrevista}(ano)&#x20;

&#x20;                   <mark style="color:purple;">2024</mark>

&#x20;         • {Entrevista}(hora)&#x20;

&#x20;                   <mark style="color:purple;">18:07</mark>&#x20;

&#x20;         • {Entrevista}(data)

&#x20;                   <mark style="color:purple;">2024-04-23T18:25:07.540Z</mark>

<figure><img src="/files/N1E3MEKsffQRG0wnwWDT" alt=""><figcaption><p>Essa é a variável escrita no campo de mensagem.</p></figcaption></figure>

<figure><img src="/files/IdTzGTLmYrqEPz9HjeEQ" alt=""><figcaption><p>Essa é a mensagem enviada para o contato.</p></figcaption></figure>

Vale dizer que tal aplicação não se limita apenas ao chat. Você pode utilizar esse recurso na Fluxo de Conversa ou em qualquer campo do sistema que aceite variáveis.

{% hint style="info" %}
As variáveis podem ser usadas tanto maiúsculas quanto minúsculas. Ex.: {data} ou {Data}.
{% endhint %}

### Campos customizáveis com valores vazios:

Caso o campo customizável não tenha valor nenhum, as mensagens que forem enviadas aos contatos com tais campos ficarão em branco.

Por exemplo: Se existir um campo customizável chamado "Cidade" e o contato não tiver nenhum valor preenchido no campo, se for enviada a mensagem "Temos uma promoção para {cidade}" ele receberá a mensagem "Temos uma promoção para ".

Outro exemplo, se o um Campo Customizável sem nenhuma valor salvo – ou um campo customizável que não exista – for digitado no chat:&#x20;

<figure><img src="/files/nYt0s0Hztyo9xZ0V76ej" alt=""><figcaption></figcaption></figure>

O que será enviado para o cliente é uma mensagem vazia:

<figure><img src="/files/80He4aoKOPhaqqlRadVS" alt=""><figcaption></figcaption></figure>

### Campos customizáveis do Tipo Imagem:

Para inserir uma imagem em um campo customizável do tipo imagem você poderá fazer isso de duas formas:

#### Pelo item *Salvar* do nó de *Conteúdo*.&#x20;

Para isso, vá até o Fluxo de Conversa e insira um nó de Conteúdo, depois selecione um item de salvar:

![](/files/9OI6sU6TDZoTgYosHAxl)&#x20;

No campo 'Salvar em' selecione um campo customizável de imagem:![](/files/zSqmghqbpFTLPjZTqTvp)

Informe um texto para o item e salve. Depois disso, quando o contato passar por esse item no fluxo, ele receberá o texto e ao enviar a imagem, ela será anexada como valor do campo customizável.

#### Pela URL de uma imagem nas configurações do Chat:

Vá até o página do Chat, depois selecione um contato e na coluna de configurações do chat clique em *Editar dados* dos campos customizáveis.

<figure><img src="/files/e7Dv7ExqgUHMfWSwc7C0" alt=""><figcaption></figcaption></figure>

&#x20;Na janela que abrir, selecione um campo customizável do tipo imagem:

<figure><img src="/files/HZCqiyKraPMCstgNotLs" alt=""><figcaption></figcaption></figure>

Depois, insira no campo a URL de uma imagem:

<figure><img src="/files/uqDsqillqmJiR1IohnO9" alt=""><figcaption></figcaption></figure>

Prontinho!

#### Uso do campo customizável imagem:

É possível usar a variável do campo customizável do tipo imagem de duas formas. Imagine que o nome do campo customizável seja "imagem", então as formas de uso possíveis seriam:

* {imagem}\
  &#x20;    A imagem em si (media de imagem) contida na variável será enviada.
* {imagem}(url)  \
  &#x20;    A URL da imagem contida na variável será enviada.

{% hint style="warning" %}
Se nas configurações gerais a opção [Enviar o nome do agente nas mensagens](/crm/administracao/configuracoes/configuracoes-gerais.md#enviar-o-nome-do-agente-nas-mensagens) estiver ativada, a imagem em si não será enviada ao utilizar a variável {imagem}. No lugar da imagem em si, a URL é que será enviada, tanto ao utilizar {imagem} quanto ao utilizar {imagem}(url).
{% endhint %}

Ao utilizar a variável imagem em outro lugares, como no Fluxo de Conversa, se for utilizada em um campo de texto, a URL da imagem será enviada, se for utilizada em um campo de imagem, a imagem em si é que será enviada.


---

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

```
GET https://ajuda.livechat360.com.br/crm/administracao/personalizacao/campos-customizaveis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.