Tags de Contato

Tags são rótulos coloridos que você aplica a um contato externo para classificá-lo — “lead quente”, “cliente”, “aguardando pagamento”. Diferente das Anotações (que são texto livre por chave), uma tag é um marcador curto, visual e reutilizável em toda a organização: você cria uma vez e aplica em quantos contatos quiser.

Como pertencem ao contato, as tags acompanham a pessoa entre conversas e canais — se o mesmo contato voltar a falar depois, as tags continuam lá. O usuário final nunca vê as tags; elas são um eixo de organização interno da equipe.

Onde as tags aparecem

As tags ficam visíveis em dois lugares do painel admin (/admin/conversations), e só para conversas externas (WhatsApp, Telegram, Instagram, chat público, widget e canal API). Conversas internas do Hub não têm contato externo, então não têm tags.

No painel direito de uma conversa, entre Informações e Anotações, há o bloco Tags com os rótulos aplicados ao contato e um botão Adicionar:

E em cada card da lista de conversas, as tags do contato aparecem como chips coloridos abaixo do nome do agente:

Aplicar e remover tags

No bloco Tags do painel do contato:

1. Clique em Adicionar.
2. No campo de busca, digite o nome da tag.
   • Se a tag já existe na organização, ela aparece na lista — clique para aplicá-la.
   • Se não existe, aparece a opção Criar ”…” com o nome digitado — clique para criar e aplicar de uma vez.
3. Para remover uma tag do contato, clique no × ao lado do nome do chip.

Quando você cria uma tag nova, o SquadOS atribui uma cor automaticamente a partir de uma paleta de 8 cores. A mesma cor é sempre dada ao mesmo nome — você pode trocá-la depois no catálogo (veja abaixo). Remover uma tag de um contato não apaga a tag da organização: ela continua disponível para outros contatos.

Filtrar conversas por tag

Na aba Conversas Externas, o filtro Tags afunila a lista para mostrar só os contatos que têm as tags selecionadas. É multi-seleção — escolha uma ou várias:

Como todos os filtros do inbox, a seleção vai para a URL, então você pode salvar e compartilhar o link de uma visão específica (ex.: “todos os leads quentes aguardando pagamento”).

Gerenciar o catálogo de tags

O botão Gerenciar tags (ao lado do filtro) abre o catálogo de tags da organização. Ali você administra cada tag, independente de em quais contatos ela está aplicada:

Para cada tag você vê quantos contatos a usam e pode:

• Recolorir — clique em uma das 8 cores da paleta para trocar a cor da tag (a mudança vale para todos os contatos).
• Renomear — clique no lápis, edite o nome e confirme. Não é possível ter duas tags com o mesmo nome.
• Excluir — clique na lixeira. A tag é removida do catálogo e de todos os contatos que a tinham. Essa ação não pode ser desfeita.

As três formas de aplicar tags

Tags podem ser aplicadas por três caminhos, e todos compartilham o mesmo catálogo:

• Manualmente, pela equipe, no painel do contato (descrito acima).
• Pelo próprio agente, via a ferramenta nativa Tags do contato — o agente pode ver, aplicar e remover tags durante a conversa (ex.: marcar “lead quente” quando o cliente demonstra interesse).
• Pela API, via os endpoints de Tags — útil para sincronizar com um CRM ou aplicar tags em lote a partir de outro sistema.

Dica

As três fontes escrevem na mesma tabela, então uma tag aplicada pelo agente aparece na hora no painel da equipe, e vice-versa. As atualizações são em tempo real: quando alguém (ou o agente) aplica ou remove uma tag, os chips e os contadores do inbox mudam para todo mundo sem precisar recarregar.

Quem pode usar tags

Aplicar, remover e gerenciar tags exige papel de colaborador ou superior (colaborador, admin ou dono da organização). Membros com papel de usuário comum não conseguem alterar tags. Veja a tabela de permissões para o detalhe de cada papel.

Boas práticas

• Poucas tags, bem definidas. Um punhado de tags claras (“lead”, “cliente”, “VIP”, “aguardando pagamento”) organiza melhor que dezenas de variações parecidas. Antes de criar uma nova, confira se já não existe uma equivalente no catálogo.
• Padronize com o agente. Se você quer que o agente aplique tags sozinho, descreva no prompt quando usar cada uma (“marque lead quente quando o cliente pedir proposta”). Sem isso, o agente usa a ferramenta de forma esporádica.
• Use o filtro como fila de trabalho. Combine o filtro de tag com o estado Humano para isolar, por exemplo, todos os clientes que precisam de uma pessoa e já estão marcados como prioridade.
• Reserve dados sensíveis para as Anotações ou integrações seguras. Tags são rótulos curtos e visíveis a toda a equipe — não são o lugar para informações privadas.