Tags em conversas

Tags em conversas servem pra categorizar o atendimento em si, não o cliente — são diferentes das tags do lead. Use pra marcar o estado da interação: urgente, reclamação, proposta-enviada, aguardando-cliente, resolvido. Quando um colega assume a conversa depois, ele vê de cara o que tá rolando só pelas tags.

As tags em conversas vêm do mesmo catálogo de tags do tenant — você não cria tags separadas pra lead vs conversa. Mas a aplicação é independente: tag aplicada na conversa não vai automaticamente pro lead vinculado, e vice-versa.

Pré-requisitos

• Conversa aberta no /chats.
• Tags cadastradas em Configurações → Tags (recomendado).

Aplicar tag numa conversa

1. Abra a conversa.
2. No painel lateral direito, localize a seção Tags.
3. Clique no campo (input com placeholder "Selecionar tag" ou "Digitar tag...").
4. Comece a digitar — autocomplete mostra tags existentes do catálogo.
5. Selecione a tag desejada (ou digite nome novo + Enter pra criar).
6. A tag é adicionada como chip colorido no painel.
7. Pra remover, clique no X do chip.
8. Mudanças são salvas automaticamente (não precisa botão Salvar).

Tags vs lead vs conversa — diferença

Você pode (e deve) usar ambos — tag no lead pra qualificar a pessoa, tag na conversa pra qualificar a interação atual.

Casos de uso comuns

Urgência

• urgente (vermelho)
• prioridade-alta (laranja)
• pode-esperar (cinza)

Útil pra ordenar atendimento — vendedor focado primeiro nos urgentes.

Estado do atendimento

• aguardando-cliente — esperando cliente responder
• aguardando-interno — esperando alguém interno (produto, financeiro, etc.)
• proposta-enviada
• proposta-aprovada
• proposta-recusada

Status visual rápido pro time inteiro.

Tipo de assunto

• duvida-tecnica
• reclamacao
• cancelamento
• upsell
• renovacao

Permite filtrar conversas por categoria pra coordenadores.

Estágio especial

• vip-em-andamento
• enterprise-trial
• aguardando-pagamento

Marcadores de fluxo especial.

Filtrar conversas por tag

Hoje a UI do /chats não tem filtro nativo por tag de conversa no sidebar (depende da versão). Se sua versão tem:

1. Use o filtro de Tag no topo da sidebar.
2. Selecione a tag.
3. Lista mostra só conversas com aquela tag.

Combine com outros filtros (canal, status, atribuído) pra recortes precisos.

💡 Dica: pra agilidade, use conventions de nomes: tags de urgência sempre vermelhas, estado sempre azul, etc. Times treinados aprendem a "ler o painel" só pela cor.

Catálogo de tags

O catálogo é único do tenant — gerenciado em Configurações → Tags:

1. Vá em Configurações → Tags.
2. Veja a lista existente.
3. Clique em Nova tag:

• Nome (snake_case ou kebab-case)
• Cor (hex, default azul)
• Aplica a: Lead, Conversa, ou Ambos (default)

4. Salve.

Tags com applies_to=conversa ou both aparecem no autocomplete do chat.

Tag aplicada via automação

Você pode usar automações pra aplicar tags em conversas automaticamente:

• "Quando conversa fica > 24h sem resposta interna, aplica tag aguardando-resposta-urgente".
• "Quando IA detecta intent de cancelamento, aplica tag risco-churn".
• "Quando lead vinculado tem tag vip, aplica tag vip-em-andamento na conversa".

Veja Automações.

Tag aplicada via agente IA

Agentes IA podem aplicar tags via tool específica se configurada:

• IA detecta tom da conversa.
• Chama tool add_conversation_tag.
• Tag é aplicada.

Veja Tools do agente IA.

Limpar tags ao fechar

Recomendação operacional: antes de fechar uma conversa, limpe ou padronize as tags:

• Remove urgente (não é mais urgente, foi resolvida).
• Mantém proposta-aprovada (registro do que aconteceu).
• Adiciona resolvido se faz sentido.

Conversas fechadas com tags antigas viram ruído depois.

Tags são polimórficas

Tecnicamente, tags no Syncro usam trait HasTags polimórfico — a mesma tag (ex: urgente) pode estar aplicada em:

• Vários leads
• Várias conversas WhatsApp
• Várias conversas Instagram
• Várias conversas Site

Tudo via tabela pivot única (taggables). Você não precisa criar tag separada pra cada canal.

Histórico de tags

Quando uma tag é adicionada/removida, o evento fica no Audit Log (visível só pra admins). Pra rastrear "quando essa conversa virou urgente?", consulta o Audit Log.

Veja Audit Log.

Tags polimórficas vs coluna JSON legada

Internamente, o Syncro usa dual-write durante o período de migração:

• Coluna JSON tags (legado) — array de strings na própria conversa.
• Pivot taggables (novo) — relacionamento polimórfico.

Os dois são atualizados em sincronia. Pra você como usuário, isso é transparente — os dois funcionam.

Limites

Não há limite formal de quantas tags por conversa, mas 3-5 tags é o ideal pra clareza visual. Conversas com 10+ tags viram ruído — considere consolidar.

Próximos passos

• Pra criar/gerenciar tags do catálogo, veja Configurações → Tags (Tags de contatos cobre o catálogo).
• Pra automatizar aplicação de tag, veja Automações.

Artigos relacionados

• Tags de contatos
• Caixa unificada — visão geral
• Automações