Segmentación

Segmentación era el módulo que guardaba filtros con nombre sobre los leads. Ya no es un módulo: la clave se retiró del catálogo y los segmentos son hoy una función del CRM. Esta página dice qué sigue en pie y qué cambió, para que nadie busque un interruptor que no existe.

Qué hace

No hay módulo segmentacion que encender. El seeder lo pasa por la retirada, que lo desengancha de los sitios y de los planes y borra su fila del catálogo. Tampoco aparece en el modelo de precios ni en ningún plan.

Lo que sí existe es la función, dentro del módulo CRM: vistas guardadas de leads con nombre.

• GET /api/sites/{site}/segments las lista con el total de leads y reachable, que cuenta los leads con permiso de marketing por correo y por WhatsApp.
• GET /api/leads?segment_id= aplica el filtro y se apila con etapa, tipo, responsable y búsqueda.
• Un segmento es su criteria: una lista de condiciones que se combinan siempre con AND. No hay OR ni agrupación; quien necesite «esto o aquello» hace dos segmentos. Una lista vacía significa todos los leads del sitio.
• Las claves de cada condición (campo, op, valor) no se traducen: están persistidas en cada segmento que un cliente ya creó.
• Como audiencia de una automatización: conditions.segment_id.
• lead.entered_segment y la tabla de entradas recuerdan quién está dentro, con el comando crm:sync-segments.

De qué depende

• Del módulo CRM, que es núcleo. No hay compuerta aparte: sin CRM no hay lista donde guardar.
• Del permiso de trabajo crm y del perfil del miembro, el mismo que gobierna los leads.
• De la etapa del pipeline para los criterios que filtran por etapa, que se leen por contrato y no importando el módulo.

Qué pasa cuando se apaga

El módulo ya no se puede encender ni apagar porque no está en el catálogo. Los segmentos guardados viven en la tabla segments y no se borran por esto.

Si el listado se sirve sin permiso de trabajo, la respuesta degrada a 200 con lista vacía en vez de 403, para que el panel pueda pintar la pantalla. Al crear o consultar un segmento concreto sí se exige el módulo y el permiso.

Al borrar un segmento se avisa del borrado y se apagan las automatizaciones que lo usaban como audiencia. Es la única forma de que una regla deje de correr por esto.

Límites y trampas

• No busques app-modules/Segmentation: no existe. Si un documento dice que vive ahí, está desactualizado.
• El catálogo de tipos del validador no incluye los leads de pedido ni de plan: un segmento no puede aislarlos hoy, y guardarlo da 422.
• La previsualización valida menos que el guardado. Un valor mal tipado no da 422 al previsualizar: se convierte en cero y el conteo sale sobre otra condición.
• Un criterio con un campo u operador que ya no exista en el catálogo se ignora en silencio: el segmento se reevalúa sin esa condición y el número cambia sin aviso.
• Un identificador de etapa de otro sitio se guarda sin error. No es una fuga, porque la consulta arranca filtrada por sitio, pero tampoco está validado.
• El total del segmento y reachable miden cosas distintas: reachable solo cuenta los leads con consentimiento de mercadeo para ese canal, así que los dos números no tienen por qué coincidir.

Ver también

• Automatizaciones: el consumidor principal de una vista guardada.
• Email marketing: el envío masivo que todavía no existe.
• Integraciones.