Saltar al contenido
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

Segmentos

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.

Un segmento es un grupo guardado de contactos al que puedes hacer un envío masivo. 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. 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.
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 se pueden ligar de la misma manera. Juntos mantienen separados la audiencia, los temas y las bajas de cada marca; consulta Bajas.

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.

¿Te ha resultado útil esta página?