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.

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.

Imagem 1 - Visão geral do módulo Etiquetar Atendimento 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 Atendimento (identificada pela cor laranja).

5. Arraste o módulo Adicionar um rótulo no atendimento para a área de trabalho do fluxo.

Imagem 2 - Painel de módulos com a categoria Atendimento expandida e o módulo Etiquetar Atendimento visível.

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.

---

🔍 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.

Imagem 3 - Painel de configuração do módulo Etiquetar Atendimento aberto.

---

🧩 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.

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.

Imagem 4 - Campo Etiquetas com a lista de etiquetas cadastradas selecionadas.

---

🌐 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.

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

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.

---

🔀 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.

Imagem 6 - Módulo na área de trabalho do fluxo conectado ao próximo módulo.

---

💡 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.