# Tags

Explicação completa de como funciona o cadastro de Tags dentro do sistema.

# Como cadastrar novas tags dentro do sistema?

As Tags são etiquetas personalizadas que você pode criar e aplicar a diferentes tipos de registros dentro do sistema. Elas funcionam como marcadores que facilitam a identificação, a classificação e a organização das informações sem precisar alterar a estrutura dos cadastros.

No dia a dia, as Tags ajudam você a categorizar contatos, negócios, contratos, imóveis, eventos, financeiros, vistorias e seguros de forma rápida e visual. Em vez de depender apenas de filtros tradicionais, você pode marcar registros com etiquetas específicas do seu negócio e localizá-los com mais agilidade.

O cadastro das Tags é feito uma única vez nesta rotina, e as etiquetas criadas ficam disponíveis para uso nas demais telas do sistema que oferecem suporte a Tags.

#### **1. Navegação no módulo**

![entradatagseus.gif](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/entradatagseus.gif)**Rotina:**<span style="white-space: pre-wrap;"> Configurações &gt; Cadastros &gt; Tags</span>

---

#### **2. Como criar uma Tag**

<span style="white-space: pre-wrap;">Na tela de listagem, clique no botão </span>**Cadastrar**<span style="white-space: pre-wrap;"> para abrir o formulário de criação de uma nova Tag. O botão fica localizado na parte superior da tela, ao lado do botão de busca.</span>

Com o formulário aberto, preencha os campos disponíveis e clique em salvar para concluir o cadastro. A Tag criada aparecerá imediatamente na listagem.

<p class="callout info"><span style="white-space: pre-wrap;">Você precisa da permissão </span>**Tags &gt; Cadastrar**<span style="white-space: pre-wrap;"> para criar novas Tags. Caso o botão não esteja visível, entre em contato com o administrador do sistema.</span></p>

---

#### **3. Campos do cadastro**![Formulário de cadastro de Tag (continuação)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/g8a02b-form-cadastro-scroll.png)

O formulário apresenta os seguintes campos:

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">**Campo**

</th><th>**Descrição**

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">**Obrigatório**

</th></tr><tr><td>Tipo de Tag

</td><td>Define em qual área do sistema a Tag poderá ser utilizada. As opções disponíveis incluem: Negócio, Contrato, Contato, Imóvel, Evento, Financeiro, Vistoria, Seguro, entre outras. Escolha o tipo que corresponde ao módulo onde você deseja aplicar a Tag.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Cor da Tag

</td><td>Permite atribuir uma cor de identificação visual à Tag. A cor facilita a distinção rápida entre diferentes etiquetas na tela, especialmente quando há muitas Tags aplicadas a um mesmo registro.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Descrição da Tag

</td><td>Nome da Tag como ela aparecerá nos registros do sistema. Use um nome claro e objetivo para que qualquer membro da equipe entenda o significado da etiqueta. Exemplo: "Cliente Inadimplente", "Seguro Fiança", "IPTU".

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Slug

</td><td>Identificador interno da Tag gerado automaticamente com base na descrição informada. Você pode deixar este campo em branco; o sistema preencherá sozinho. Caso queira personalizar, utilize apenas letras minúsculas, números e underscores, sem espaços ou acentos.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Ícone da Tag

</td><td>Permite associar um ícone visual à Tag para facilitar a identificação nos registros. É uma configuração opcional e de uso estético.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Ativo

</td><td>Controla se a Tag está disponível para uso no sistema. Quando ativada, a Tag pode ser aplicada a novos registros. Quando desativada, ela deixa de aparecer como opção de seleção, mas não é excluída do sistema.

</td><td class="align-center" style="text-align: center;">Não

</td></tr></tbody></table>

<p class="callout warning"><span style="white-space: pre-wrap;">O campo </span>**Tipo de Tag**<span style="white-space: pre-wrap;"> determina em quais módulos a Tag ficará disponível. Uma Tag do tipo "Contrato" não aparecerá nas opções de um registro de Imóvel, por exemplo. Defina o tipo com atenção antes de salvar.</span></p>

---

#### **4. Gerenciando as Tags cadastradas**  


[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/scaled-1680-/pc1image.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-08/pc1image.png)

Após o cadastro, todas as Tags ficam disponíveis na listagem principal. Nesta tela você pode realizar as seguintes ações:

**Consultar Tags existentes:**<span style="white-space: pre-wrap;"> a listagem exibe todas as Tags organizadas com tipo, nome, cor, identificador (slug) e data da última alteração. Você pode visualizar até 240 registros por página e navegar entre as páginas disponíveis.</span>

**Buscar e filtrar:**<span style="white-space: pre-wrap;"> utilize os filtros disponíveis na parte superior da tela para localizar Tags específicas:</span>

