Saltar al contenido principal

Web Push: Personalizaciones

En esta página profundizaremos en varios aspectos de nuestra librería Web que se pueden personalizar para adaptarse a tus necesidades.

Configuración de claves en el código​

En lugar de depender del archivo de configuración notificare-services.json, que es el archivo que recuperaste en tu TransferBox, es posible establecer estas claves directamente en el código. Para configurar Notificare, debes ejecutar el siguiente código antes de cualquier otra interacción con la librería.

import { configure } from 'notificare-web/core';

configure({
  applicationKey: '{{ YOUR APPLICATION KEY }}',
  applicationSecret: '{{ YOUR APPLICATION SECRET }}',
});

El método configure() recibe el mismo objeto que el archivo notificare-services.json y debe llamarse antes de launch() para asegurar que se usen las claves correctas. Después de configurar las claves por código, puedes eliminar con seguridad el archivo notificare-services.json.

Opciones de configuración​

Tanto la función configure() como el archivo notificare-services.json aceptan el mismo objeto. A continuación se describen las propiedades y sus requisitos.

applicationKey obligatorio​

Puedes encontrar la clave de la aplicación en el archivo notificare-services.json proporcionado en tu TransferBox.

applicationSecret obligatorio​

Puedes encontrar el secreto de la aplicación en el archivo notificare-services.json proporcionado en tu TransferBox.

applicationVersion​

La versión de tu aplicación (por ejemplo, 1.0.0). Esta propiedad se registra en el dispositivo y es útil para gestionar actualizaciones.

language​

Define el idioma del sitio web. Se utiliza para la incorporación gestionada de Push con contenido localizado.

ignoreTemporaryDevices​

Evita el registro de dispositivos temporales. Cuando esta opción está activada, el SDK solo registrará un dispositivo cuando las notificaciones remotas estén habilitadas.

ignoreUnsupportedWebPushDevices​

Evita el registro de dispositivos temporales que no son capaces de recibir notificaciones remotas. Cuando esta opción está activada, el SDK continuará registrando dispositivos temporales siempre que sean capaces de recibir notificaciones remotas. Puedes dirigirte a estos dispositivos con mensajes in-app para fomentar la activación de notificaciones remotas.

serviceWorker​

La ubicación del archivo service worker en tu aplicación. Por defecto es /sw.js.

serviceWorkerScope​

El ámbito de tu service worker. Puedes consultar esta guía para más información.

Anular el tema por defecto​

Los elementos de la interfaz de nuestro SDK se adaptan a la apariencia preferida del sistema operativo. Si deseas forzar un modo claro u oscuro específico, puedes hacerlo utilizando el atributo data-notificare-theme para anular el tema por defecto.

<html data-notificare-theme='light'>
  <!-- more code ... -->
</html>