# 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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FI1HKcOpRcXin1YCbgqMN%2F1.png?alt=media&#x26;token=cf71c07b-0e85-49f2-839e-ac8e7c1a583b" 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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FvV8JqCPk6vozsdDieXFn%2F2.png?alt=media&#x26;token=d69ff8c8-63fe-41f5-a857-89ccfe5a657d" 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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F1aRobpBhw1qBIsnNeuFd%2F3.jpg?alt=media&#x26;token=cea46e9b-c245-462a-8818-ed878c880faa" 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*](https://ajuda.livechat360.com.br/crm/administracao/personalizacao/campos-customizaveis/campos-de-sistema), 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](https://ajuda.livechat360.com.br/crm/fluxo-de-conversa-chatbot#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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FkUdsgvYot01VmlZBtHLv%2F4.png?alt=media&#x26;token=53f2237d-4305-453b-ae08-9f49eb7ff86a" 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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FxPEbDSs4w0P3UEHQ5K1a%2Fimage.png?alt=media&#x26;token=27720724-ed62-4e8e-a1db-f288e7423d9f" 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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FYiG3ZOvjxr1eN8AwgpIN%2F5.png?alt=media&#x26;token=09055dff-70bc-4391-a184-5e59ce5695ae" alt=""><figcaption></figcaption></figure>

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FzjiqkjxATekHuZ6qC8XH%2F6.png?alt=media&#x26;token=3d27f8a4-9ed1-4fd0-9309-250efdc2ca2a" 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](https://ajuda.livechat360.com.br/crm/fluxo-de-conversa-chatbot#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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FLPOsAAqi9LXyqS0pNpxU%2Fimage.png?alt=media&#x26;token=ae77d537-4ddc-41e7-a0cc-d159ec81cb7d" alt=""><figcaption><p>Essa é a variável escrita no campo de mensagem.</p></figcaption></figure>

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2Fe7zR97LvJ6etcFOzBzGe%2Fimage.png?alt=media&#x26;token=cebcb8d8-54cb-4564-81b2-02f14e5f199e" 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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FFB9cIl0C5GzM603okcfG%2Fimage.png?alt=media&#x26;token=e94bccb9-9697-4574-9776-0feb0c21059c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FFOee8F6cTU22DX2IC6s5%2Fimage.png?alt=media&#x26;token=2d0c6abd-5c7e-4565-893c-45df7cfce111" 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:

![](https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F1gUW4HOqe8wiooup5ZHt%2Fimage.png?alt=media\&token=aecf0822-eaa8-46b2-9940-112942596298)&#x20;

No campo 'Salvar em' selecione um campo customizável de imagem:![](https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FJaAJUNOrKMorUsMPNcgv%2Fimage.png?alt=media\&token=6f03f47e-52b4-4c2d-86d5-effe492de5f9)

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="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FOqygxkx47s23x3xtX46Q%2Fimage.png?alt=media&#x26;token=278f2dd5-d2b0-4a21-aa07-23f8756d201b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F0T2wq86c7vYKd88GQ29I%2Fimage.png?alt=media&#x26;token=fb3725c6-c043-4706-be0c-ac31f7975c21" alt=""><figcaption></figcaption></figure>

Depois, insira no campo a URL de uma imagem:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FVB1XsXyRYHgkG93F5GxI%2Fimage.png?alt=media&#x26;token=bb8cc943-2920-4ead-b812-641de84af999" 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](https://ajuda.livechat360.com.br/crm/configuracoes/configuracoes-gerais#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.