> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/configuracoes/configuracoes-gerais/entidades.md).

# Campos personalizados

Campos personalizados são informações adicionais que podem ser inseridas dentro de tickets, clientes, recursos e solicitantes.

## **🔧 Campos Personalizados no Tiflux**

```
**📍 Localização:**  
📂 Configurações > Campos Personalizados
```

***

### 🎯 **Introdução**

Campos personalizados são áreas configuráveis que permitem ampliar as informações registradas no Tiflux, adaptando o sistema às necessidades específicas da sua operação. Eles podem ser aplicados a **tickets**, **clientes**, **recursos** e **solicitantes**, permitindo coletar dados estruturados como datas, valores, links, opções entre outros.

👉 *Valor agregado:* Personalize o cadastro de entidades do seu sistema sem depender de desenvolvimento técnico, melhorando a qualidade dos dados, relatórios e automações.

***

### 📚 **Sumário**

* 🧾 O que são Campos Personalizados?
* 🛠️ Criando um Campo Personalizado
* ➕ Adicionando campos
* 🔍 Encontrando um campo personalizado
* ⚠️ Avisos importantes
* ❓ Perguntas Frequentes (FAQ)
* 🔍 Palavras-chave para IA, indexação e busca
* 📂 Aplicação em Catálogos de Serviços
* ⚠️ Avisos importantes
* ❓ Perguntas Frequentes (FAQ)

***

### 🧾 **O que são Campos Personalizados?**

Campos personalizados funcionam como **contêineres** que agrupam um ou mais campos de dados. Cada contêiner pode ser vinculado a uma das seguintes entidades:

* **Tickets**
* **Clientes e Solicitante**
* **Recursos**
* **Catálogo de Serviço**

> ⚠️ **Limitação importante**: Para **solicitantes**, é permitido apenas **1 campo personalizado por organização**, com no máximo **5 subcampos**.

A configuração é feita em **Configurações > Campos Personalizados**, onde três abas separam os campos conforme sua aplicação:

* Tickets
* Catálogo de Serviços
* Recursos
* Clientes e Solicitantes

Na tela inicial, você encontra:

* Barra de pesquisa
* Botão **+ Campo personalizado**
* Lista de campos existentes
* Filtro por **Status** (Ativo/Inativo)

> 💡 Se não encontrar um campo, verifique se o filtro de status está restringindo a visualização.

***

### 🛠️ **Criando um Campo Personalizado**

1. Clique em **+ Campo personalizado**.

2. Preencha as informações:
   * **Nome**: Identificador do contêiner (ex: “Compra”).
   * **Descrição**: Explicação interna sobre o propósito do campo.
   * **Aplicação**: Escolha onde será usado (ticket, cliente, recurso ou solicitante).

3. Defina as opções específicas conforme a aplicação:
   * **Tickets**: Aplicar a todas as mesas ou a mesas específicas.
   * **Catálogo de Serviços:** aplicase a catálogos de serviço dos quais inserire nos tickets
   * **Recursos**: Aplicar a todos os tipos ou apenas a tipos selecionados.
   * **Clientes**: Aplica-se a todos os clientes automaticamente.
   * **Solicitantes**: Aplica-se a todos os solicitantes (lembre-se do limite de 1 por organização).

4. Marque **“Visualizar como seção”** se desejar que o campo apareça como uma **aba dedicada** dentro do registro (em vez de ficar na aba “Informações”).\
   \ <br>

   <figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F9vDWafB6exwTpqilFLzg%2Fimage.png?alt=media&amp;token=4dc22256-a09e-423b-82ad-602d2b794109" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FYUaNurdByR52fVGWKY1V%2Fimage.png?alt=media&amp;token=71ec8766-354c-420f-a114-86218b62ef28" alt=""><figcaption></figcaption></figure>

5. Clique em **Salvar**.

> ✅ Após salvar, você será redirecionado à página do novo campo personalizado, pronta para receber subcampos.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2F2xZ2XHYUN3tvAjCMLHcj%2Fimage.png?alt=media&amp;token=8ed5dc1b-b2b3-46e0-93f2-25baa71e246c" alt=""><figcaption></figcaption></figure>

***

### ➕ **Adicionando campos**

Dentro do contêiner recém-criado, clique em **+ Campo** para adicionar os campos individuais. Preencha:

* **Nome**: Nome descritivo do campo (ex: “Data da compra”, “Fornecedor”). Pode incluir perguntas com “?” ou esclarecimentos entre parênteses.
* **Tipo**: Escolha o formato:
  * Texto
  * Número
  * Moeda
  * Data
  * Hora
  * Link
  * Lista (com opções pré-definidas)
  * Sim/Não
  * Arquivo (upload)

> ⚠️ **Não é possível alterar o tipo após a criação.**

* **Campo obrigatório**: Marque se for essencial preencher antes de fechar tickets ou salvar registros.

> ❗ **Exceção**: Em **clientes**, **não é possível marcar campos como obrigatórios**, pois o sistema salva automaticamente ao digitar, sem validação de obrigatoriedade.

