> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/acao/tag-do-usuario.md).

# Tag do usuário

O módulo **Tag do Usuário** adiciona, remove, sobrescreve ou verifica tags associadas ao contato (usuário) que está conversando no fluxo. As tags ficam salvas diretamente no cadastro do contato e ajudam a identificar, segmentar e organizar seus usuários — por exemplo, marcar quem já comprou um produto, quem é de um determinado plano ou quem completou uma etapa do atendimento.

{% hint style="info" %}
Este módulo é diferente do módulo **Etiquetar Atendimento**: o **Tag do Usuário** marca o **contato**, e a marcação fica salva no cadastro dele (vale para qualquer atendimento futuro, com ou sem atendimento ativo no momento). Já o **Etiquetar Atendimento** marca apenas o **atendimento em andamento** no Hyperflow Conversas. Escolha o módulo de acordo com o que você quer identificar: a pessoa ou a conversa.
{% endhint %}

**📷 Inserir print:** visão geral do módulo Tag do Usuário na área de trabalho do fluxo

***

## 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Ação** (identificada pela cor correspondente).
5. Arraste o módulo **Tag do Usuário** para a área de trabalho do fluxo.

**📷 Inserir print:** painel de módulos com a categoria Ação expandida e o módulo Tag do Usuário visível

{% hint style="warning" %}
**Antes de usar este módulo:** cadastre as tags que deseja utilizar na área de tags do Hyperflow Integrações, para que elas apareçam na lista de seleção do módulo.
{% endhint %}

***

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

**📷 Inserir print:** painel de configuração do módulo Tag do Usuário aberto

***

### 🧩 Método

Escolha o que fazer com as tags do contato:

* **Adicionar** — inclui as tags selecionadas no cadastro do contato, mantendo as que já existiam.
* **Remover** — retira as tags selecionadas do cadastro do contato, mantendo as demais.
* **Sobrescrever** — substitui **todas** as tags do contato pelas selecionadas aqui.
* **Verificar** — checa se o contato já possui pelo menos uma das tags selecionadas, sem alterar o cadastro. Esse método tem duas saídas diferentes (veja **Saída do módulo** abaixo).

**📷 Inserir print:** campo Método com as quatro opções disponíveis

{% hint style="warning" %}
Use **Sobrescrever** com cuidado — ele apaga todas as tags que o contato já tinha e mantém apenas as que você selecionar aqui.
{% endhint %}

***

### 🏷️ Tag

Selecione uma ou mais tags já cadastradas na lista. Cada tag aparece com seu nome e cor para facilitar a identificação.

**📷 Inserir print:** campo Tag com a lista de tags cadastradas selecionadas

{% hint style="warning" %}
É obrigatório selecionar ao menos uma tag para que o módulo funcione. Se o fluxo for publicado sem nenhuma tag selecionada, o módulo não faz nada quando executado (segue em frente sem aplicar mudança alguma).
{% endhint %}

***

### 🔀 Saída do módulo

* **Adicionar, Remover e Sobrescrever**: o módulo segue automaticamente para o próximo módulo do fluxo depois de atualizar o cadastro do contato.
* **Verificar**: o módulo tem duas saídas:
  * **Sucesso** — o contato possui ao menos uma das tags selecionadas. O fluxo segue por essa saída.
  * **Erro** — o contato não possui nenhuma das tags selecionadas. O fluxo segue por essa saída.

**📷 Inserir print:** módulo configurado como Verificar, mostrando as saídas Sucesso e Erro

***

## 💡 Caso de uso

**Cenário:** uma empresa quer identificar automaticamente os contatos que já finalizaram uma compra, para não oferecer a mesma promoção duas vezes.

**Configuração:**

1. Após a confirmação da compra no fluxo, adicione o módulo **Tag do Usuário**.
2. No campo **Método**, selecione **Adicionar**.
3. No campo **Tag**, selecione a tag "Comprou" já cadastrada.
4. Em um fluxo futuro, antes de oferecer a promoção, adicione outro módulo **Tag do Usuário** configurado com o método **Verificar** e a mesma tag "Comprou".
5. Conecte a saída **Sucesso** para pular a oferta e a saída **Erro** para exibir a promoção normalmente.

**Resultado:** contatos que já compraram ficam marcados permanentemente, e o fluxo consegue identificar isso em qualquer conversa futura, evitando repetir a oferta.

***

## 📌 Dicas úteis

* As tags aplicadas por este módulo ficam salvas no cadastro do contato, então funcionam mesmo em conversas futuras — não é preciso ter um atendimento em andamento.
* Use o método **Verificar** para tomar decisões no fluxo com base em tags que o contato já possui, sem precisar alterar o cadastro dele.
* Cadastre as tags antes de configurar o módulo, para que elas apareçam na lista de seleção.
* Como algumas informações do módulo ainda não aparecem corretamente na área de trabalho do fluxo (por exemplo, o resumo do método escolhido no card), use o painel de configuração para conferir o que está definido, em vez de confiar apenas no que aparece no card.

***

## 📝 Resumo

* O módulo **Tag do Usuário** adiciona, remove, sobrescreve ou verifica tags no cadastro do contato.
* É diferente do módulo **Etiquetar Atendimento**, que marca o atendimento, não o contato.
* O método **Verificar** tem saídas separadas de Sucesso e Erro; os demais métodos seguem direto para o próximo módulo.
* É necessário selecionar ao menos uma tag para o módulo funcionar corretamente.
* As tags aplicadas ficam salvas no cadastro do contato e valem para qualquer conversa futura.