Enviar emails, noticias y notificaciones

Permisos de acceso

La seccion Comunicacion aparece segun permisos del usuario del panel. En codigo se distinguen permisos para:

• Gestionar emails. • Gestionar noticias. • Gestionar notificaciones.

Esto permite que un empleado pueda tener acceso, por ejemplo, a enviar emails pero no a publicar noticias, o a crear noticias pero no a mandar notificaciones masivas.

Como es una seccion sensible, conviene dar estos permisos solo a personas que entiendan el impacto de enviar mensajes a clientes reales.

Email

La pantalla Email permite crear y gestionar correos del centro.

La pantalla se organiza en tres pestanas:

• Enviados. • Programados. • Borradores.

Enviados:

Muestra correos ya enviados. Cada correo muestra asunto, resumen del mensaje, destinatarios y fecha/hora relativa de envio. Desde aqui se puede editar y reenviar un correo anterior.

Programados:

Muestra correos que todavia no se han enviado porque tienen una fecha de programacion futura. Desde aqui se pueden editar o reprogramar.

Borradores:

Muestra correos guardados sin enviar. Desde aqui se pueden abrir, terminar y enviar, programar o volver a guardar.

Crear un nuevo correo

Para crear un correo:

1. Entrar en Comunicacion > Email. 2. Pulsar Nuevo correo. 3. Anadir destinatarios. 4. Escribir asunto. 5. Escribir el mensaje. 6. Elegir entre Enviar ahora, Programar envio o Guardar como borrador.

El correo requiere, como minimo:

• Destinatarios. • Asunto. • Mensaje.

Si falta alguno de esos campos, el sistema no deberia permitir completar el envio.

Destinatarios de email

El campo destinatarios permite seleccionar varios tipos de publico.

Segun el codigo de destinatarios permitidos, se pueden guardar:

• Clientes concretos. • Grupos. • Listas inteligentes. • Todos los clientes.

En la pantalla de email, el selector permite usar listas inteligentes. Esto es muy importante porque evita tener que seleccionar cliente por cliente cuando el mensaje va dirigido a un segmento.

Ejemplos de destinatarios:

• Todos los clientes. • Clientes concretos: Ana, Carlos y Laura. • Una lista inteligente: clientes activos con bono vigente. • Una lista inteligente: clientes que no han venido en 30 dias. • Un grupo o conjunto de clientes segun configuracion del centro.

Cuando se usa una lista inteligente, el sistema resuelve los clientes de esa lista en el momento del envio o de procesamiento. Por eso, si la lista cambia con el tiempo, conviene revisar a quien incluye antes de enviar mensajes importantes.

Variables dinamicas en emails

Una parte muy potente de Email son las variables dinamicas. Permiten escribir un solo mensaje y que el sistema lo adapte a cada cliente.

Por ejemplo, en vez de escribir:

`Hola Maria`

se puede escribir:

`Hola {first_name}`

Cuando el correo se envia a Maria, el sistema reemplaza `{first_name}` por Maria. Cuando se envia a Carlos, lo reemplaza por Carlos.

En la pantalla hay un desplegable/listado de campos disponibles. Al pulsar una variable, se copia para pegarla en el asunto o mensaje.

Campos fijos disponibles:

• `{name}`: nombre completo. • `{first_name}`: nombre. • `{last_name}`: apellidos. • `{alias}`: alias. • `{email}`: email. • `{unique_number}`: numero de cliente. • `{gender}`: genero. • `{date_of_birth}`: fecha de nacimiento. • `{phone}`: telefono. • `{dni}`: DNI. • `{address}`: direccion. • `{city}`: ciudad. • `{country}`: pais. • `{insurance}`: seguro. • `{insurance_policy}`: poliza. • `{insurance_number}`: numero de seguro. • `{company}`: empresa. • `{title}`: titulo. • `{website_url}`: web. • `{linkedin_url}`: LinkedIn. • `{twitter_url}`: Twitter. • `{instagram_url}`: Instagram. • `{created_at}`: fecha de creacion. • `{updated_at}`: fecha de ultima actualizacion.

Ademas, el sistema incluye campos personalizados del centro. Estos aparecen con formato:

`{custom_clave_del_campo}`

Tambien puede aceptar la clave directa si no entra en conflicto con un campo fijo.

Ejemplo:

Si el centro tiene un campo personalizado llamado Objetivo, podria existir una variable como:

`{custom_objetivo}`

Esto permite enviar mensajes muy personalizados, por ejemplo:

