Segmentos

Los segmentos permiten agrupar entidades dinámicamente mediante reglas de filtrado.

Entidades soportadas

Entidad	Identificador
Contactos	contacts
Cuentas	accounts
Deals	deals
Leads	leads
Tickets	tickets

---

Listar segmentos

GET /admin/intelligence/segments

Parámetros:

Nombre	Tipo	Descripción
entity	string	Filtrar por entidad

---

Crear segmento

POST /admin/intelligence/segments

Campo	Requerido	Tipo	Descripción
name	sí	string	Nombre del segmento
description	no	string	Descripción
entity	sí	string	Entidad objetivo
refresh	sí	string	on_demand, scheduled, realtime
query_dsl	sí	JSON	Query DSL de filtrado

Query DSL

El DSL define condiciones de filtrado:

{
  "conditions": [
    {
      "field": "source",
      "op": "equals",
      "value": "ecommerce"
    },
    {
      "field": "created_at",
      "op": "after",
      "value": "2026-01-01"
    }
  ],
  "logic": "AND"
}

---

Detalle de segmento

GET /admin/intelligence/segments/:id

Muestra el segmento y sus miembros actuales.

---

Actualizar segmento

POST /admin/intelligence/segments/:id

---

Recalcular miembros

POST /admin/intelligence/segments/:id/refresh

Recomputa la membresía del segmento según las reglas actuales.

---

Eliminar segmento

DELETE /admin/intelligence/segments/:id