# Segmentos

> Los segmentos son filtros guardados sobre tus contactos. Créalos a partir de todos los contactos o de las listas que elijas, envíales campañas o exclúyelos, y consulta el límite de segmentos de tu plan. Alfa: solo para el equipo de Emailit.

Un segmento es un filtro guardado sobre los contactos de tu espacio de trabajo, como «Clientes del plan Pro» o «Altas de los últimos 30 días». No añades personas a un segmento: todos los que cumplen sus reglas están en él, y nadie más. Usa los segmentos para enviar una [campaña](/es/docs/campaigns/) a una parte de tus contactos o para dejar a algunas personas fuera de ella.

> **Los segmentos están en alfa:** Los segmentos solo están abiertos al equipo de Emailit mientras los probamos. Consulta [Quién puede usar los segmentos](#who-can-use-segments).

## Quién puede usar los segmentos

Durante la fase alfa, los segmentos solo están disponibles para los administradores de la plataforma de Emailit. El rol Admin de un espacio de trabajo no basta.

| Dónde | Equipo de Emailit | Todos los demás |
| --- | --- | --- |
| Panel | **Email Marketing → Segments**, los selectores de segmentos de las campañas, los disparadores de segmento de las automatizaciones y los eventos de segmentos de los webhooks | En el menú, **Segments** muestra **Soon** y no se puede abrir. Los selectores están ocultos, pero una campaña o una automatización que ya usa un segmento lo sigue mostrando. |
| API y MCP | La API de segmentos, los segmentos como destinatarios y los disparadores de segmento, y las herramientas MCP de segmentos | `403` con `error: "segments_alpha"` |
| Claves de API | Ninguna. Las claves de API pertenecen a un espacio de trabajo, no a una persona. | `403` con `error: "segments_alpha"` |

Las campañas y automatizaciones que ya usan un segmento siguen funcionando para todos los miembros del espacio de trabajo, y los segmentos con seguimiento se siguen actualizando.

## Cómo funcionan los segmentos

Un segmento tiene dos partes:

- **Origen.** Todos los contactos del espacio de trabajo, o solo los suscriptores de las listas de contactos que elijas.
- **Filtros.** Grupos de reglas sobre los campos del contacto, los [campos personalizados](/es/docs/contacts/custom-fields/), la pertenencia a listas y las [etiquetas y la puntuación de lead](/es/docs/contacts/tags-and-score/), por ejemplo **Email domain** es `acme.com`, **plan** es cualquiera de `pro`, `enterprise`, o **Tags** tiene alguna de `vip`. Un grupo coincide cuando se cumplen todas sus reglas o cualquiera de ellas, y el segmento, cuando se cumplen todos sus grupos o cualquiera de ellos. Sin filtros, todos los contactos del origen están en el segmento.

Emailit evalúa un segmento cada vez que se cuenta, se lista o se usa para un envío, así que siempre está al día. Una campaña programada para la semana que viene llega a quienes coincidan con el segmento en el momento del envío, y las reglas como «creado en los últimos 30 días» avanzan con la fecha.

### A quién pueden llegar las campañas

Cada segmento muestra dos recuentos: **Contacts**, todos los que coinciden, y **Subscribed**, la parte a la que pueden enviar las campañas. Un contacto está suscrito cuando no se ha dado de baja de forma global y está suscrito al menos a una lista de contactos, sea cual sea. Los contactos que nunca se han unido a una lista coinciden con los segmentos, pero no reciben campañas. Las direcciones bloqueadas se siguen contando y se omiten cuando se envía la campaña.

El campo **Subscription status** usa la misma regla, así que **Subscription status** es `subscribed` limita un segmento a los contactos a los que pueden llegar las campañas.

## Crear un segmento

1. Ve a **Email Marketing → Segments** y selecciona **Create segment**.
2. En **Details**, introduce un **Name** y, si quieres, una **Description** para tu equipo.
3. En **Type**, elige **Segment** o **Tracked segment**. No puedes cambiar el tipo más adelante. Consulta [Segmentos simples y con seguimiento](#plain-and-tracked-segments).
4. En **Contacts from**, elige **All contacts** o **Subscribers of specific audiences** y selecciona las **Audiences**.
5. En **Filters**, selecciona **Add condition** y elige un campo, un operador y un valor. Usa **Add group** para añadir otro grupo de condiciones, y cambia entre **all** y **any** para decidir cómo se combinan las condiciones y los grupos.
6. Revisa la sección **Preview**: el número de **Matching contacts**, cuántos están suscritos y las **First matches**. Se actualiza mientras editas.
7. Selecciona **Save segment**.

También puedes empezar un segmento desde otras páginas:

- **Save as segment**, en la lista de la página Contacts, convierte los filtros actuales de la lista en un segmento. Los filtros que los segmentos no admiten se omiten, y el editor los indica.
- **Create segment**, en el menú de la página de una lista de contactos, empieza un segmento con esa lista como origen.
- **Duplicate**, en el menú de la fila de un segmento, lo copia como un segmento nuevo.

Para ver la lista completa de campos, operadores y valores, consulta [Crear un segmento](/es/docs/api-reference/segments/create/#conditions) en la referencia de la API.

## La página del segmento

Selecciona un segmento en **Email Marketing → Segments** para abrirlo. La página muestra las cifras **Contacts**, **Subscribed** y **Updated**, la **Definition** del segmento y los contactos que coinciden en este momento, con búsqueda y filtros. Los contactos se listan en directo, así que la lista cambia a medida que cambian los contactos.

Desde la cabecera puedes editar el segmento con **Edit**, empezar una campaña que se envíe a él con **Create campaign** o eliminarlo con **Delete**, en el menú.

## Enviar una campaña a un segmento

En el paso **Recipients** de la campaña, elige uno o varios **Segments**, solos o junto con **Audiences**. Para dejar fuera a algunas personas, usa **Exclude audiences** y **Exclude segments**. Consulta [Crear una campaña](/es/docs/campaigns/create/#step-1-recipients).

- **Se evalúan en el momento del envío.** Emailit calcula los destinatarios cuando empieza el envío, así que incluye a los contactos que coinciden en ese momento y deja fuera a los que han dejado de coincidir.
- **Una copia por dirección.** Un contacto que está en varias de las listas y segmentos seleccionados recibe la campaña una sola vez.
- **Las exclusiones prevalecen.** Se omite a un contacto que está en una lista o un segmento excluidos, aunque también esté en uno seleccionado.
- **Las exclusiones eliminadas detienen el envío.** Si una campaña excluye una lista o un segmento que ya no existe, Emailit no la envía: el envío devuelve un error y una campaña programada vuelve a **Draft**. Actualiza sus destinatarios y vuelve a enviarla.

No puedes eliminar un segmento mientras lo use una campaña programada o en curso de envío. Al eliminar un segmento, se quita de los borradores de campaña que se envían a él. Los borradores que lo excluyen conservan la exclusión y no se pueden enviar hasta que la sustituyas, para que las personas que querías dejar fuera nunca los reciban.

## Segmentos simples y con seguimiento

Al crear un segmento, eliges su tipo:

| | **Segment** | **Tracked segment** |
| --- | --- | --- |
| Recuentos, lista de contactos y campañas | En directo | En directo |
| Registra quién entra y quién sale, y cuándo | No | Sí |
| Inicia automatizaciones con las entradas y salidas | No | Sí |
| Envía los webhooks `segment.contact_added` y `segment.contact_removed` | No | Sí |
| Gráfico **Growth** y columna **Joined** | No | Sí |
| Planes | Todos | Pro, Business y Custom |

El tipo queda fijado una vez creado el segmento. Para cambiarlo, crea un segmento nuevo con las mismas reglas. Consulta [Segmentos con seguimiento](/es/docs/segments/tracked/).

Las automatizaciones también pueden comprobar cualquier segmento, con seguimiento o sin él, en un paso **Condition** (If/Else), un objetivo, un paso **Wait until** o una condición de salida: «**Segment** is in **VIP customers**». Consulta [Condition (If/Else)](/es/docs/automations/steps/#condition-ifelse). Un segmento que se usa en una automatización no se puede eliminar hasta que cambies la automatización.

## Límites

Cada plan incluye un número de segmentos por espacio de trabajo. Los segmentos con seguimiento y los simples cuentan para el mismo límite.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Segmentos | 3 | 10 | 100 | Flexible |
| Segmentos con seguimiento | — | Incluidos | Incluidos | Incluidos |

La lista de la página Segments muestra cuántos has usado, por ejemplo `3/10 used`. Cuando alcanzas el límite, **Create segment** y **Duplicate** se desactivan hasta que eliminas un segmento o [cambias a un plan superior](/es/docs/billing/plans/). La API devuelve `422` con el `usage` actual:

```json
{
  "error": "Pay as you go includes 3 segments.",
  "message": "Pay as you go includes 3 segments.",
  "usage": { "used": 3, "limit": 3 }
}
```

Si bajas de plan, tus segmentos siguen funcionando, pero no puedes añadir más hasta que estés por debajo del nuevo límite. En Pay as you go, los segmentos con seguimiento se pausan. Consulta [Cuando el seguimiento se pausa](/es/docs/segments/tracked/#when-tracking-pauses).

Un segmento puede tener hasta 10 grupos y 50 reglas, y tomar sus contactos de hasta 100 listas.

## Usar la API y MCP

La [API de segmentos](/es/docs/api-reference/segments/) te permite [crear](/es/docs/api-reference/segments/create/), [obtener](/es/docs/api-reference/segments/get/), [actualizar](/es/docs/api-reference/segments/update/), [listar](/es/docs/api-reference/segments/list/) y [eliminar](/es/docs/api-reference/segments/delete/) segmentos, [listar sus contactos](/es/docs/api-reference/segments/contacts/), [previsualizar](/es/docs/api-reference/segments/preview/) una definición antes de guardarla y [listar los campos](/es/docs/api-reference/segments/fields/) que pueden usar las reglas. La API necesita una clave de API con **Full Access**.

```bash
curl https://api.emailit.com/v2/segments \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme team",
    "conditions": { "rules": [{ "field": "email_domain", "operator": "equals", "value": "acme.com" }] }
  }'
```

Para enviar una campaña a un segmento, añade `{ "segment_id": "seg_…" }` a sus `recipients` con [Actualizar una campaña](/es/docs/api-reference/campaigns/update/), o `{ "segment_id": "seg_…", "exclude": true }` para excluirlo.

En el [servidor MCP](/es/docs/mcp/), el conjunto de herramientas `segments` ofrece las mismas operaciones, así que un asistente de IA puede crear y comprobar segmentos por ti. Consulta [Conjuntos de herramientas](/es/docs/mcp/toolsets/).

## Próximos pasos

  - [Segmentos con seguimiento](/es/docs/segments/tracked/): Registra las entradas y salidas e inicia automatizaciones.
  - [Crear una campaña](/es/docs/campaigns/create/): Envía a segmentos y excluye otros.
  - [Campos personalizados](/es/docs/contacts/custom-fields/): Guarda los datos por los que filtran tus reglas.
  - [API de segmentos](/es/docs/api-reference/segments/): Todos los endpoints de segmentos.

---
Fuente: https://emailit.com/es/docs/segments/