---
title: Segmentos
description: Grupos de contactos por filtro o manuales que sirven de audiencia para los envíos masivos, cada uno ligado opcionalmente a un dominio de envío.
seo:
  title: Segmentos de email
ai:
  exclude: true
---

Un segmento es un grupo guardado de contactos al que puedes hacer un [envío masivo](/docs/es/concepts/broadcasts). Crea segmentos en el panel, en **Contactos → Segmentos**, o con la API.

Hay dos tipos:

- **Segmento por filtro.** Guarda un filtro, no una lista de personas. Un contacto que empieza a cumplir el filtro entra en el segmento al instante, y el número de contactos se calcula cuando lo lees.
- **Segmento manual.** Se crea sin filtro. Añades y quitas contactos tú mismo, en el panel o con `POST /contacts/{id}/segments/{segmentId}` y `DELETE /contacts/{id}/segments/{segmentId}`.

Un filtro puede evaluar el email, el nombre, el estado de suscripción y la fecha de creación de un contacto, y cualquier [propiedad personalizada](/docs/es/concepts/contacts). Los operadores incluyen igual a, contiene, está definido, no está definido y comparaciones de fechas, y las condiciones se combinan con y/o.

## Usar un segmento

- **Envíos masivos.** Elige un segmento como audiencia. Quién recibe el email se calcula cuando se envía, con el mismo filtro que el recuento que viste antes. Los contactos dados de baja en todo el equipo, o que se dieron de baja del dominio de envío del envío masivo, siempre quedan fuera.
- **Vista de contactos.** Filtra la lista por segmento. La exportación a CSV sigue el mismo filtro.

```sh
curl -X POST "https://api.billionsend.com/segments" \
  -H "Authorization: Bearer bs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Trial users",
    "filter": { "match": "all", "conditions": [{ "field": "property:plan", "op": "equals", "value": "trial" }] }
  }'
```

`GET /segments/{id}` incluye el `contact_count` en vivo, y `GET /segments/{id}/contacts` lista los miembros. Un filtro no válido devuelve `422` y nunca se guarda.

## Un segmento por marca

Si cada uno de tus dominios es una marca distinta, liga un segmento al dominio al que pertenece definiendo `domain_id`, al crearlo o después con `PATCH /segments/{id}`, o eligiendo el dominio en el panel.

- Un envío masivo a un segmento ligado debe enviarse desde ese dominio. Desde cualquier otro dominio, las llamadas del envío masivo devuelven `422`.
- Un segmento sin dominio funciona con todos los dominios. `"domain_id": null` vuelve a hacer de un segmento ligado un segmento de todo el equipo.
- Un dominio no se puede eliminar mientras haya segmentos ligados a él (`409`).

Los [temas](/docs/es/concepts/topics) se pueden ligar de la misma manera. Juntos mantienen separados la audiencia, los temas y las bajas de cada marca; consulta [Bajas](/docs/es/concepts/unsubscribes).

## Claves de API limitadas a un dominio

Una clave de API limitada a un dominio solo puede crear segmentos ligados a ese dominio, y no puede crear uno de todo el equipo.
