> For the complete documentation index, see [llms.txt](https://ajuda.livechat360.com.br/crm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.livechat360.com.br/crm/administracao/personalizacao/campos-customizaveis.md).

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