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

# Inicio rápido — Segmentos

> Define reglas, guarda el segmento y úsalo en campañas o exportación.

<Tip>
  Un **segmento** = conjunto dinámico de contactos que **se actualiza solo** cuando cambian etiquetas, temas o datos.
</Tip>

## En resumen

* **Arma** reglas (`match: all` o `any`).
* **Guarda** con `POST /v1/segments`.
* **Usa** en campaña o `GET /v1/segments/{id}/contacts`.

Contexto: [Segmentos en la audiencia](/es/contacts-api/como-funciona/segmentos-na-audiencia). Alcances: [Alcances de segmentos](/es/contacts-api/como-funciona/segmentos-escopos-da-api-key).

## Antes de empezar

| Ítem                  | Obligatorio                     |
| --------------------- | ------------------------------- |
| **`segments:create`** | Para crear                      |
| **`segments:read`**   | Para listar y exportar miembros |

Auth: `Authorization: Bearer sk_live_...`. URL base: `https://api.notifique.dev`.

***

## 1. Por el panel

1. **Audiencia → Segmentos → Nuevo**
2. Nombre (`Clientes VIP`)
3. Añade reglas (etiqueta, tema, marketing, canal, etc.)
4. Guarda — el contador de miembros se actualiza automáticamente

***

## 2. Segmento simple (API)

Contactos con etiqueta VIP que aceptan marketing:

```http theme={null}
POST /v1/segments
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx
```

```json theme={null}
{
  "name": "VIP marketing",
  "definition": {
    "version": 1,
    "match": "all",
    "rules": [
      { "type": "tag", "tagId": "clxxTagVip" },
      { "type": "receiveMarketing", "value": true }
    ]
  }
}
```

***

## 3. Listar segmentos

```http theme={null}
GET /v1/segments?page=1&limit=50
Authorization: Bearer sk_live_xxxxx
```

***

## 4. Vista previa de los miembros

```http theme={null}
GET /v1/segments/{segmentId}/preview?page=1&limit=100
Authorization: Bearer sk_live_xxxxx
```

Devuelve una muestra paginada de los contactos que entran en el segmento (máx. 500 por página).

***

## 5. Usar en campaña

En el panel, elige el segmento como audiencia. En la API de campaña, usa el `segmentId` devuelto al crear la campaña.

***

## Tipos de regla (`type`)

| `type`             | Uso                              |
| ------------------ | -------------------------------- |
| `tag`              | El contacto tiene la etiqueta    |
| `topic`            | Suscrito (o no) al tema          |
| `receiveMarketing` | Acepta marketing                 |
| `channel`          | Tiene canal (email, whatsapp, …) |
| `field`            | Campo personalizado              |

Detalles y ejemplos: [Segmentos en la audiencia](/es/contacts-api/como-funciona/segmentos-na-audiencia).

***

## Próximos pasos

* [Campañas — Inicio rápido](/es/contacts-api/como-funciona/campanhas-quick-start)
* [Etiquetas — Inicio rápido](/es/contacts-api/como-funciona/tags-quick-start)
* [Introducción](/es/contacts-api/como-funciona/introducao)