Skip to main content
Tag = etiqueta colada na ficha do contato. Não é tópico (consentimento) nem segmento (filtro). Tag marca; segmento combina tags com outras regras.

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

  1. Audience → Tags → New, escolha um nome curto e claro (VIP, Lead)
  2. Na ficha do contato ou na importação, associe uma ou mais tags
  3. Monte um segmento com regra type: tag para filtrar quem tem aquela etiqueta
  4. 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:
Combine com property, contactField ou topic — veja Segmentos na audiência.

Na API

Escopos tags: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
  • tagId de outro workspace no segmento → erro na validação

Próximos passos