Tags do Contato

O que é

Ferramenta nativa que permite ao agente ver, aplicar e remover tags do contato externo da conversa atual. Tags são rótulos coloridos e reutilizáveis na organização (ex.: “lead quente”, “cliente”, “aguardando pagamento”) — quando o agente aplica uma tag que ainda não existe, ela é criada na hora.

As tags são as mesmas que a equipe vê e gerencia no inbox. Para o conceito completo (catálogo, cores, filtro, painel do contato), veja Tags de Contato.

Quando usar

• Qualificar leads automaticamente — marcar lead quente quando o cliente pede uma proposta, frio quando só está pesquisando.
• Sinalizar etapas comerciais — aguardando pagamento, cliente, cancelado — para o time comercial filtrar o inbox depois.
• Roteamento e priorização — taguear o contato para que um humano (ou outro fluxo) saiba o que fazer com ele.
• Remover tags que não valem mais — tirar aguardando pagamento quando o pagamento entra.

Configuração

A ferramenta não tem configuração — basta ativá-la.

1. Na aba Ferramentas do agente, clique em + Adicionar Ferramenta.
2. Em FERRAMENTAS NATIVAS, escolha Tags do contato.

No prompt do agente, oriente quando aplicar cada tag. Sem instrução explícita, o modelo usa a ferramenta de forma esporádica. Por exemplo:

“Quando o cliente demonstrar intenção de compra, aplique a tag lead quente. Quando ele confirmar o pagamento, remova aguardando pagamento e aplique cliente.”

Como o agente invoca

A ferramenta tem três ações:

• Listar — o agente lê as tags atualmente aplicadas ao contato.
• Adicionar — aplica uma tag pelo nome. Se a tag não existe no catálogo da organização, ela é criada automaticamente (com uma cor atribuída de forma determinística).
• Remover — tira uma tag do contato pelo nome (a tag continua no catálogo da organização).

O agente decide a ação e o nome da tag a partir do contexto da conversa e do que você escreveu no prompt.

Limitações e notas

• Só funciona em contatos externos. Tags pertencem ao contato (WhatsApp, Telegram, Instagram, chat público, widget, API). Em conversas internas do Hub não há contato externo, então a ferramenta não tem onde aplicar e responde que não há contato.
• Tags são da organização, não da conversa. Uma tag aplicada pelo agente aparece na hora no painel da equipe, e segue com o contato entre conversas e canais.
• Criação sob demanda. Adicionar uma tag inexistente cria a tag no catálogo. Para evitar variações duplicadas (lead-quente, Lead Quente, lead quente), padronize os nomes no prompt.
• Remover do contato ≠ excluir do catálogo. A ação de remover só desfaz a aplicação naquele contato. Excluir a tag do catálogo é feito pela equipe no diálogo Gerenciar tags.
• Requer modelo com suporte a tools. Como toda ferramenta nativa, depende de o modelo do agente suportar function calling.