> 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/apps/chatbot/adicionar-remover-etiquetas-do-contato.md).
# Adicionar/Remover Etiquetas do Contato
O bloco **Adicionar/remover etiquetas do contato** permite aplicar ou retirar etiquetas de um contato automaticamente durante o fluxo do chatbot — sem precisar fazer isso manualmente pela tela de Contatos. Ele fica disponível no grupo **Contato**, dentro das ações do builder.
#### Passo 1: Adicionar o bloco ao fluxo
1. No builder do chatbot, clique no **ícone "+"** para adicionar uma nova ação ao fluxo.
2. Na lista de **Ações disponíveis**, localize o grupo **Contato**.
3. Clique em **Adicionar/remover etiquetas do contato**.
#### Passo 2: Escolher a operação
O bloco possui dois modos de operação — selecione o que deseja realizar:
* **Adicionar etiqueta** — aplica uma ou mais etiquetas ao contato.
* **Remover etiqueta** — retira uma ou mais etiquetas do contato.
#### Passo 3: Selecionar as etiquetas
1. Clique no botão **"+"** ao lado do campo de etiquetas.
2. Um modal será aberto com a lista de etiquetas disponíveis, exibidas em **ordem alfabética**.
3. Use o **campo de pesquisa** para localizar uma etiqueta pelo nome.
4. Marque o **checkbox** ao lado de cada etiqueta que deseja aplicar ou remover.
5. Um **contador** ao lado do título "Etiquetas" é atualizado dinamicamente conforme você seleciona ou desmarca as opções.
6. Clique em **Adicionar** para confirmar a seleção.
#### Criar uma nova etiqueta pelo builder
Não encontrou a etiqueta que precisa? É possível criar uma nova diretamente pelo modal, sem sair do chatbot:
1. No modal de etiquetas, clique no botão **"+"** ao lado da barra de pesquisa.
2. O modal **Criar nova etiqueta** será aberto.
3. Informe o **nome** da etiqueta e selecione uma **cor**.
4. Clique em **Salvar**.
A nova etiqueta será criada e exibida imediatamente na listagem, já disponível para seleção.
{% hint style="warning" %}
⚠️ Pelo builder é possível apenas **criar** novas etiquetas. Para **editar** o nome, a cor ou **excluir** uma etiqueta existente, acesse a tela de **Contatos** na plataforma.
{% endhint %}
#### Como funciona no fluxo
Ao adicionar o bloco ao chatbot, ele será executado automaticamente sempre que o contato passar por aquele ponto do fluxo. Isso permite, por exemplo:
* Aplicar uma etiqueta quando o contato responder a uma pergunta específica
* Remover uma etiqueta ao concluir uma etapa do atendimento
* Categorizar contatos automaticamente com base no caminho percorrido no chatbot
---
# 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, and the optional `goal` query parameter:
```
GET https://docs.flw.chat/guide/documentacao/apps/chatbot/adicionar-remover-etiquetas-do-contato.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.