> For the complete documentation index, see [llms.txt](https://docs.flw.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flw.chat/guide/documentacao/crm/contato/gerenciar-etiquetas/excluir-etiquetas.md).

# Excluir Etiquetas

Excluir uma etiqueta de contatos é uma ação permanente e irreversível — ao confirmar, a etiqueta é removida de todos os contatos que a possuem simultaneamente. Para evitar exclusões acidentais, a plataforma exibe o impacto em tempo real e, quando necessário, solicita uma validação de segurança antes de concluir a ação. Este artigo explica quem pode excluir etiquetas, como funciona o processo e o que esperar em cada situação.

{% embed url="<https://drive.google.com/file/d/11yvWcQHG49fAuabvuSNfesYppaOadtoz/view?usp=sharing>" %}

### **Quem pode excluir etiquetas de contatos?**

Somente usuários com perfil de **Administrador** têm permissão para editar e excluir etiquetas de contatos.

Usuários com perfis operacionais, como **Atendente**, visualizam apenas a opção de criar novas etiquetas. Os ícones de edição e exclusão ficam completamente ocultos da interface para esses perfis.

<figure><img src="/files/aHPbCVWuEbvUJ2nV9knR" alt=""><figcaption></figcaption></figure>

### **Como excluir uma etiqueta de contato**

#### **Passo 1: Acessar o painel de etiquetas**

1. No menu superior, acesse **CRM > Contatos**.
2. Localize e abra o cadastro de qualquer contato.
3. No painel lateral, clique no ícone de edição ao lado de **Etiquetas**.
4. O painel de etiquetas será exibido com a lista de etiquetas disponíveis.
5. Clique no ícone de **lixeira** ao lado da etiqueta que deseja excluir.

<figure><img src="/files/8ZgRBWEZck1I6lTecaJJ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/xlaAICqeVWNlEttgib3A" alt=""><figcaption></figcaption></figure>

#### **Passo 2: Verificar o impacto**

Ao clicar em excluir, o modal **"Excluir etiqueta de contatos"** será aberto. O sistema calcula automaticamente quantos contatos possuem essa etiqueta e exibe um alerta em destaque:

* **Se a etiqueta estiver vinculada a contatos:** o alerta exibirá *"X contatos serão afetados."*

<figure><img src="/files/kIAkyhy6tvw0lnWxLLpT" alt=""><figcaption></figcaption></figure>

* **Se a etiqueta não estiver vinculada a nenhum contato:** o alerta exibirá *"Nenhum contato será afetado."*

<figure><img src="/files/IiwPrugQpUaLdZYBXiIA" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
A mensagem de aviso no modal informa: ***"Ao excluir esta etiqueta, ela será removida permanentemente de todos os contatos associados. Esta ação não pode ser desfeita."***
{% endhint %}

#### **Passo 3: Confirmar a exclusão**

O próximo passo depende do impacto identificado:

* **Sem contatos afetados (0 contatos):** clique em **"Excluir etiqueta"** e a exclusão será processada imediatamente, sem etapas adicionais.
* **Com contatos afetados (1 ou mais):** ao clicar em **"Excluir etiqueta"**, a ação será retida e o sistema abrirá o modal de **"Validação de acesso"**, solicitando um código de segurança enviado para o seu e-mail.

<figure><img src="/files/eYDir1dDk5GOiyQ0BpxF" alt=""><figcaption></figcaption></figure>

#### **Passo 4: Inserir o código de validação (quando solicitado)**

1. Acesse o e-mail/telefone cadastrado no usuário que fez a solicitação de exclusão.
2. Localize o código de validação recebido.
3. Insira o código no modal de **"Validação de acesso"** e confirme.
4. Após a validação correta, a exclusão será concluída e a etiqueta removida de todos os contatos vinculados.

**Resumo dos cenários de exclusão**

| Situação                             | Validação exigida             | O que acontece                                  |
| ------------------------------------ | ----------------------------- | ----------------------------------------------- |
| Etiqueta **sem** contatos vinculados | Nenhuma                       | Exclusão imediata ao confirmar no modal         |
| Etiqueta **com** contatos vinculados | Código OTP por e-mail/celular | Exclusão concluída apenas após inserir o código |

### **Registro na Auditoria**

Toda exclusão de etiqueta fica registrada no **Histórico de Alterações**, acessível em **Admin > Auditoria**. Os logs gerados variam conforme o cenário:

* **Exclusão sem impacto:** um registro na entidade **"Etiquetas"**, com o nome da tag excluída.
* **Exclusão com impacto (via OTP):** dois registros — um na entidade **"Etiquetas"** (exclusão) e outro na entidade **"OTP Validação"** (confirmação de segurança).

<figure><img src="/files/rCaoPwX6VgqxVPt9o2wl" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/eIjH4zw4l8sINvVGrWRR" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Dica:** Caso queira cancelar a ação em qualquer etapa, clique em **"Cancelar"** no modal. Nenhuma alteração será feita e a etiqueta permanecerá intacta.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.flw.chat/guide/documentacao/crm/contato/gerenciar-etiquetas/excluir-etiquetas.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.