Funcionalidades de Tags

Última atualização em Sep 02, 2026

As Tags agora fazem parte do CloudChat. São etiquetas que você cria para organizar e classificar conversas e contatos — toda a gestão (criar, editar, excluir, importar e exportar) acontece direto na plataforma, em Configurações > Tags.

O que são tags?

Tags são etiquetas que você cria para organizar e classificar conversas e contatos. Cada tag tem um nome, uma cor e uma descrição opcional.

Exemplos de uso: marcar conversas por tema ("cobrança", "cancelamento"), por prioridade ("urgente"), por campanha ("black-friday-2026") ou por qualquer critério que faça sentido para a sua operação.


Onde encontro as tags?

As tags aparecem em três lugares:

  • Configurações > Tags — página de gerenciamento onde você cria, edita, exclui, importa e exporta tags

  • Barra lateral da conversa — para aplicar ou remover tags de uma conversa específica

  • Perfil do contato — para aplicar ou remover tags de um contato


Quem pode gerenciar tags?

Ação Assistente Agente Supervisor CX Engineer Administrador
Aplicar e remover tags em conversas e contatos
Filtrar conversas por tag
Acessar a tela Configurações > Tags
Criar, editar e excluir tags
Importar CSV
Exportar CSV

Ou seja: Administrador e CX Engineer gerenciam as tags na tela de Configurações. Qualquer usuário autenticado (Assistente, Agente, Supervisor) continua podendo aplicar e remover tags em conversas e contatos, e filtrar por tag.

Se o seu perfil é Assistente, Agente ou Supervisor, o item Tags não aparece no menu de Configurações. Isso é esperado — não é erro de configuração da sua conta.

Não encontro a opção "Exportar CSV" na tela de Tags. Por quê?

O botão fica no menu de ações da própria tela: em Configurações > Tags, clique na seta para baixo (˅) ao lado do botão laranja "Adicionar tag", no canto superior direito. O menu abre com Importar CSV e Exportar CSV.

Se você não encontra nem esse menu nem o botão "Adicionar tag", verifique nesta ordem:

  1. Seu perfil. O menu de ações só aparece para Administrador e CX Engineer. Se você é Assistente, Agente ou Supervisor, a tela de Tags não fica disponível — peça a um Administrador para gerar o arquivo. Para conferir o seu perfil: Configurações > Agentes.
  2. Onde você está olhando. A exportação está na tela de gerenciamento (Configurações > Tags), não na barra lateral da conversa nem no perfil do contato — nesses dois lugares você só aplica e remove tags.

Se você é Administrador ou CX Engineer e mesmo assim a tela não aparece no menu, fale com o suporte: pode ser um ajuste pendente na sua conta.

O que vem no CSV exportado?

Um arquivo tags_export_AAAA-MM-DD.csv com todas as tags da conta (não apenas as da página visível), nas colunas name, description e color — as mesmas aceitas na importação, então o arquivo exportado serve direto como base para preparar uma importação.

A página de gerenciamento de Tags

Acesse pelo menu lateral: Configurações > Tags. Nessa tela você vê todas as tags da conta, com nome, descrição e cor, e tem as ações de buscar, ordenar, adicionar, editar, excluir, importar e exportar.

Como criar uma tag

  1. Vá em Configurações > Tags

  2. Clique em Adicionar tag

  3. Preencha o nome (obrigatório), descrição, cor e se ela deve ser exibida no menu lateral

  4. Clique em Criar

Regras de nome:

  • Mínimo de 2 caracteres

  • Apenas letras, números, hifens (-) e underscores (_)

  • Sem espaços ou caracteres especiais

  • Convertido automaticamente para minúsculas

  • Deve ser único na conta


Como aplicar tags a uma conversa

  1. Abra a conversa

  2. Na barra lateral direita, localize a seção de tags

  3. Pesquise e selecione a tag desejada

Você também pode aplicar tags em massa: selecione várias conversas na lista e use a ação de tags no menu de ações em lote.

Para remover uma tag, clique no "x" ao lado dela na barra lateral da conversa.


Como aplicar tags a um contato

  1. Abra o perfil do contato

  2. Localize a seção de tags

  3. Pesquise e selecione a tag desejada


Como filtrar conversas por tag

Use os filtros de conversa para buscar por tag:

  1. Na lista de conversas, abra os filtros

  2. Selecione o atributo Tags

  3. Escolha uma ou mais tags

Você também pode salvar essa combinação como uma visualização personalizada para acesso rápido.


Busca e ordenação de tags

Na página Configurações > Tags, o campo de busca filtra tags por nome ou descrição conforme você digita.

O dropdown de ordenação permite organizar a lista por ordem alfabética (A-Z ou Z-A) ou por data de criação (mais recentes ou mais antigas).


Exportação CSV

A opção Exportar CSV na página de tags gera um arquivo com todas as tags da conta, contendo nome, descrição e cor.

O CSV pode ser usado como backup, para conferência ou como base para preparar um arquivo de importação.


Importação CSV

A opção Importar CSV permite criar tags em massa a partir de um arquivo CSV.

Como importar:

  1. Na tela de importação, baixe o template de exemplo clicando no link disponível — ele já vem com as colunas corretas (name, description, color) e linhas de exemplo para você preencher

  2. Edite o arquivo com suas tags (apenas name é obrigatório)

  3. Selecione o arquivo (limite de 1 MB)

  4. Clique em Importar CSV

O processamento acontece em segundo plano. Ao concluir, você recebe um e-mail com o resumo da importação: quantas tags foram criadas com sucesso, quantas já existiam (duplicadas) e quantas tiveram erro. Se houver erros, o e-mail inclui um arquivo CSV anexo com o detalhamento de cada linha que falhou e o motivo do erro.

Regras da importação:

Situação Comportamento
Tag com mesmo nome já existe Ignorada (contada como duplicada)
Nome em branco Linha rejeitada
Nome com caracteres inválidos (espaços, caracteres especiais) Linha rejeitada
Cor inválida ou em branco Cor padrão aplicada (azul)
Arquivo maior que 1 MB Rejeitado antes do processamento

Tags em automações e macros

Tags podem ser usadas em regras de automação e macros:

  • Como condição — dispare uma automação quando uma conversa tiver (ou não) determinada tag

  • Como ação — adicione ou remova tags automaticamente quando uma regra for acionada

Exemplos:

  • Quando uma conversa for atribuída ao time de cobrança, adicionar a tag "cobranca" automaticamente

  • Quando uma conversa receber a tag "urgente", atribuir a um agente específico

Macros também permitem adicionar ou remover tags como parte de uma sequência de ações que o agente executa manualmente.


Perguntas frequentes

Posso aplicar a mesma tag a conversas e contatos? Sim. As tags são compartilhadas — a mesma tag pode ser usada em conversas e contatos.

O que acontece se eu excluir uma tag? A tag é removida de todas as conversas e contatos que a utilizavam.

Posso renomear uma tag? Sim, editando a tag em Configurações > Tags. O novo nome é aplicado em todos os lugares onde a tag aparece.

Posso usar ponto-e-vírgula como separador no CSV? Sim. O sistema detecta automaticamente se o separador é vírgula ou ponto-e-vírgula.

Preciso preencher todas as colunas do CSV? Não. Apenas a coluna name é obrigatória. description e color são opcionais.

O que acontece se eu importar tags que já existem? Elas são ignoradas sem erro. O resumo da importação mostra quantas foram puladas como duplicadas.