Skip to main content
Un segmento es una lista de contactos dentro de un proyecto: es lo que eliges como audiencia al enviar una campaña. Hay dos tipos, y la diferencia importa mucho cuando quien alimenta el segmento es un sistema externo (tu CRM, tu backend, tu plataforma). La trampa del estático es conocida: el alta siempre se implementa, la baja casi nunca. Si tu sistema deja de mandar el DELETE cuando alguien se da de baja, el segmento se va llenando de gente que ya no corresponde — y nadie lo nota hasta que sale un envío mal dirigido. Con un segmento dinámico ese problema no existe.

​
Sincronizar tu base con eventos

Es la vía recomendada cuando la fuente de verdad vive en tu plataforma. La idea: tú informas hechos (eventos), RQE deduce la audiencia (el segmento).

​
1. Manda el evento desde tu sistema

Cada vez que ocurra el hecho que define la audiencia — un cobro exitoso, una renovación, un login — informa el evento:
No necesitas crear el contacto antes: si el email no existe, se crea solo. Para cargas masivas usa POST /v1/events/bulk (hasta 1,000 por llamada).

​
2. Crea el segmento dinámico

En la app: Audiencia → Segmentos, abre el segmento y elige Convertir a segmento dinámico. Luego:
  • Tipo de regla: Comportamiento (evento)
  • Acción: Disparó el evento
  • Evento: pago_recibido
  • En los últimos: 35 días
Eso es, literalmente, “clientes que están pagando ahora”.

​
3. Envía

Elige ese segmento como audiencia de tu campaña. No hay paso de sincronización manual ni botón de refrescar.
La ventana móvil es la que hace el trabajo sucio. Quien deja de pagar deja de generar el evento, sale de la ventana y cae del segmento solo. Elige la ventana un poco más ancha que tu ciclo de facturación (35 días para un cobro mensual) para que un cobro que se atrasa unos días no expulse al cliente por accidente.

​
Reglas disponibles

Cada segmento dinámico se define con una regla: La regla Comportamiento (evento) admite el operador negativo (No disparó el evento), útil para reactivación: “no disparó pago_recibido en los últimos 60 días”.
Un segmento admite una sola regla. Para combinar criterios (“clientes activos que además hicieron clic”), crea el segmento con la regla más restrictiva. Si necesitas el cruce exacto, resuélvelo de tu lado: calcula la audiencia en tu sistema y sincronízala como segmento estático.

​
Cuándo se actualiza la membresía

Es decir: para enviar, no esperas nada. La cadencia horaria solo importa si además cuelgas una automatización del ingreso al segmento.

​
Segmentos estáticos vía API

Si prefieres controlar la membresía tú mismo, los endpoints están en Leads: El :id es el UUID del contacto, no su email. Dónde encontrar el ID de un segmento: ábrelo en la app y cópialo de la URL, o usa GET /v1/leads/:id, que devuelve los segment_ids del contacto.

​
Con un cliente MCP

Si conectas RQE a Claude o Cursor mediante el servidor MCP, puedes hacer todo lo anterior conversando, sin escribir código:
  • track_event — registra el evento (también auto-crea el contacto)
  • create_segment — crea el segmento; acepta la regla para dejarlo dinámico de una
  • list_segments — lista los que ya existen, con sus IDs
  • upsert_contacts — hasta 1,000 contactos por llamada, con sus segment_ids

​
Preguntas frecuentes

¿Puedo segmentar por tags o por atributos del contacto? Todavía no como regla de segmento. Los tags (POST /v1/leads/:email/tags) y los atributos sí se evalúan dentro de las automatizaciones, y sirven para ramificar un flujo. Para armar audiencias, usa eventos. ¿Los contactos creados por un evento reciben correos? Sí, son contactos normales del proyecto. Ten en cuenta que crear un contacto puede inscribirlo en automatizaciones activas con disparadores de contacto nuevo. ¿Qué pasa si mando el mismo evento muchas veces? Nada malo: los eventos se acumulan como historial. La regla mira la ocurrencia más reciente dentro de la ventana, así que reenviar el evento en cada cobro es exactamente el uso previsto.