Para editar nome ou obrigatoriedade posteriormente, use o ícone de **lápis (✏️)** ao lado do campo.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FEDzmwhV6BWhaQSiPLnGA%2Fimage.png?alt=media&amp;token=ae8adae9-db32-40c8-a366-9b1d7845f050" alt=""><figcaption></figcaption></figure>

***

### 🔍 **Encontrando um campo personalizado**

Com muitos campos criados, utilize a **barra de pesquisa** na parte superior da tela de **Campos Personalizados** para localizar rapidamente pelo nome.

Além disso:

* Verifique o **filtro de Status** (Ativo/Inativo).

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FgOpYoxXEI1cek4fDnU4Q%2Fimage.png?alt=media&amp;token=19c99769-7768-458e-99f7-ed33ea61466b" alt=""><figcaption></figcaption></figure>

* Navegue pelas abas corretas (**Tickets**, **Recursos**, **Clientes e Solicitantes**) conforme o tipo desejado.

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FcwVZhAyueV4lj9Q8BMMl%2Fimage.png?alt=media&amp;token=40cb5073-7240-4fda-9795-27b20d05ecc0" alt=""><figcaption></figcaption></figure>

***

### 📂 **Aplicação em Catálogos de Serviços**

Quando a aplicação escolhida for **Catálogo de Serviços**, o campo personalizado é utilizado para capturar dados pontuais na triagem ou abertura de chamados específicos.

Neste cenário, configure os parâmetros obrigatórios de escopo:

| **Campo de Escopo**      | **Descrição / Regra de Aplicação**                                                                                             |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| **Aplicado a**           | Define o nível de exibição: **Catálogo todo** (todos os itens), **Área** (categoria específica) ou **Item** (serviço pontual). |
| **Catálogo de Serviços** | Seleção do catálogo principal que receberá a regra.                                                                            |
| **Área do Catálogo**     | Seleção da área/categoria vinculada (obrigatório se "Aplicado a" for Área ou Item).                                            |
| **Item do Catálogo**     | Seleção do item final de serviço (obrigatório se "Aplicado a" for Item).                                                       |

⚙️ **Habilitação de Uso:** Após criar e configurar a estrutura do campo para o Catálogo de Serviços, acesse para configurar os campos a serem utilizados.

***

### ⚠️ **Avisos importantes**

* 🚫 **Somente 1 campo personalizado para solicitantes por organização**, com até **5 subcampos**.
* 🔒 **Tipo de campo não pode ser alterado após criação** — planeje com antecedência.
* 📌 **Campos obrigatórios não funcionam para clientes** devido à lógica de salvamento automático.
* 🔄 Ao aplicar a **tickets**, defina se será global ou por mesa — isso afeta onde o campo aparecerá.
* 🗂️ Use nomes claros e descritivos para facilitar o uso pela equipe.

***

### ❓ **Perguntas Frequentes (FAQ)**

🔹 **Posso ter mais de um campo personalizado para solicitantes?**\
Não. É permitido apenas **um por organização**, com até 5 subcampos.

🔹 **Como faço para que o campo apareça como uma aba separada?**\
Ao criar o campo personalizado, marque a opção **“Visualizar como seção”**.

🔹 **Posso tornar um campo obrigatório para fechar um ticket?**\
Sim, desde que o campo esteja aplicado a **tickets** e a opção “Campo obrigatório” esteja marcada.

🔹 **Por que não consigo marcar um campo como obrigatório em clientes?**\
Porque o Tiflux salva automaticamente as alterações em clientes à medida que são digitadas, sem etapa de validação final.

🔹 **Onde vejo os campos personalizados nos tickets?**\
Na aba “Informações” (se “Visualizar como seção” estiver desmarcado) ou em uma aba própria com o nome do campo.

🔹 **Posso excluir um campo personalizado?**\
Sim, mas somente se ele **não estiver sendo usado** em nenhum registro ativo.

🔹 **Os campos personalizados aparecem nos relatórios?**\
Sim, desde que sejam usados em tickets, clientes ou recursos — eles podem ser incluídos em exportações e filtros avançados.

🔹 **Posso usar campos personalizados em automações?**\
Sim! Eles podem ser usados como gatilhos ou condições em regras de automação.

🔹 **Como edito o nome de um subcampo depois de criado?**\
Clique no ícone de lápis (✏️) ao lado do campo na tela de edição do contêiner.

🔹 **Posso aplicar um campo personalizado a apenas um tipo de recurso?**\
Sim. Ao criar o campo para recursos, escolha “Aplicar a tipos específicos” e selecione os desejados.

***

🔍 **Palavras-chave para IA, indexação e busca**

```
campos personalizados,
custom fields tiflux,
campo personalizado ticket,
campo personalizado cliente,
campo personalizado recurso,
campo personalizado solicitante,
configurar campo personalizado,
tipo de campo,
campo obrigatório,
visualizar como seção,
adicionar campo tiflux,
editar campo personalizado,
buscar campo personalizado,
limitação solicitante,
customização tiflux
```