`Hola {first_name}, hemos revisado tu objetivo principal: {custom_objetivo}. Esta semana te recomendamos reservar una sesion de movilidad.`

Cómo se reemplazan las variables

El sistema reemplaza variables en el momento de envio para cada destinatario. Esto significa que cada cliente recibe su version del mensaje.

Si un campo esta vacio en la ficha del cliente, la variable puede quedar como texto vacio. Por eso, antes de usar campos como DNI, telefono, fecha de nacimiento o campos personalizados, conviene revisar que esos datos existen y estan bien rellenados.

Tambien conviene escribir frases que sigan teniendo sentido si falta un dato.

Mejor:

`Hola {first_name}, tenemos novedades para ti.`

Mas arriesgado:

`Hola {first_name}, tu numero de poliza {insurance_policy} esta asociado a esta promocion.`

Si muchos clientes no tienen poliza, el mensaje puede quedar raro.

Enviar ahora

Enviar ahora crea el correo y lanza una tarea de envio. El sistema guarda el email y despacha el trabajo `SendCommunicationEmail`.

Ese trabajo:

• Busca el correo. • Obtiene los destinatarios. • Reemplaza variables dinamicas para cada cliente. • Envia un email individual a cada direccion. • Marca el correo como enviado.

El envio no siempre significa que todos los correos hayan llegado al instante. Puede depender de la cola de trabajos, configuracion SMTP, estado del proveedor de email y validez de las direcciones.

Si el centro tiene silenciados emails/notificaciones, el sistema bloquea el envio inmediato y pide desactivar el silencio antes de enviar.

Programar envio

Programar envio permite elegir fecha y hora para enviar el correo mas adelante.

La pantalla abre un selector de fecha/hora. El limite visual permite programar desde el momento actual hasta un maximo aproximado de dos anos.

El correo queda en la pestana Programados hasta que el proceso automatico de programacion lo encuentra. Cuando llega la fecha, el sistema:

• Comprueba si el centro tiene emails/notificaciones silenciados. • Ajusta zona horaria/localizacion del centro. • Comprueba si ya toca enviarlo. • Despacha el trabajo de envio. • Registra el resultado en logs de programacion.

Si el centro esta silenciado en ese momento, no se envia y queda registrado. Por eso, si un correo programado no sale, hay que revisar silencio de comunicaciones, cola de trabajos y logs.

Guardar como borrador

Guardar como borrador permite preparar un correo sin enviarlo.

Es util para:

• Revisar textos antes de enviarlos. • Dejar comunicaciones preparadas para otro miembro del equipo. • Trabajar mensajes largos. • Evitar envios accidentales.

Desde Borradores se puede usar el borrador, modificarlo y luego enviarlo, programarlo o actualizarlo.

Editar y reenviar

Desde Enviados se puede editar y reenviar un correo anterior. Esto no deberia entenderse como "editar lo que ya recibieron los clientes"; lo que hace es reutilizar el contenido como base para un nuevo envio o reenvio.

Es util cuando se envia un mensaje parecido varias veces, pero hay que revisar siempre:

• Destinatarios. • Asunto. • Fecha. • Variables dinamicas. • Enlaces. • Informacion caducada.

Eliminar correos

Se pueden eliminar registros de correos desde la pantalla. Al eliminar, tambien se eliminan los destinatarios guardados asociados a ese email.

Conviene diferenciar:

• Eliminar del panel no recupera correos ya enviados de las bandejas de los clientes. • Si se elimina un correo programado antes de que salga, deja de estar disponible para ese envio. • Si se elimina un borrador, se pierde esa preparacion.

Noticias

La seccion Noticias permite crear publicaciones para la app.

Una noticia puede incluir:

• Imagen. • Titulo. • Fecha de publicacion. • Secuencia/orden. • Descripcion corta. • Tipo de contenido. • URL o contenido HTML.

El listado muestra imagen, titulo, fecha de publicacion, secuencia y acciones.

Crear una noticia

Para crear una noticia:

1. Entrar en Comunicacion > Noticias. 2. Pulsar Nueva noticia. 3. Subir imagen. 4. Escribir titulo. 5. Definir fecha de publicacion si procede. 6. Definir secuencia si se quiere controlar el orden. 7. Escribir descripcion corta. 8. Elegir tipo de contenido: URL o HTML. 9. Completar la URL o el contenido HTML. 10. Guardar.

