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.

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.

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

🧭 Como acessar

No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Ação (identificada pela cor correspondente).
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

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.

🔍 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

Use Sobrescrever com cuidado — ele apaga todas as tags que o contato já tinha e mantém apenas as que você selecionar aqui.

🏷️ 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

É 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).

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

Após a confirmação da compra no fluxo, adicione o módulo Tag do Usuário.
No campo Método, selecione Adicionar.
No campo Tag, selecione a tag "Comprou" já cadastrada.
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".
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.