Audiencias: segmentos de clientes para difusiones y campañas

Una Audiencia (Marketing Audience) es un grupo de clientes al que le vas a mandar algo: una difusión de WhatsApp, una campaña. En lugar de armar la lista a mano cada vez, la guardas una vez y la reutilizas. Hay dos maneras de definir a quién incluye:

Manual: tú eliges cliente por cliente. La lista es fija hasta que la edites.
Filtro (Filter): guardas un filtro sobre el catálogo de Clientes, y el sistema lo resuelve al momento de enviar. Así, la audiencia se actualiza sola: si mañana hay un cliente nuevo que cumple el filtro, entrará sin que tú lo agregues.

Nota. Una audiencia siempre resuelve a Clientes (Customer). En modo Filtro, el sistema siempre agrega automáticamente disabled = 0, así que nunca te va a incluir clientes deshabilitados aunque tu filtro no lo diga.

Crear una audiencia

Entra a Audiencias y toca Nueva. [captura: lista de Audiencias con el botón Nueva]
Llena lo básico:
- Título (obligatorio): un nombre que reconozcas, ej. "Clientes con reparación en junio".
- Descripción (opcional): para qué es.
- Compartida con todos los Sales Users (is_shared): déjala apagada si es tuya; préndela si quieres que todo el equipo de ventas la use.
Elige el Modo de resolución (resolve_mode): Manual o Filtro.
Guarda.

Modo Manual

Con el modo en Manual, aparece la tabla Clientes (Members).
Usa el buscador para agregar clientes uno por uno. El buscador te muestra nombre + teléfono + correo para que no te confundas entre homónimos.
Agrega los que necesites y guarda.

Nota. Al resolver una audiencia Manual, el sistema descarta duplicados y omite clientes deshabilitados, aunque estén en la lista. Lo que ves reflejado (el conteo real) puede ser menor a la cantidad de renglones que capturaste.

Modo Filtro

Con el modo en Filtro, aparece el campo Filter Spec (JSON).
Escribe un filtro estándar de Frappe sobre el doctype Customer. Ejemplos:
- Todos los de un grupo: {"customer_group": "Individual"}
- Por territorio: {"territory": "Hidalgo"}
Guarda. El filtro se resuelve cada vez que envías, sobre el catálogo vivo de Clientes.

Importante. No necesitas incluir disabled en tu filtro: el sistema fuerza disabled = 0 por su cuenta.

Advertencia — filtro inválido. Si el JSON está mal escrito o el filtro apunta a un campo que no existe, la audiencia resuelve a lista vacía (no truena tu envío, pero no incluye a nadie). Registra el error internamente para diagnóstico. Si una audiencia de Filtro te devuelve cero clientes cuando esperabas gente, revisa tu filter_spec: es la causa más común.

Ver a quién incluye una audiencia (resolver)

Antes de mandar algo, conviene ver el tamaño real.

Abre la audiencia.
Usa Resolver / Ver miembros. El sistema te devuelve la lista plana de clientes (nombre, teléfono, correo) que la audiencia targetea en este momento.
Compara ese número con lo que esperabas. Una audiencia de Filtro puede crecer o encoger entre un envío y otro — ese es justamente su propósito.

Nota. El campo Estimated Size (estimated_count) es una referencia guardada; la verdad al momento de enviar la da el resolver en vivo, sobre todo en modo Filtro.

Quién puede ver y editar audiencias

Puedes ver una audiencia si eres su dueño, si está compartida (is_shared), o si eres gerente.
Puedes editar/borrar una audiencia si eres su dueño o gerente. No puedes modificar la audiencia de otro usuario (te lo impide con un mensaje de permiso).
El buscador de clientes del selector (typeahead) está restringido a gerentes, para que un Sales User común no pueda enumerar por escritura toda la base de clientes y su PII (teléfonos, correos).

Importante — reutilización. Una misma audiencia sirve tanto para difusiones como para campañas. Si cambias sus miembros o su filtro, el cambio aplica a todos los envíos futuros que la usen. Si necesitas una variante puntual, duplica la audiencia en vez de editar la original.

[VERIFICAR: nombres exactos de los botones "Nueva", "Resolver / Ver miembros" y la etiqueta del campo is_shared tal como aparecen en español en la SPA.]