La imagen es obligatoria al crear una noticia nueva desde la validacion de la vista. Al editar, se puede conservar la imagen existente si no se sube otra.

Formatos admitidos:

• JPEG. • JPG. • PNG. • GIF. • ICO.

El codigo del gestor acepta imagen hasta 6120 KB, aunque el mensaje de error traducido puede mencionar 2000 KB. Conviene confirmar el limite final que se quiere comunicar en la guia de usuario si esto importa operativamente.

Fecha de publicacion y orden

La fecha de publicacion sirve para indicar cuando se publica o se ordena temporalmente la noticia. Si no se indica, el sistema usa la fecha/hora actual.

La secuencia permite controlar el orden de aparicion. El listado se ordena primero por secuencia y despues por fecha de publicacion/creacion. Si no se escribe secuencia, el sistema asigna la siguiente disponible.

Esto es util cuando el centro quiere fijar el orden de varias noticias, por ejemplo:

• 1: Nueva temporada. • 2: Promocion de bienvenida. • 3: Cambio de horarios.

Tipo de contenido de noticia

Hay dos tipos:

URL:

La noticia abre o apunta a una direccion web. Es util si el contenido esta en una pagina externa, landing, blog, formulario, encuesta o enlace informativo.

HTML:

La noticia contiene el texto directamente dentro del sistema. Es util para articulos, comunicados o informacion que se quiere mostrar dentro de la app sin depender de una pagina externa.

Si se elige URL, la URL es obligatoria y debe ser valida.

Si se elige HTML, el contenido HTML es obligatorio.

Editar o eliminar noticias

Una noticia existente se puede editar desde el listado. Al editar se cargan titulo, descripcion, fecha, secuencia, tipo de contenido, URL/HTML e imagen si existe.

Tambien se puede eliminar. Eliminar una noticia la quita del listado y, previsiblemente, de la app si esa app consume ese listado.

Recomendacion: antes de eliminar noticias importantes, valorar si conviene conservar historico en otro lugar. La eliminacion del registro no es lo mismo que despublicar temporalmente.

Notificaciones

La seccion Notificaciones permite crear mensajes que llegan a los clientes dentro de la app. Tambien pueden comportarse como alertas visibles si se activa esa configuracion.

La pantalla se organiza igual que Email:

• Enviadas. • Programadas. • Borradores.

Al crear una notificacion se configuran:

• Destinatarios. • Titulo. • Subtitulo. • Mensaje. • Ajustes avanzados. • Enviar ahora, programar o guardar borrador.

Los campos obligatorios en codigo son:

• Destinatarios. • Titulo/asunto. • Subtitulo. • Mensaje.

Destinatarios de notificaciones

Las notificaciones usan tambien el sistema de destinatarios permitidos. Pueden enviarse a:

• Clientes concretos. • Grupos. • Listas inteligentes. • Todos los clientes.

Esto permite segmentar mucho. Por ejemplo:

• Enviar un aviso solo a clientes de una lista inteligente. • Avisar a clientes con compras activas. • Comunicar una incidencia a todos. • Mandar un mensaje solo a una persona concreta.

Como las notificaciones son mas visibles e inmediatas que un email, conviene ser mas selectivo con el publico.

Variables dinamicas en notificaciones

Las notificaciones tambien muestran el listado de variables dinamicas. El sistema reemplaza variables en:

• Titulo. • Subtitulo. • Mensaje.

Esto permite, por ejemplo:

`Hola {first_name}`

o:

`{first_name}, tienes novedades en tu centro`

La misma advertencia que en email aplica aqui: si el campo esta vacio, el resultado puede quedar incompleto. Conviene probar primero con un cliente interno o usar variables basicas como nombre.

Ajustes avanzados de notificacion

La pantalla de notificacion tiene un bloque de ajustes avanzados.

Incluye:

• Mostrar como alerta. • Fecha de expiracion de alerta. • Hacerla silenciosa.

Mostrar como alerta:

Hace que la notificacion pueda aparecer como alerta destacada dentro de la app. El codigo guarda `show_as_alert = 1` y crea registros no leidos para los clientes cuando se procesa.

Fecha de expiracion:

Permite que la alerta deje de mostrarse despues de una fecha/hora. Es util para avisos temporales: cierre por festivo, cambio de sala, promocion con fecha limite, corte de agua, etc.

Hacerla silenciosa:

Permite crear la notificacion sin enviar push sonora/visible al dispositivo. Si esta marcada como alerta, puede quedar disponible como alerta dentro de la app, pero sin lanzar una notificacion push normal.

