> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Etiquetas en la audiencia

> Etiquetas reutilizables para marcar contactos: Lead, VIP, Cliente — y usarlas en segmentos y campañas.

<Tip>
  Una **etiqueta** es una **marca** en la ficha del contacto. **No** es un tema (consentimiento) ni un segmento (filtro). Las **etiquetas** marcan; los **segmentos** combinan etiquetas con otras reglas.
</Tip>

## ¿Qué es una etiqueta?

Es una **etiqueta reutilizable** en el espacio de trabajo, p. ej. `Lead`, `VIP`, `Cliente`, `Black Friday`. La creas una vez y la aplicas a cuantos contactos necesites.

Analogía: una **pegatina de color** en la carpeta del cliente. La etiqueta no cambia quién es la persona — solo te ayuda a **encontrar y agrupar** después.

## Etiqueta × tema × segmento

|               | **Etiqueta**                      | **Tema**                           | **Segmento**                                    |
| ------------- | --------------------------------- | ---------------------------------- | ----------------------------------------------- |
| Para qué      | **Marcar** manualmente            | **Consentimiento** por tema        | **Filtro guardado** (quién entra en el público) |
| Ejemplo       | `VIP`, `Lead caliente`            | "Acepta Newsletter"                | "Etiqueta VIP + acepta marketing"               |
| Dónde aparece | Ficha del contacto, importación   | Plantilla MARKETING + preferencias | Audiencia de campaña                            |
| En la API     | `tags:*`, `tagIds` en el contacto | `topics:*`, regla `topic`          | `segments:*`, regla `type: tag`                 |

## ¿Cuándo usar?

Funciona muy bien para **clasificar leads**, **marcar clientes activos**, **separar origen** (`Web`, `Tienda`) o **estado interno** (`Esperando respuesta`). Para **opt-in legal de marketing por tema**, usa [temas](/es/contacts-api/como-funciona/topicos-de-comunicacao).

## Cómo funciona en la práctica

1. **Audiencia → Etiquetas → Nueva**, elige un nombre corto y claro (`VIP`, `Lead`)
2. En la **ficha del contacto** o en la importación, asocia una o más etiquetas
3. Crea un **segmento** con regla `type: tag` para filtrar quién tiene esa etiqueta
4. Usa el segmento como **audiencia** de una campaña

<Note>
  Una etiqueta **no bloquea el envío** por sí sola. Quien tiene etiqueta `VIP` aún debe pasar las reglas de marketing y supresiones al disparar.
</Note>

## Etiquetas en segmentos

Ejemplo: contactos con etiqueta VIP que aceptan marketing:

```json theme={null}
{
  "version": 1,
  "match": "all",
  "rules": [
    { "type": "tag", "tagId": "TU_UUID_ETIQUETA_VIP" },
    { "type": "receiveMarketing", "value": true }
  ]
}
```

Combina con `property`, `contactField` o `topic` — ver [Segmentos en la audiencia](/es/contacts-api/como-funciona/segmentos-na-audiencia).

## En la API

Ámbitos `tags:read`, `tags:create`, `tags:update`, `tags:delete`. Rutas en el grupo **Tags** de la referencia de la API.

En el contacto, envía `tagIds` en create/patch o usa las rutas de etiquetas del espacio de trabajo.

## Errores frecuentes

* Confundir **etiqueta** con **tema** — la etiqueta es marca interna; el tema es consentimiento por asunto
* Esperar que la etiqueta reemplace una **supresión** — quien pidió no ser contactado sigue en la [lista de supresiones](/es/suppressions-api/como-funciona/introducao)
* `tagId` de otro espacio de trabajo en el segmento → error de validación

## Próximos pasos

* [Segmentos en la audiencia](/es/contacts-api/como-funciona/segmentos-na-audiencia): armar públicos con regla `tag`
* [Temas de comunicación](/es/contacts-api/como-funciona/topicos-de-comunicacao): consentimiento por tema
* [Campañas en el panel](/es/contacts-api/como-funciona/campanhas-no-painel): envío en lote
* [Introducción](/es/contacts-api/como-funciona/introducao): mapa de conceptos