> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/remover-tags.md).

# Remover Tags

Com essa operação, a automação pode excluir tags do registro de uma pessoa, garantindo que a segmentação e o perfil do contato estejam sempre atualizados.

Com certeza. Concluindo o gerenciamento de tags, aqui está a documentação para a operação de remoção.

***

#### Página: Remover Tags

URL Sugerida: `/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/remover-tags`

(Começo do conteúdo da página)

## Remover Tags

A operação Remover Tags permite desassociar uma ou mais etiquetas (tags) de um registro de pessoa. Manter as tags de um contato atualizadas é tão importante quanto adicioná-las, pois garante que suas segmentações permaneçam precisas e relevantes.

Esta ação é útil para refletir mudanças no status ou nos interesses de um contato. Por exemplo, se um cliente cancela um serviço, você pode remover a tag "Cliente-Ativo", ou se um lead não demonstra mais interesse em um produto, a tag de interesse correspondente pode ser retirada.

A operação remove apenas as tags especificadas, mantendo todas as outras que a pessoa possa ter.

#### Como Configurar

1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação.
2. No campo "Operação", selecione a opção "Remover Tags".
3. No campo "ID da Pessoa" (`personId`), insira o identificador do contato do qual as tags serão removidas.
4. No campo "Tags", selecione as tags que deseja desassociar.

***

### Parâmetros

| Campo        | Tipo          | Obrigatório? | Descrição                                                       |
| ------------ | ------------- | ------------ | --------------------------------------------------------------- |
| ID da Pessoa | Texto         | ✅ Sim        | O ID único da pessoa (contato) da qual as tags serão removidas. |
| Tags         | Lista de Tags | ✅ Sim        | Uma ou mais tags a serem removidas do contato.                  |

Exportar para as Planilhas

***

### Estrutura (Usando JSON)

O corpo da requisição JSON deve conter um array chamado `tags` com o(s) ID(s) ou nome(s) da(s) tag(s) a ser(em) removida(s).

JSON

```
{
  "tags": [
    "tag_id_ou_nome_1",
    "tag_id_ou_nome_2"
  ]
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Quando um contato clica no link de "cancelar inscrição" de uma newsletter específica sobre "Promoções Mensais", remover a tag "Inscrito-Promocoes" do seu perfil.

1. Sua plataforma de e-mail marketing deve ser configurada para disparar um Webhook quando o link de cancelamento de inscrição da campanha "Promoções Mensais" for clicado. O webhook envia o e-mail do contato.
2. Crie um fluxo que comece com o gatilho deste Webhook.
3. Use a operação "Buscar Pessoa por E-mail" para encontrar o `personId` do contato.
4. Se a pessoa for encontrada, adicione o bloco "Pessoas" com a operação "Remover Tags".
5. No campo "ID da Pessoa", insira a variável do ID encontrado na etapa anterior (`{{steps.2.result.id}}`).
6. No campo "Tags", selecione a tag "Inscrito-Promocoes".

Com esta automação, você gerencia as preferências de comunicação dos seus contatos de forma instantânea e automatizada, garantindo conformidade e melhorando a experiência do usuário.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/remover-tags.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