Ejemplo:

• Aviso urgente: no silenciosa, quizas alerta. • Comunicado informativo: silenciosa o noticia, segun el caso. • Promocion: depende de la politica del centro para no saturar.

Enviar notificacion ahora

Enviar ahora guarda la notificacion y despacha el trabajo de envio.

El trabajo:

• Obtiene los destinatarios. • Reemplaza variables para cada cliente. • Busca tokens FCM del cliente. • Envia la notificacion push si hay tokens y no esta silenciada. • Crea registro no leido cuando procede. • Marca la notificacion como enviada.

Si el cliente no tiene tokens FCM, puede no recibir push en el dispositivo. Esto puede pasar si no ha iniciado sesion en la app, si ha cerrado sesion, si ha desactivado permisos del movil o si el token no esta actualizado.

Si la notificacion esta configurada como alerta, el sistema puede crear el registro no leido aunque no haya push normal.

Programar notificaciones

Al igual que con emails, una notificacion puede programarse.

Cuando llega la fecha, el proceso automatico:

• Comprueba si el centro esta silenciado. • Ajusta zona horaria/localizacion. • Comprueba si toca enviarla. • Despacha el envio. • Registra el resultado.

Si el centro tiene notificaciones silenciadas, no sale. Esto protege contra envios accidentales, pero tambien puede explicar por que una comunicacion programada no ha llegado.

Borradores de notificaciones

Los borradores permiten preparar una notificacion sin enviarla.

Es recomendable usarlos cuando:

• El mensaje debe ser revisado por direccion. • Se esta preparando una campana. • Falta confirmar una fecha. • Hay que comprobar destinatarios.

Diferencia entre notificacion y noticia

Notificacion:

Llega o aparece al usuario como aviso. Es mas inmediata. Debe ser breve, clara y accionable.

Noticia:

Vive como contenido dentro de la app. Puede ser mas larga, tener imagen y actuar como publicacion.

Ejemplo:

Para anunciar un nuevo horario de verano:

• Crear una noticia con imagen, explicacion completa y detalles. • Enviar una notificacion breve: `Ya tienes disponible el nuevo horario de verano en la app.`

Diferencia entre email y notificacion

Email:

Mejor para mensajes largos, formales o que el cliente debe conservar. Puede incluir mas explicacion, enlaces y formato.

Notificacion:

Mejor para avisos cortos, inmediatos o recordatorios. Debe ir al grano.

Ejemplo:

Email:

`Te explicamos las nuevas condiciones de reserva, cancelacion y recuperacion de sesiones.`

Notificacion:

`Hemos actualizado las condiciones de reserva. Revisa el email con todos los detalles.`

Silenciar emails y notificaciones

El sistema tiene una configuracion de silencio para emails y notificaciones del centro. Cuando esta activa, bloquea envios inmediatos y tambien impide que los procesos programados salgan.

Esto es util para:

• Evitar envios durante pruebas. • Pausar comunicaciones temporalmente. • Prevenir errores mientras se configura el centro.

Pero hay que tener cuidado: si se deja activo por error, los emails y notificaciones programadas no llegaran.

Comunicaciones desde otras zonas del panel

El modulo de Comunicacion no vive aislado. Otras partes del panel pueden abrir o lanzar comunicaciones:

• Desde ficha de cliente se puede preparar un email a un destinatario concreto. • Desde procesos de reserva/cancelacion se pueden enviar emails o notificaciones automaticas. • Desde contratos se pueden enviar solicitudes de firma. • Desde pagos o facturas pueden salir avisos relacionados. • Desde profesionales y ausencias pueden salir avisos a clientes afectados.

La seccion Comunicacion documentada aqui se centra en mensajes manuales o contenidos creados desde el panel, no en todos los mensajes automaticos del sistema.

Buenas practicas de comunicacion

Segmentar antes de enviar:

No enviar a todos si el mensaje solo afecta a un grupo. Usar listas inteligentes cuando el publico tenga una condicion clara.

Escribir asuntos concretos:

Un asunto como `Cambio de horario el lunes 15` es mejor que `Informacion importante`.

Usar variables con cuidado:

Probar campos dinamicos antes de enviar a muchos clientes. Usar variables basicas si no se sabe si los datos estan completos.

Revisar destinatarios:

Antes de enviar, comprobar si se ha seleccionado cliente individual, lista inteligente o todos los clientes.

Usar borradores:

