For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

  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


🔍 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


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


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