Inicio rápido — Segmentos

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

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. Alcances: Alcances de segmentos.

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

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

2. Segmento simple (API)

Contactos con etiqueta VIP que aceptan marketing:

POST /v1/segments
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

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

3. Listar segmentos

GET /v1/segments?page=1&limit=50
Authorization: Bearer sk_live_xxxxx

4. Vista previa de los miembros

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.

API E-mail

E-mail

Domínios

E-mails recebidos

Inicio rápido — Segmentos

En resumen

Antes de empezar

1. Por el panel

2. Segmento simple (API)

3. Listar segmentos

4. Vista previa de los miembros

5. Usar en campaña

Tipos de regla (`type`)

Próximos pasos

​En resumen

​Antes de empezar

​1. Por el panel

​2. Segmento simple (API)

​3. Listar segmentos

​4. Vista previa de los miembros

​5. Usar en campaña

​Tipos de regla (type)

​Próximos pasos

En resumen

Antes de empezar

1. Por el panel

2. Segmento simple (API)

3. Listar segmentos

4. Vista previa de los miembros

5. Usar en campaña

Tipos de regla (`type`)

Próximos pasos