> 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

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="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FJ9I09GxneOcZQUnPoHja%2Fimage.png?alt=media&amp;token=ac9e2e87-ef1c-4e81-8fac-96dc59d3e332" 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="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FlnWx5U0MZW7U5K7V8V7Y%2F02-painel-modulos-atendimento.png?alt=media&amp;token=19535987-b2cc-427a-a789-efbf5f71a841" 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="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Frv5QP4RVSEwfgsuVUKWa%2F03-painel-config-aberto.png?alt=media&amp;token=86255eb8-1d35-4271-9482-7d3e42ba851d" 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="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FvMNNhvpevQtIVLJcXVrD%2Fimage.png?alt=media&amp;token=6e0b5a62-c3f7-4d70-a1cd-92244a374882" alt=""><figcaption><p>Imagem 4 - Campo Etiquetas com a lista de etiquetas cadastradas selecionadas.</p></figcaption></figure>

***

#### 🌐 Opções avançadas: rotular outro atendimento

Por padrão, este módulo aplica a etiqueta no atendimento da conversa em andamento (a sessão em execução). Na seção **Opções avançadas** do painel de configuração, é possível aplicar a etiqueta em um atendimento específico de qualquer contato, informando o protocolo dele.

Ative a chave **Operar atendimento de outro usuário** para revelar o campo:

| Campo                              | O que preencher                                                                                                                                      |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ID ou protocolo do atendimento** | O identificador do atendimento que deve ser rotulado: o número de protocolo exibido no Hyperflow Conversas, ou uma variável do fluxo que o contenha. |

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F5SaHLe9vXRo2gcFlGGHP%2Fimage.png?alt=media&amp;token=ab3105b6-1045-4505-a1ad-f950471af8d8" alt=""><figcaption><p>Imagem 5 - Seção Opções avançadas expandida, com a chave Operar atendimento de outro usuário ativada e o campo ID ou protocolo do atendimento preenchido</p></figcaption></figure>

{% hint style="info" %}
Diferente dos módulos **Transferir Atendimento** e **Encerrar Atendimento**, aqui não é preciso que o atendimento esteja em aberto: mesmo um atendimento já encerrado pode receber a etiqueta.
{% endhint %}

***

#### 🔀 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="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FWbOGjsX8rEgNc71nH5ML%2Fimage.png?alt=media&amp;token=3351b631-9afe-4024-9dc6-bf142736c570" alt=""><figcaption><p>Imagem 6 - 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 todas as etiquetas existentes, não apenas adiciona.
* Use a opção **Usar variável ou nome** quando a etiqueta certa depender de uma informação capturada durante a conversa.
* Cadastre as etiquetas no Hyperflow Conversas antes de configurar este módulo, para que elas apareçam na lista de seleção.
* Como o módulo não sinaliza erro visível, teste o fluxo para confirmar que as etiquetas estão sendo aplicadas como esperado.
* Use a seção **Opções avançadas** para rotular o atendimento de outro contato (por ID ou protocolo), inclusive um já encerrado, em vez do atendimento da conversa em andamento.

***

### 📝 Resumo

* O módulo **Etiquetar Atendimento** adiciona, substitui ou remove etiquetas do atendimento ativo.
* As etiquetas podem ser escolhidas em lista ou informadas por variável/nome.
* Nas **Opções avançadas**, é possível rotular um atendimento específico de outro contato pelo ID ou protocolo, mesmo que já esteja encerrado.
* Sem usar as Opções avançadas, o módulo só tem efeito se já existir um atendimento ativo no momento da execução.
* O fluxo sempre continua normalmente, mesmo que a etiqueta não possa ser aplicada.