O que é uma tag?
É um rótulo reutilizável no workspace, ex.:Lead, VIP, Cliente, Black Friday. Você cria uma vez e aplica em quantos contatos quiser.
Analogia: pense numa etiqueta colorida na pasta do cliente. A tag não muda quem a pessoa é — só ajuda você a achar e agrupar depois.
Tag × tópico × segmento
Quando usar?
Funciona muito bem para classificar leads, marcar clientes ativos, separar origem (Site, Loja) ou sinalizar status interno (Aguardando retorno). Para opt-in legal de marketing por tema, use tópicos.
Como funciona na prática
- Audience → Tags → New, escolha um nome curto e claro (
VIP,Lead) - Na ficha do contato ou na importação, associe uma ou mais tags
- Monte um segmento com regra
type: tagpara filtrar quem tem aquela etiqueta - Use o segmento como audiência de uma campanha
Uma tag não bloqueia envio sozinha. Quem tem tag
VIP ainda precisa passar pelas regras de marketing e supressões na hora do disparo.Tags em segmentos
Exemplo: contatos com tag VIP que aceitam marketing:property, contactField ou topic — veja Segmentos na audiência.
Na API
Escopostags:read, tags:create, tags:update, tags:delete. Rotas no grupo Tags da referência da API.
No contato, envie tagIds no create/patch ou use a rota de tags do workspace.
Erros frequentes
- Confundir tag com tópico — tag é etiqueta interna; tópico é consentimento por assunto
- Esperar que tag substitua supressão — quem pediu para não ser contatado continua na lista de supressões
tagIdde outro workspace no segmento → erro na validação
Próximos passos
- Quick Start — Tags
- Segmentos na audiência: montar públicos com regra
tag - Tópicos de comunicação: consentimento por tema
- Campanhas no painel: disparo em lote
- Introdução: mapa dos conceitos

