Saltar al contenido principal

Web Push: implementar el registro del dispositivo

En esta guía, profundizaremos en cómo debe manejar el registro del dispositivo. Cuando launch() Notificare, el dispositivo se registrará como un dispositivo no push.

Cuando se produce un registro exitoso del dispositivo, emitimos un evento. Puede escuchar estas grabaciones de la siguiente manera.

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

onDeviceRegistered((device) => {
  // more code ...
});

También puede consultar los detalles del dispositivo registrado actualmente.

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

const device = getCurrentDevice();

El evento onReady() se activará cuando se hayan iniciado todos los módulos Notificare, incluido el registro exitoso del dispositivo.

Además, puede verificar si Notificare está listo en cualquier momento llamando a isReady() o escuchando el evento onReady() en cualquier parte de su código como se describe a continuación.

import { isReady, onReady } from 'notificare-web/core';

onReady((application) => {
  // more code ...
});

Asignar un usuario al dispositivo​

De forma predeterminada, un dispositivo se registra como usuario anónimo. Sin embargo, para utilizar plenamente las notificaciones automáticas en su estrategia omnicanal Actito, simplemente registrar un dispositivo anónimo no es lo que desea. Por lo tanto, deberá indicar a la biblioteca que desea registrarse como usuario específico.

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

await registerDevice({
  userId: '7f42bedc-d74b-4c64-a5cf-76bcc5130b05',
  userName: 'John Doe',
});

Después de eso, el dispositivo permanecerá registrado con este userId /userName hasta que lo registres explícitamente como anónimo. Dependiendo de cómo autentique a los usuarios, es posible que desee verificar el estado de inicio de sesión al iniciar (en onReady) y cambiarlo si es necesario. La mejor manera de forzar el registro como anónimo es estableciendo userId y userName en null.

:::consejo consejo Solo se utilizará el ID de usuario para hacer coincidir los dispositivos con los perfiles en su base de datos Actito.
El nombre de usuario solo se utiliza para proporcionar información adicional. :::

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

await registerDevice({
  userId: null,
  userName: null,
});

Para elegir el ID de usuario correcto:

  • Los datos deben estar disponibles como clave en Actito a través de la sincronización de datos entre su sistema y Actito.
  • Los datos deben estar disponibles en su sitio web (conectándose a un área de clientes).

Utiliza un atributo ya definido como único en tu tabla de perfil de Actito.

info

Si necesita agregar un nuevo atributo único, esto es posible, pero tenga cuidado ya que esto podría afectar su proceso de sincronización de datos entre su sistema y Actito. Consulte a su experto en integración si es necesario.

Cambiar idioma del dispositivo​

De forma predeterminada, recopilaremos automáticamente el idioma y la región de un dispositivo según la configuración regional del dispositivo. En la mayoría de los casos, esto será suficiente, pero en los casos en los que desee anular la combinación de idioma/región del dispositivo con una selección estricta de idiomas, puede hacerlo llamando al siguiente método:

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

await updatePreferredLanguage('en-US');

Finalmente, siempre puedes recuperar el idioma preferido llamando al siguiente método:

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

const preferredLanguage = getPreferredLanguage();