> 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/atendimento/adicionar-um-rotulo-no-atendimento.md).

# Adicionar um rótulo no atendimento

## 🏷️ Adicionar um rótulo no atendimento

O módulo **Adicionar um rótulo no atendimento** adiciona, substitui ou remove rótulos do atendimento em andamento no Hyperflow Conversas. Os rótulos ajudam a organizar, filtrar e gerar relatórios sobre os atendimentos.

{% hint style="info" %}
Este módulo só tem efeito se já existir um atendimento ativo no momento em que ele for executado (por exemplo, depois de um módulo **Iniciar/Atualizar Atendimento** ou **Transferir para o atendente**). Se não houver atendimento ativo, o módulo não faz nada e o fluxo simplesmente continua.
{% endhint %}

<figure><img src="/files/VVI0OjK2gEC3uCwCLKen" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Etiquetar Atendimento na área de trabalho do fluxo.</p></figcaption></figure>

***

### 🧭 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 **Atendimento** (identificada pela cor laranja).
5. Arraste o módulo **Adicionar um rótulo no atendimento** para a área de trabalho do fluxo.

<figure><img src="/files/x3XGnTgmJ4aVWKFgEern" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Atendimento expandida e o módulo Etiquetar Atendimento visível.</p></figcaption></figure>

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma conta do Hyperflow Conversas conectada, com os rótulos já cadastrados por lá (a não ser que você use a opção de informar o rótulo por variável ou nome, explicada abaixo).

Os rótulos são cadastrados diretamente no Hyperflow Conversas, em **Organização > Rótulos**. Depois de cadastrar os rótulos necessários, volte para a área de trabalho do fluxo e reabra o módulo **Adicionar um rótulo no atendimento** para selecioná-los.
{% 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.

<figure><img src="/files/TLEjwmcjvFSObc8PRpDi" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Etiquetar Atendimento aberto.</p></figcaption></figure>

***

#### 🧩 Ação

Escolha o que fazer com os rótulos do atendimento:

* **Adicionar** — inclui os rótulos selecionados, mantendo os que já existiam.
* **Sobrescrever** — substitui todos os rótulos do atendimento pelos selecionados aqui.
* **Remover** — retira os rótulos selecionados, mantendo os demais.

***

#### 🏷️ Rótulos

Escolha como os rótulos serão informados:

* **Selecionar rótulos** — escolha um ou mais rótulos já cadastrados, em uma lista.
* **Usar variável ou nome** — informe o nome de um rótulo ou uma variável do fluxo que contenha esse nome.

{% hint style="warning" %}
Quando usar **Selecionar rótulos**, se algum rótulo escolhido for excluído depois no Hyperflow Conversas, ele aparece destacado como indisponível no módulo — revise a configuração nesse caso.
{% endhint %}

<figure><img src="/files/XJBMgd1PpvEYhVTC2gSD" alt=""><figcaption><p>Imagem 4 - Campo Etiquetas com a lista de etiquetas cadastradas selecionadas.</p></figcaption></figure>

***

#### 🔀 Saída do módulo

O módulo segue automaticamente para o próximo módulo do fluxo. Se não for possível aplicar o rótulo (por exemplo, o rótulo informado por variável não existir), o fluxo **continua normalmente mesmo assim**, sem interromper ou sinalizar erro.

<figure><img src="/files/e6zwlrtdAjbihzvrBRwa" alt=""><figcaption><p>Imagem 5 - Módulo na área de trabalho do fluxo conectado ao próximo módulo.</p></figcaption></figure>

***

### 💡 Caso de uso

**Cenário:** uma empresa quer marcar automaticamente como "VIP" os atendimentos de clientes com um determinado plano.

**Configuração:**

1. Após identificar que o cliente tem o plano correspondente, adicione o módulo **Adicionar um rótulo no atendimento**.
2. No campo **Ação**, selecione **Adicionar**.
3. No campo **Rótulos**, selecione o rótulo "VIP" já cadastrado no Hyperflow Conversas.
4. Conecte a saída à continuidade normal do atendimento.

**Resultado:** todos os atendimentos desses clientes ficam automaticamente marcados com o rótulo "VIP", facilitando a identificação e os relatórios no Hyperflow Conversas.

***

### 📌 Dicas úteis

* Use **Sobrescrever** com cuidado — ele substitui todos os rótulos existentes, não apenas adiciona.
* Use a opção **Usar variável ou nome** quando o rótulo certo depender de uma informação capturada durante a conversa.
* Cadastre os rótulos no Hyperflow Conversas antes de configurar este módulo, para que eles apareçam na lista de seleção.
* Como o módulo não sinaliza erro visível, teste o fluxo para confirmar que os rótulos estão sendo aplicados como esperado.

***

### 📝 Resumo

* O módulo **Adicionar um rótulo no atendimento** adiciona, substitui ou remove rótulos do atendimento ativo.
* Os rótulos podem ser escolhidos em lista ou informados por variável/nome.
* Só tem efeito se já existir um atendimento ativo no momento da execução.
* O fluxo sempre continua normalmente, mesmo que o rótulo não possa ser aplicado.
