Saltar al contenido principal

Notificaciones push (ntfy)

¿Para qué sirve?​

Envía notificaciones push a los celulares de tu equipo o de tus clientes usando la app ntfy — una app de código abierto que la persona instala una vez, se suscribe al topic que le pases (por QR o link) y empieza a recibir todo lo que publiques ahí.

Sin cuenta, sin cargarle credenciales al usuario, sin depender de que compre una app propietaria. La app se llama ntfy y está en:

¿Cuándo lo necesitas?​

Cuando quieres que el celular avise al toque, sin depender de que alguien mire el correo:

  • Alertas al equipo — nueva reserva, pago recibido, backup falló, stock bajo el mínimo, licencia por vencer. Un topic compartido para la sucursal o para el rol.
  • Recordatorios al cliente — cita mañana a las 15:00, pago pendiente, orden lista para retirar. Un topic por cliente que suscribe con QR al reservar.
  • Sistema de guardia — el técnico de guardia recibe pings cuando algo cae. Priority urgent pasa por el "no molestar".

Si sólo necesitas mandar correos, alcanza con Notification Manager. Si quieres mandar por WhatsApp, mira WhatsApp. ntfy es la vía push directo al celular, complementaria a las otras dos.

Cómo activarlo​

  1. Entra a Configuración → Módulos y activa ntfy — notificaciones push (también desde Agregar Sección → Tipo: Plugin). Sus tablas se crean solas la primera vez.
  2. Dale acceso a la sección al rol de quien la va a administrar en Roles y Permisos (por defecto sólo los roles legado superadmin y admin).
  3. Elige qué server ntfy vas a usar en la pestaña Configuración:

Configuración inicial​

En Configuración → ntfy — notificaciones push llenas cuatro campos:

  • Servidor ntfy — la URL del server. HTTPS obligatorio.
  • Rate limit por hora — cuántas publicaciones acepta cada topic antes de refusar. 60 por hora está bien para arrancar.
  • Token (opcional) — sólo si tu server usa autenticación.
  • Prefijo para topics — un prefijo automático para no colisionar con otras instalaciones que compartan el server. Ejemplo: aurora- hace que cuando escribas "clientes" se guarde como aurora-clientes.

Después vas a la pestaña Topics y creas tus primeros dos:

  • Un topic Equipo interno (ej. aurora-equipo-alertas) — todos los del negocio escanean el QR y reciben avisos.
  • Un topic Cliente final (ej. aurora-recordatorios) — a cada cliente le pasas el link/QR de este topic cuando reserva.

Al crear un topic de equipo eliges también qué avisa solo el sistema:

  • Sólo a mano — sólo lo que tú envíes desde esta pantalla o desde una regla de Notificaciones.
  • Reservas nuevas — cada vez que entra una reserva en Reservas de Servicios, el equipo recibe «Camila R. reservó Asesoría de lactancia — 30/09 09:00». Va el nombre y la inicial del apellido, nunca el nombre completo ni el contacto.
Sin un topic marcado, no se avisa nada

Reservas de Servicios no publica en ningún topic que no hayas marcado tú. Y un topic de Cliente final nunca recibe avisos automáticos: llevan datos de otras personas.

Cómo se usa día a día​

Compartir un topic​

En la lista de topics, cada fila tiene un botón QR que abre un modal con:

  • Un código QR grande.
  • El link directo debajo, seleccionable con un click.

El destinatario abre la app ntfy → + → Subscribe to topic → Server: tu URL, Topic: el nombre. O escanea el QR y listo.

Mandar una prueba​

Cada topic tiene un botón Enviar prueba (el ícono de flecha) que publica un mensaje "¡Funcionó!" a los suscritos. Es la forma más rápida de verificar que la cadena está viva.

Silenciar un topic​

El botón del altavoz silencia (o des-silencia) el topic. Un topic silenciado no acepta publicaciones — útil cuando el equipo está de vacaciones y no quieres spamear los celulares.

Integraciones automáticas​

Cuando otros módulos publican, aparecen en la pestaña Actividad con la marca owner_module:

  • booking-manager publica en los topics marcados «Reservas nuevas» cuando entra una reserva (una que espera su pago en línea, recién al pagarse).
  • notification-manager dispara según las reglas visuales que armes.

Se conecta con​

  • Notification Manager — lo detecta automáticamente y aparece como cuarto canal en las reglas visuales (junto a in-app, email, WhatsApp).
  • Reservas de Servicios — publica un aviso al equipo cuando entra una reserva nueva.
  • Sucursales — puedes tener un topic por local para que cada equipo reciba sólo lo suyo.

Preguntas frecuentes​

¿Los topics son privados? Depende del server. ntfy.sh no tiene ACL — quien adivine el nombre lo lee. Para topics sensibles usa un nombre imposible de adivinar (UUID) o levanta tu propio server con auth. Los links de suscripción QR llevan el nombre completo, así que compartir el QR ES compartir el acceso.

¿Cuánto cuesta ntfy.sh? Nada. Pero el server público tiene límite de 250 mensajes/día por IP sin cuenta. Si vas a mandar muchos, autohospeda o paga el tier de ntfy.sh.

¿Los mensajes se guardan? Sí, en el server durante 12 horas por defecto (self-hosted). Si un suscriptor abre la app después de una hora, ve los mensajes que llegaron mientras estuvo desconectado.

¿Puedo mandar attachments (fotos, PDFs)? El protocolo ntfy sí; este plugin todavía no expone attachments — v1 sólo texto. Puedes mandar un link a un archivo alojado en el sitio.

¿El cliente puede darse de baja? Sí, desde la app ntfy — un click y deja de recibir. También puede poner el topic en "silencioso" sin desuscribirse.

¿Emojis en el mensaje? Sí, funcionan como texto plano. Además ntfy interpreta tags como "tada", "rocket", "warning" y las renderiza como emoji en el badge.

¿Qué sigue?​