Tags são a forma de segmentar clientes dentro da Kontato. Você pode atribuir, criar e gerenciar tags direto na conversa — sem ir pra tela de Clientes.
Onde aparecem na conversa
No header da timeline (topo), abaixo do nome do cliente, aparecem as tags atuais como chips coloridos. Ao lado, um botão (+) tracejado pra adicionar nova.
Cada tag tem:
- Nome (ex: "VIP", "Inadimplente", "Fidelizado")
- Cor (de uma paleta de 16 cores)
- Tamanho
smoumddependendo do contexto
Atribuir tag
Click no (+) abre o TagPicker — modal que mostra:
- Lista de tags existentes do negócio com checkbox
- Campo "Criar nova" com input de nome + paleta de cor
- Tags já atribuídas aparecem desabilitadas (pra não duplicar)
Selecione uma tag existente ou crie nova. Confirmação é instantânea — chip aparece no header.
Tag criada na conversa fica no banco de tags do negócio
Toda tag nova vira tag global. Se você cria "Aniversariante" na conversa da Maria, ela aparece como opção pra todos os outros clientes também.
Remover tag (click rápido)
Click numa tag existente abre modal de confirmação:
Remover esta tag deste cliente? A tag continua existindo e pode ser atribuída de novo. Para deletar globalmente, use pressionar e segurar.
Confirma → tag sai do cliente. Tag em si continua no banco — outros clientes que a têm não são afetados.
Editar / deletar global (pressionar e segurar)
Long-press numa tag (mobile) ou click direito + segurar abre o TagActionsMenu com 4 opções:
- Renomear — abre input com nome atual, salva via
PATCH /api/tags/:id - Mudar cor — abre paleta de 16 cores, salva
- Remover deste cliente — mesmo efeito do click rápido
- Deletar tag globalmente — pede dupla confirmação, remove de todos os clientes que tinham e apaga do banco. Não dá pra desfazer.
Deletar global é irreversível
Cuidado com "Deletar tag globalmente" — apaga de tudo lugar que ela aparecia. Se quer só tirar de um cliente, use a opção "Remover deste cliente".
Sugestões automáticas (IA)
Quando uma conversa encerra (cron 24h sem mensagem ou bot via tool), a IA analisa a conversa toda e sugere tags. Aparece um modal TagSugestaoModal com:
- Ação sugerida: "Atribuir" ou "Remover"
- Tag sugerida (chip colorido)
- Cliente alvo ("Atribuir tag VIP para Maria Silva")
- Razão da sugestão (ex: "Cliente fez 8 agendamentos nos últimos 3 meses, gasto médio R$ 250 por sessão")
- 3 botões: Aplicar tag · Recusar · Recusar e bloquear
"Recusar e bloquear" marca a sugestão como blacklist — IA nunca mais sugere essa tag pra esse cliente automaticamente.
Filtrar conversas por tag
Tags são integradas com o filtro de tags na lista lateral (ver Buscar e filtrar conversas). Você pode marcar várias tags e ver só conversas de clientes que têm pelo menos uma delas.
Realtime nas tags
Se outro dono atribui ou remove uma tag enquanto você está com a conversa aberta, o chip atualiza automaticamente sem reload. Isso vem do realtime nas tabelas cliente_tags e tags (Supabase postgres_changes).