Notificaciones (Notification Manager)
¿Para qué sirve?
Avisa a las personas correctas cuando algo cambia de estado en un workflow: por campana dentro del panel y/o por correo electrónico.
¿Cuándo lo necesitas?
Cuando tus flujos son colaborativos y necesitas que la gente se entere cuando algo cambia sin tener que abrir el panel constantemente.
Cómo activarlo
- Debes tener Workflow Manager activo con al menos un módulo con workflow definido.
- Configura el envío de correo (ver Plantillas de correo) si vas a usar el canal email.
- Registra
notification-manager. - Aparece Notificaciones en el menú lateral.
Configuración inicial
Se crean reglas. Cada regla responde a: "cuando el módulo X hace la transición Y, notificar por Z canal a W destinatario".
- Presiona Nueva regla.
- Elige el módulo y la transición que dispara el aviso (ej.
pedidos → listo). - Marca los canales: campana, correo o ambos.
- Elige el destinatario: un rol completo (ej. rol admin) o un usuario puntual.
- Escribe el título y el texto del mensaje en lenguaje claro para quien lo recibe.
- Guarda.
Ejemplo del sistema:
| Módulo | Transición | Canales | Destinatario |
|---|---|---|---|
visitas | reprogramar → reprogramada | Campana + Correo | Rol admin |
visitas | completar → completada | Campana | Rol admin |
pedidos | listo → listo | Campana + Correo | Rol admin |
Cómo se usa día a día
- Icono de campana arriba en el CMS con contador de no leídas en rojo.
- Click abre las últimas notificaciones. Cada una linkea al registro relacionado.
- Los correos se envían con el remitente configurado en Configuración → Correo.
- Los usuarios pueden marcar como leído individualmente o "marcar todo como leído".
El centro de notificaciones
La sección Notificaciones del menú es el centro de todo el panel, no solo de este módulo. En Mis preferencias, cada persona decide aviso por aviso si quiere verlo en la campana, recibirlo por correo, las dos cosas o ninguna.
La lista se arma sola con lo que declara cada módulo activo. Hoy incluye:
| Módulo | Avisos |
|---|---|
| Recursos Humanos | Respuesta a mi solicitud de ausencia · Nueva solicitud de ausencia · Mi liquidación está disponible · Contrato por vencer |
| Tableros | Me asignan una tarea · Cambia el estado de mis tareas · Algo mío está por vencer |
Una preferencia personal nunca enciende lo que la instalación dejó apagado: si una regla o un tablero tiene un aviso desactivado, no llega aunque la persona lo deje encendido en su lista. Al revés sí: apagarlo ahí manda sobre todo lo demás.
El texto de cada correo se edita en Configuración → Correo, con vista previa.
Para quien desarrolla módulos
Un módulo declara su aviso una vez —nombre legible, variables, canales por defecto y su plantilla de correo— y lo envía con una línea:
Notifications::dispatch('hr.absence_decided', [$idAdmin], [
'estado' => 'aprobada',
'mensaje' => 'Tu solicitud de Vacaciones del 05-08 al 12-08 fue aprobada.',
], 'mi-portal');
Quién lo recibe y por qué canal lo decide el motor con las preferencias de cada persona: el módulo no tiene que saber nada de eso.
Se conecta con
- Workflow Manager — la fuente de las transiciones.
- Board Manager — mover una tarjeta ejecuta una transición, que dispara notificaciones.
- Task Boards — tiene su propio sistema de notificaciones independiente.
Preguntas frecuentes
¿Puedo enviar solo in-app, sin correo? Sí, cada regla activa campana, correo o ambos.
¿Los correos usan mi remitente? Sí, el que configuraste en Configuración → Correo.
¿Puedo personalizar el HTML del correo? El título y texto del mensaje los defines por regla. Para HTML más complejo, ver Plantillas de correo.
¿Qué pasa si el correo falla? El sistema hace su mejor intento (best-effort). Si un envío falla, se registra en el log pero no interrumpe la transición. El estado del registro se guarda igual.
¿Puedo notificar sin workflow? No — este plugin está atado a workflows. Para notificaciones por otros eventos (creación de registro, formulario recibido), considera una automatización custom o usa las notificaciones propias de Task Boards.
¿Qué sigue?
- Plantillas de correo — personalizar el HTML de los emails.
- Los correos no llegan — troubleshooting.
- Workflow Manager — definir las transiciones que disparan notificaciones.