Skip to main content
A tag é uma etiqueta colorida no lead. Serve para marcar o que importa (“Quente”, “Pediu orçamento”, “Cliente”), filtrar contatos e conversas, segmentar campanhas e decidir quais automações valem para cada lead. Cada tag tem um vínculo: fica no contato para sempre ou só na conversa atual.

​
Onde fica no painel

  • Contatos → aba Tags: criar, editar e excluir as tags do projeto.
  • Painel do lead (em Conversas): pôr e tirar tags de um lead.
  • Contatos → Lista: coluna Tags, filtro Filtrar por Tags e as ações em massa Adicionar e Remover tag.
  • Kanban e Conversas: filtro por tags.

​
Como configurar

​
Contato ou conversa?

​
Como funciona por trás

  • Ao encerrar o atendimento, as tags de vínculo Conversa saem do lead e ficam guardadas no histórico daquela conversa (Conversas anteriores). As de vínculo Contato continuam. Veja Encerrar atendimento.
  • O agente vê as tags do lead no contexto de cada resposta, pelo nome. Veja O que a Zatten injeta no contexto.
  • O agente pode pôr e tirar tags com as ações da Zatten (adicionar, definir e remover tag), cada uma apontando para uma tag específica. Veja Ações da Zatten.
  • Automações filtram por tag. Num follow-up, reengajamento ou webhook por inatividade, basta o lead ter uma das tags do filtro; filtro vazio vale para todos. Veja Follow-up.
  • Campanhas filtram por tag junto com coluna e propriedades. Veja Campanhas.
  • Pôr ou tirar uma tag pode disparar o webhook de eventos de tags e os fluxos com os gatilhos “tag adicionada” e “tag removida”. Veja Webhooks de eventos e Trigger Flow: blocos.

​
Excluir uma tag

  • Se o agente usa a tag numa tool, a tela pede confirmação e a tool sai do agente junto com a tag.
  • Antes de excluir, tire a tag dos leads. Filtre por ela em Contatos → Lista, selecione todos e use Remover.
  • Revise as automações que filtram pela tag. Um follow-up ou webhook por inatividade que filtrava só por ela pode deixar de valer para qualquer lead.

​
Pelo MCP

As tags viajam no bloco tags do template.
  • Renomeie pelo slug. Sem o slug, um nome novo cria outra tag e a antiga vira órfã.
  • Cor obrigatória, no formato #RRGGBB (seis dígitos).
  • A escrita nunca apaga tag. Tag que não veio fica como órfã, intacta.
  • Follow-ups, webhooks por inatividade, transbordos e fluxos apontam para tags pelo nome. Tag inexistente é retirada do filtro, com nota.
  • Se o agente usa a tag numa tool, ao renomear mande também o bloco langchain na mesma escrita.

​
Armadilhas

  • Vínculo errado some com a tag. Uma tag “Cliente” com vínculo Conversa sai do lead no primeiro encerramento. Revise o vínculo de cada tag antes de pôr automações em cima dela.
  • Nomes repetidos. O painel aceita duas tags com o mesmo nome, mas automações, tools e template as distinguem pelo nome. Use nomes únicos.
  • Filtro de contatos por várias tags pede todas. Em Contatos, marcar duas tags mostra só quem tem as duas. Já nos filtros de automação, basta uma.
  • Excluir é para tag sem uso. Tire a tag dos leads e das automações antes de excluir.

​
Perguntas frequentes

Tag é sim ou não (“é cliente”). Propriedade guarda um valor (“plano: anual”, “cidade: Campinas”). Se a resposta tem mais de duas opções, use uma propriedade com lista de valores.
Coluna é a etapa do funil: o lead está em uma só. Tags se acumulam. Use coluna para “onde o lead está” e tag para “o que se sabe dele”.
Em Contatos → Lista, filtre, selecione e use Adicionar. Na importação por CSV, dá para escolher uma tag para todos os contatos do arquivo.

​
Para saber mais