- **Busca inteligente:**<span style="white-space: pre-wrap;"> pesquisa pelo nome ou qualquer informação da Tag.</span>
- **Tipo:**<span style="white-space: pre-wrap;"> filtra por tipo de Tag (Negócio, Contrato, Imóvel etc.).</span>
- **Data de atualização:**<span style="white-space: pre-wrap;"> filtra por período de alteração.</span>
- **Status:**<span style="white-space: pre-wrap;"> filtra entre Tags ativas e inativas.</span>

**Editar uma Tag:**<span style="white-space: pre-wrap;"> clique sobre a Tag na listagem para abrir o formulário de edição. Todos os campos podem ser alterados. Após ajustar as informações, salve para aplicar as mudanças.</span>

**Excluir uma Tag:**<span style="white-space: pre-wrap;"> selecione uma ou mais Tags na listagem e utilize o botão </span>**Remover**<span style="white-space: pre-wrap;"> para excluí-las. Esta ação requer a permissão </span>**Tags &gt; Deletar**.

**Ativar ou inativar:**<span style="white-space: pre-wrap;"> dentro do formulário de edição, utilize a chave </span>**Ativo**<span style="white-space: pre-wrap;"> para controlar a disponibilidade da Tag sem precisar excluí-la.</span>

<p class="callout danger">A exclusão de uma Tag é uma ação permanente. Antes de remover, verifique se a Tag não está sendo utilizada em registros importantes no sistema.</p>

---

#### **5. Utilização das Tags no sistema**

As Tags cadastradas ficam disponíveis para aplicação nos módulos correspondentes ao tipo definido no momento do cadastro. Conforme os dados da listagem, os tipos disponíveis e os módulos onde as Tags podem ser utilizadas são:

<table id="bkmrk-tipo-da-tagonde-%C3%A9-ut" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">**Tipo da Tag**

</th><th>**Onde é utilizada**

</th></tr><tr><td>Negócio

</td><td>Registros do módulo de Negócios, para classificar oportunidades e atendimentos.

</td></tr><tr><td>Contrato

</td><td>Registros do módulo de Contratos, para identificar características ou situações contratuais.

</td></tr><tr><td>Contato

</td><td>Cadastro de pessoas e contatos, para segmentar clientes, fornecedores e outros perfis.

</td></tr><tr><td>Imóvel

</td><td>Cadastro de imóveis, para destacar características ou informações relevantes do imóvel.

</td></tr><tr><td>Evento

</td><td>Registros de eventos e agenda, para categorizar o tipo de atividade realizada.

</td></tr><tr><td>Financeiro

</td><td>Lançamentos financeiros, para classificar receitas, despesas ou cobranças específicas.

</td></tr><tr><td>Vistoria

</td><td>Registros de vistorias, para identificar situações ou observações relevantes.

</td></tr><tr><td>Seguro

</td><td>Registros de seguros, para diferenciar tipos ou situações de apólices.

</td></tr></tbody></table>

<p class="callout info">Cadastrar uma Tag é apenas o primeiro passo. Para que ela gere valor, ela precisa ser aplicada nos registros correspondentes dentro do módulo adequado. Quanto mais consistente for o uso, mais fácil fica identificar e filtrar informações no sistema.</p>

---

#### **6. Perguntas frequentes**

**Posso alterar o nome ou as configurações de uma Tag depois de cadastrá-la?**  
Sim. Clique sobre a Tag na listagem para abrir o formulário de edição e ajuste os campos desejados. As alterações são aplicadas imediatamente após salvar.

**Posso excluir uma Tag que já foi utilizada em registros?**  
<span style="white-space: pre-wrap;">O botão </span>**Remover**<span style="white-space: pre-wrap;"> está disponível na listagem para Tags selecionadas. Recomenda-se verificar antes se a Tag ainda está em uso, pois a exclusão é permanente e a ação não pode ser desfeita.</span>

**O que acontece quando eu inativo uma Tag?**  
A Tag deixa de aparecer como opção de seleção nos novos registros, mas não é excluída do sistema. Tags inativas ainda podem ser visualizadas na listagem ao filtrar pelo status correspondente.

**Por que não consigo ver uma Tag criada ao tentar aplicá-la em um registro?**  
<span style="white-space: pre-wrap;">Verifique se o </span>**Tipo de Tag**<span style="white-space: pre-wrap;"> definido no cadastro corresponde ao módulo onde você está tentando utilizá-la. Uma Tag do tipo "Imóvel" não aparecerá nas opções de um contrato, por exemplo. Verifique também se a Tag está com a situação </span>**Ativa**.

**Preciso de alguma permissão especial para criar ou excluir Tags?**  
<span style="white-space: pre-wrap;">Sim. Para criar Tags, é necessária a permissão </span>**Tags &gt; Cadastrar**<span style="white-space: pre-wrap;">. Para excluir, é necessária a permissão </span>**Tags &gt; Deletar**. Caso não visualize esses botões, entre em contato com o administrador do sistema para verificar as permissões do seu perfil.

**O identificador (slug) precisa ser preenchido manualmente?**  
Não. O sistema gera o identificador automaticamente com base na descrição informada. Você só precisa preencher esse campo caso queira definir um identificador personalizado.