Activar las notificaciones push al móvil paso a paso (AppMovilFS 1.5)

Desde la versión 1.5 ya no hace falta composer ni ninguna librería para que los avisos lleguen al móvil. Esta guía va paso a paso.

Requisito que no depende del plugin: HTTPS

Los navegadores solo permiten notificaciones push en sitios servidos por HTTPS. Es una norma suya, no del plugin. Si tu FacturaScripts está en http:// sin certificado, el móvil nunca pedirá permiso y no hay nada que configurar aquí. La excepción es localhost, que los navegadores tratan como seguro para pruebas.

Paso 1: generar las claves

Panel de control > App móvil. Pulsa Generar claves VAPID.

Se crean en el momento, con la extensión openssl de PHP. No se envían a ningún sitio: son tuyas y se guardan en tu base de datos.

Las claves VAPID identifican a tu servidor ante Google, Apple o Mozilla, que son quienes entregan el aviso al teléfono. Si las regeneras, las suscripciones que ya existían dejan de funcionar y cada usuario tendrá que volver a aceptar los avisos. Genéralas una vez y no las toques.

Paso 2: activar el push

Marca el interruptor Activar push web y pulsa Guardar.

Arriba verás el estado. Debe poner Push listo. Si no:

| Lo que pone | Qué hacer | |---|---| | Faltan las claves VAPID | Vuelve al paso 1 | | Push desactivado | Marca el interruptor y guarda | | Este servidor no tiene openssl con curva P-256 | Tu hosting no puede enviar push. Las notificaciones seguirán funcionando dentro de la aplicación, en la campana. Pregunta a tu proveedor por la extensión openssl |

Paso 3: que cada usuario acepte los avisos

Esto lo hace cada persona en su móvil, y no se puede hacer por ellos:

1. Abre FacturaScripts en el navegador del teléfono.
2. Instala la aplicación desde el menú del navegador: Instalar aplicación o Añadir a pantalla de inicio.
3. Ábrela desde el icono nuevo y acepta los avisos cuando el navegador lo pregunte.

En el panel verás cuántos dispositivos hay suscritos. Si pone 0, es que todavía nadie ha aceptado.

Paso 4: comprobarlo

Pulsa Enviarme una notificación de prueba. Si ves el aviso en la campana y también en el móvil, está todo listo.

Cosas que conviene saber

Si un usuario desinstala la app o revoca el permiso, el servicio de push responde que esa suscripción ya no vale y el plugin la borra solo. No hace falta limpiar nada a mano.

Cada persona puede tener varios dispositivos: el móvil y el ordenador, por ejemplo. Cada uno es una suscripción distinta y recibe el aviso.

Si el móvil está apagado, el servicio guarda el mensaje hasta 24 horas y lo entrega cuando vuelva a conectarse.

Longitud del mensaje: cabe algo menos de 4 KB. Los avisos normales no llegan ni de lejos a ese tamaño; si te pasas, el texto se recorta en vez de fallar el envío.

Enviar avisos desde tus propios plugins

Una línea, desde cualquier plugin:

use FacturaScripts\Plugins\AppMovilFS\Lib\Notificador;

Notificador::enviar( 'nick_usuario', 'Pedido nuevo', 'PED2026-014 de Ferretería Molina, 340,50 EUR', '/EditPedidoCliente?code=14', 'fas fa-cart-shopping', 'MiPlugin' );

Aparece en la campana del usuario y, si el push está listo, también en su teléfono. Si el push no está configurado, la notificación sigue funcionando dentro de la aplicación: nunca falla el envío por eso.

Por qué antes no funcionaba

El envío de un push no es una simple petición HTTP: hay que firmar un token con la clave VAPID y cifrar el mensaje con una clave que se deriva de la del propio navegador. Eso antes lo hacía una librería externa que había que instalar con composer, algo que en un hosting compartido normal no está a mano. Ahora lo hace el plugin con lo que PHP ya trae de serie.