Para mensajes sensibles, guardar borrador y revisar antes de enviar.

Programar con margen:

Si un aviso debe salir a una hora concreta, programarlo con tiempo y revisar que el centro no esta silenciado.

No abusar de notificaciones:

Demasiadas notificaciones pueden hacer que los clientes las ignoren o desactiven permisos.

Separar canales:

Usar email para detalle, notificacion para aviso rapido y noticia para contenido consultable.

Revisar enlaces:

Probar cualquier URL antes de enviar o publicar.

Cuidar imagenes de noticias:

La imagen es lo primero que vera el usuario. Debe ser clara, actual y no demasiado pesada.

Evitar datos sensibles:

No incluir informacion medica, financiera o privada en mensajes masivos salvo que sea imprescindible y este correctamente segmentado.

Errores habituales

No puedo enviar un email:

Puede faltar destinatario, asunto o mensaje. Tambien puede estar activo el silencio de emails/notificaciones.

El email no llega:

Puede haber cola pendiente, email incorrecto, proveedor bloqueando, spam, centro silenciado o destinatario sin email valido.

La variable no se reemplaza:

Puede estar mal escrita. Debe respetar las llaves, por ejemplo `{first_name}`. Si es un campo personalizado, revisar la clave exacta.

La variable queda vacia:

El cliente no tiene ese dato completado en su ficha.

La lista inteligente no envio a quien esperaba:

La lista puede tener criterios que excluyen clientes, o puede haberse resuelto con datos distintos a los esperados. Revisar la lista antes del envio.

La notificacion no llega al movil:

Puede que el cliente no tenga token FCM, haya cerrado sesion, no haya dado permisos de notificacion, use otro dispositivo o la notificacion se haya marcado como silenciosa.

La alerta no aparece:

Puede haber expirado, no estar marcada como alerta, no haberse creado registro no leido o el cliente no estar entre destinatarios.

La noticia no se ve:

Puede faltar imagen, estar eliminada, tener una fecha/orden inesperado, no estar consumida por la app o tener contenido/URL invalido.

Se envio a todos por error:

Seleccionar `Todos los clientes` sustituye la seleccion segmentada. Antes de enviar mensajes masivos hay que revisar destinatarios.

Un correo programado no salio:

Puede que la fecha no haya llegado, que el centro estuviera silenciado, que la tarea programada no se ejecutara o que hubiera error en cola.

Editar un enviado no cambia lo recibido:

Un email o notificacion ya recibido no se modifica en el dispositivo o bandeja del usuario por editar el registro en panel.

Rutina recomendada para enviar una comunicacion

Una rutina segura seria:

1. Decidir canal: email, noticia o notificacion. 2. Definir objetivo del mensaje. 3. Definir destinatarios. 4. Si aplica, crear o revisar lista inteligente. 5. Escribir asunto/titulo claro. 6. Escribir mensaje breve y directo. 7. Anadir variables dinamicas solo si aportan valor. 8. Revisar que las variables existen en los clientes. 9. Probar enlaces. 10. Guardar borrador si necesita revision. 11. Programar o enviar. 12. Revisar despues que aparece en Enviados o Programados.

Ejemplos practicos

Email a clientes activos:

Se crea una lista inteligente de clientes activos, se escribe un email con asunto claro y se usa `{first_name}` para personalizar el saludo. Se envia o programa.

Notificacion de cambio puntual:

Se seleccionan los clientes afectados, se escribe un titulo corto, un subtitulo y un mensaje claro. Si es urgente, no se marca como silenciosa.

Noticia de nueva actividad:

Se sube imagen, titulo, descripcion corta y contenido HTML explicando la actividad. Despues se puede enviar una notificacion breve enlazando mentalmente al usuario a revisar la app.

Alerta temporal:

Se crea una notificacion, se marca Mostrar como alerta y se define fecha de expiracion. Sirve para avisos que solo tienen sentido durante un periodo.

Permisos y visibilidad

Para usar Email hace falta permiso de gestion de emails.

Para usar Noticias hace falta permiso de gestion de noticias.

Para usar Notificaciones hace falta permiso de gestion de notificaciones.

Los destinatarios deben existir como clientes o resolverse desde grupos/listas inteligentes. Para que una notificacion llegue al movil, el cliente debe tener la app configurada y token de notificaciones disponible.

Esta guia no incluye modo superadmin. Cualquier configuracion global de proveedores de email, Firebase, PushAlert, colas, cron o integraciones debe documentarse aparte como parte tecnica.