# Campos personalizados

## **🔧 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

***

### 🧾 **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**
* **Recursos**
* **Solicitantes**

> ⚠️ **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
* 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.
   * **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="/files/N5oKNa4eMxPCPFvKRTTH" alt=""><figcaption></figcaption></figure>

   <figure><img src="/files/0R88ikR4iGbe9MzLbsYy" 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="/files/GksIw1OqpY56dCEwdLyT" 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="/files/qnhNTXj8xiG5AKe4r3sK" 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="/files/BrTPplunCQ3L2Spw52bs" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/6pCI8XOb8VmJXGG9Km2X" alt=""><figcaption></figcaption></figure>

***

### ⚠️ **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
```


---

# 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://guia-de-uso.tiflux.com/sistema/configuracoes/configuracoes-gerais/entidades.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.
