Notificaciones en el navegador (Web Push)
Cómo activar las notificaciones del navegador y enviar una prueba. Permiso del visitante, archivo en el sitio y claves VAPID.
En esta página
Web Push muestra notificaciones mediante el navegador. Primero, el visitante de tu sitio con el widget debe permitirlas. Es una función distinta del icono de la campana y de las notificaciones para operadores del panel.
Paso 1. Instala el service worker en tu dominio
Pide al administrador de tu sitio que publique el archivo mybot-sw.js. Sin él, el navegador no puede recibir ni mostrar la notificación.
Un service worker es un pequeño programa que el navegador usa para recibir notificaciones. Debe estar alojado en tu sitio: un archivo del dominio de GetMyBot no puede gestionar las notificaciones de tu dominio. La dirección del sitio con el protocolo, pero sin la ruta de una página, se llama origin; por ejemplo, https://example.com.
-
En el panel, abre Widget → Web Push y descarga
mybot-sw.js. -
Publícalo en la raíz de cada origin donde se use el widget, exactamente en esta ruta:
https://example.com/mybot-sw.js https://shop.example.com/mybot-sw.jsLa configuración de Web Push muestra la dirección esperada para cada enlace de notificación permitido. Puedes abrir esas direcciones en el navegador y comprobar que se entrega el archivo.
-
Abre la dirección del archivo en el navegador. Debe devolver JavaScript por HTTPS, no una página del sitio. La suscripción no funcionará si devuelve
404, redirige a otra dirección o muestra una página. En sitios de una sola página y con CDN, comprueba en particular que no se devuelvaindex.html. -
Después de actualizar la plataforma, vuelve a publicar el archivo como cualquier otro recurso estático. No necesitas reinstalarlo al cambiar la configuración de Web Push ni al rotar las claves.
La ruta importa: el widget solo registra o reutiliza un worker situado en /mybot-sw.js. Añade por sí mismo los dos parámetros públicos de enrutamiento (mb_key y mb_api); no tienes que añadirlos manualmente.
Si registras el worker por tu cuenta
Si quieres controlar el registro o limitar las direcciones que puede abrir un clic en la notificación, registra el archivo desde el código de tu sitio:
navigator.serviceWorker.register("/mybot-sw.js?nav=https://shop.example.com");
En el parámetro nav puedes indicar, separados por comas, hasta 8 origins HTTPS exactos. El worker comprueba la dirección de destino tanto frente a su propia lista como frente a su propio origin, independientemente de la lista del servidor descrita en el paso 2. Si el widget encuentra este registro, conserva tu valor de nav.
Si tu sitio ya tiene un service worker
El widget no sustituye un worker instalado por tu sitio: hacerlo podría romperlo, y usar ese worker para suscribirse no instalaría los controladores de notificaciones y clics. Si otro worker ya controla la página, el intento de suscripción termina como «no disponible». Publica mybot-sw.js en un sitio que no tenga otro worker para la raíz o consulta con soporte antes de combinar ambos.
Paso 2. Activa Web Push para el bot
Web Push se configura en Widget, junto al resto de ajustes del canal web. Hay dos campos obligatorios:
- Contacto VAPID: una dirección
mailto:o URL HTTPS que los servicios de notificaciones puedan usar para avisarte de problemas de entrega, por ejemplo,mailto:help@example.com. - Enlaces de notificación permitidos: un origin HTTPS por línea. Al pulsar una notificación solo se puede abrir una ruta relativa de tu sitio o uno de esos origins exactos. Es un campo obligatorio: una notificación que apunte a otro lugar se rechaza antes del envío.
Al guardar por primera vez, el servidor genera un par de claves VAPID. El panel muestra la clave pública que recibe el navegador. La clave privada nunca sale del servidor ni se devuelve por la API.
Las horas de silencio existen en la API, pero por ahora no tienen un campo en esta pantalla.
Paso 3. Obtén el permiso de los visitantes
El visitante debe permitir las notificaciones expresamente. Cargar la página no lo suscribe:
- El navegador pide permiso solo después de que el visitante pulse el botón de notificaciones del widget.
- Quien no haya pulsado el botón no verá un error: si el navegador no admite las notificaciones o el permiso ya fue denegado, el control simplemente queda oculto hasta el primer intento.
- Al cargar el widget, solo se actualiza un permiso ya concedido. No se puede mostrar la solicitud, instalar el worker ni crear una suscripción nueva.
- La decisión de darse de baja se conserva incluso después de recargar la página, aunque el navegador mantenga activa su propia suscripción.
También puedes ofrecer ambas acciones desde el código de tu página, una vez cargado el widget:
await window.mybot.push.subscribe(); // pide permiso y registra la suscripción
await window.mybot.push.unsubscribe(); // la revoca en el servidor y en el navegador
Una suscripción tiene uno de estos estados: subscribed (activa), revoked (el visitante se dio de baja) o expired (la dirección de entrega ya no funciona). El panel y la API muestran el tipo de navegador, idioma, zona horaria, estado y fechas. La dirección de entrega y las claves de cifrado se guardan cifradas en el servidor. Una vez registradas, no se muestran al propietario ni se devuelven por la API o MCP.
Enviar una prueba
La sección de prueba envía un mensaje al navegador que se haya suscrito más recientemente. Se necesitan tres condiciones:
- Web Push activado para el bot;
- al menos una suscripción con estado
subscribed; - un documento publicado de tipo Push en Estudio de contenido. La prueba usa una versión publicada concreta, igual que un pop-up o una campaña.
Al iniciar la prueba, el panel recibe enseguida el identificador del mensaje; la entrega sigue en segundo plano. La selección de audiencia, la programación y la cancelación del envío todavía no están disponibles en ninguna pantalla.
Límites del contenido
Si el contenido incumple cualquiera de estos límites, el servidor rechaza todo el envío, sin recortar los datos:
| Campo | Límite |
|---|---|
title | obligatorio, entre 1 y 120 caracteres |
body | obligatorio, entre 1 y 512 caracteres |
tag | opcional, ≤128 caracteres |
actions | como máximo 2; identificador y texto de cada acción entre 1 y 64 caracteres, sin identificadores repetidos |
icon_url, image_url | solo HTTPS, sin información de usuario ni fragmento |
navigation | ruta relativa que empieza por /, o uno de los origins permitidos exactos |
data | solo las claves action, campaign_id, content_id, experiment_id, message_id; cada valor ≤256 caracteres |
| contenido completo generado | no más de 3 KiB |
Un valor de data se rechaza si contiene bearer , secret, password, token= o @. Así no se puede introducir un dato del perfil o un token de acceso en la notificación. También se rechaza el contenido que incluya su propia receipt_signature: el servidor añade este valor interno al enviar.
Tanto el servidor como el worker tratan las direcciones con forma //host/path o con barras invertidas como origins externos, no como rutas relativas.
Horas de silencio
Las horas de silencio son intervalos locales repetidos en los que la entrega se aplaza, no se cancela. El mensaje se envía en el primer momento permitido. Se usa la zona horaria del destinatario, guardada con la suscripción; si falta, la del bot. Si el final del intervalo es anterior al inicio, continúa después de medianoche. Una hora inexistente por el cambio de horario se desplaza hacia delante hasta una hora válida.
Las horas de silencio forman parte de la configuración de Web Push y se pueden definir mediante la API REST (campo quiet_hours), pero aún no tienen un editor en el panel.
Entrega, reintentos y recibos
- Un proceso en segundo plano recoge el mensaje, lo reserva durante la entrega y reintenta como máximo 8 veces o durante 24 horas, lo que ocurra primero.
- Si el servicio de notificaciones devuelve
429, se respeta suRetry-Aftercon un límite de 24 horas. Los tiempos de espera y las respuestas5xxse reintentan con un retraso variable. Cualquier otra respuesta4xxes definitiva. 404o410significan que la suscripción del navegador ya no existe: pasa aexpiredy no se reintenta.- El service worker devuelve dos recibos:
clickcuando el visitante abre la notificación yclosecuando la cierra. Cada recibo está firmado y vinculado a un mensaje y una suscripción; no puede falsificarse ni reutilizarse para otro mensaje. - El informe de configuración cuenta las suscripciones por estado y las notificaciones abiertas. Internamente se registran los eventos
accepted,sent,failed,expired,clickedyclosed, que también aparecen en la cronología del cliente en Personas.
No se guardan los cuerpos de las respuestas del servicio de notificaciones. Una entrega fallida solo conserva un código de motivo de una lista cerrada.
Rotación de claves VAPID
Cambiar las claves VAPID invalida todas las suscripciones actuales. Por eso, el panel muestra cuántos navegadores se verán afectados y pide confirmación. Técnicamente, la primera solicitud devuelve 409 con el número de suscripciones activas. Tras confirmar, se genera otro par de claves y las suscripciones antiguas dejan de ser válidas. Cada visitante deberá volver a permitir las notificaciones, porque su suscripción está vinculada a la clave anterior.
El widget también reconoce las suscripciones creadas con una clave antigua: las descarta y vuelve a crearlas cuando el visitante da su siguiente consentimiento explícito.
Límites de seguridad
Si tu equipo de seguridad necesita comprobar el funcionamiento:
- MyBot solo envía a una dirección HTTPS pública en el puerto 443. Se rechazan las direcciones de loopback, privadas, link-local, multicast y CGNAT. Si un nombre se resuelve a varias direcciones, todas deben ser públicas.
- El nombre de dominio se vuelve a comprobar en cada entrega, y la conexión solo se establece con una dirección verificada. No se siguen redirecciones y el tamaño de la respuesta está limitado.
- Las direcciones de suscripción repetidas se identifican mediante una huella dentro de la cuenta. Así, un bot no puede averiguar si un navegador está suscrito a otro bot.
- Las rutas del navegador están fuera de
/api, dentro de la zona de confianza del widget. Cada una vuelve a comprobar la clave firmada del widget, su sesión y el origin exacto de la página, y consume el mismo límite de solicitudes del widget.
Datos y conservación
Las suscripciones y los mensajes de Web Push pertenecen a la categoría de conservación push, con un plazo predeterminado de 180 días. Participan en la unificación de suscriptores y en la exportación y eliminación de datos personales como el resto de los datos del cliente.
Navegadores compatibles y solución de problemas
El navegador debe admitir a la vez las notificaciones, los service workers y Push API. Son compatibles las versiones actuales de Chrome, Edge y Firefox en ordenadores y Android. En iOS, Safari solo admite Web Push para un sitio que el visitante haya añadido a la pantalla de inicio.
Si no llega una notificación:
- Abre
https://tu-sitio/mybot-sw.jsen el navegador y comprueba que devuelve el script, no404, una redirección ni una página HTML. - Comprueba que el origin de la página figura entre los origins permitidos del widget y que el enlace de la notificación está permitido.
- Comprueba que el navegador concedió el permiso y que ningún otro service worker controla la página.
- Después de rotar las claves, comprueba que todos los visitantes se hayan suscrito de nuevo.
- Si no puedes enviar la prueba, falta un navegador suscrito o un documento publicado de tipo Push.
API y MCP
Las rutas de gestión están disponibles mediante un token personal; consulta API REST y tokens. Para leer se necesitan el alcance web_push:read y el permiso web_push.read del bot. Para modificar se necesitan web_push:write y web_push.write; la activación requiere además integrations.secrets. MCP ofrece cuatro herramientas de solo lectura, incluida la lista de suscripciones; consulta MCP.
Siguientes pasos
- Widget del sitio: instala y comprueba el widget.
- Estudio de contenido: crea el documento Push usado por el envío.
- SDK para aplicaciones: el mismo contenido y chat dentro de una aplicación móvil.