> ## 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.

# Segmentos de audiencia

> Filtros guardados con etiquetas, campos de plataforma, propiedades, temas y marketing.

<Tip>
  Un **segmento** es una **pregunta guardada** ("¿quién está dentro?"). Una **etiqueta** se pega al archivo; un **segmento** combina reglas con AND/OR. Siempre haga **Vista previa** antes de campañas grandes.
</Tip>

## ¿Qué es un segmento?

Una **audiencia dinámica** definida por reglas JSON (`version: 1`). Cuando ejecuta una campaña, el sistema **vuelve a aplicar** las mismas reglas.

Analogía: una **etiqueta** es una etiqueta en la carpeta. Un **segmento** es la búsqueda guardada.

## Segmento × etiqueta × tema × campaña

|              | **Segmento**     | **Etiqueta**               | **Tema**                   | **Campaña**          |
| ------------ | ---------------- | -------------------------- | -------------------------- | -------------------- |
| Rol          | Define **quién** | Marca el contacto          | Consentimiento por tema    | **Envía** el mensaje |
| Persistencia | Reglas guardadas | En el archivo del contacto | Suscripción por tema       | Ejecución (Run)      |
| API          | `segments:*`     | `tags:*` / `tagIds`        | `topics:*` / regla `topic` | `campaigns:*`        |

## Formato (versión 1)

| Campo   | Valores              | Significado                                                  |
| ------- | -------------------- | ------------------------------------------------------------ |
| `match` | `"all"` o `"any"`    | **all** = AND. **any** = OR                                  |
| `rules` | array (hasta **32**) | Lista vacía = **todos** los contactos, ¡cuidado en campañas! |

## Tipos de regla (5)

| `type`             | Filtra                                              |
| ------------------ | --------------------------------------------------- |
| `tag`              | Contacto tiene etiqueta                             |
| `property`         | Campo **personalizado**                             |
| `contactField`     | Campo de **plataforma** (nombre, teléfono, correo…) |
| `topic`            | Suscrito a un **tema**                              |
| `receiveMarketing` | Opt-in general de marketing                         |

### Ejemplos rápidos

**Etiqueta + marketing:**

Operadores completos por tipo de campo: **Referencia API** (grupo Segmentos).

<Note>
  No hay regla `type: "channel"`. Para teléfono use `hasPhone` o `phone`. Para Telegram use `hasTelegram` o `telegramPeer`.
</Note>

## Vista previa y campañas

**Vista previa** (`segments:read`), muestra paginada (máximo **500** por página).

En **campañas**, seleccione el segmento como audiencia. Al **Ejecutar**, las reglas se ejecutan nuevamente.

## Próximos pasos

* [Campañas del panel](/es/contacts-api/como-funciona/campanhas-no-painel)
* [Temas de comunicación](/es/contacts-api/como-funciona/topicos-de-comunicacao)
* [Introducción](/es/contacts-api/como-funciona/introducao)