Enviar notificaciones push a usuarios individuales

Actualizado el 20. diciembre 2023 por Jan Bunk


Las funciones descritas en esta página requieren un plan que incluya notificaciones push.

El concepto básico sobre cómo se pueden enviar notificaciones push a usuarios individuales de tu aplicación es el siguiente:

En esta guía, "user" siempre se refiere a una persona que tiene una cuenta de usuario en tu sitio web.
  1. El usuario "John" abre la app.
  2. Tu sitio web llama a la función de javascript getNotificationToken que devuelve el token de notificación push de la app.
  3. Tu sitio web almacena el token (por ejemplo, en la entrada de John en tu base de datos de usuarios).
  4. Cuando quieras enviar una notificación a John, llamas a la API de webtoapp.design con el token y nosotros entregaremos la notificación.

Usando la función de Javascript

Quizá quieras consultar la función executeWhenAppReady() de nuestro script de ayuda de la aplicación. Garantiza que tu sitio web no intente interactuar con la aplicación antes de que esté lista o cuando tu sitio web se cargue utilizando un navegador normal (ReferenceError, function is not defined).

Cuando quieras obtener el token de notificación push de una instancia de la app, simplemente llama a la función getNotificationToken.


<script>
    try {
        var token = (await getNotificationToken())["token"];
    }
    catch (e) {
        // Can occur if:
        // - the app couldn't connect to the native code. Should be very unlikely.
        // - the app couldn't get the push notification token, maybe because of connection issues. Should be very unlikely.
        // - push notifications are not included in your current plan
        console.log(e);
    }
</script>
    

Cosas a tener en cuenta:

  • El token es una cadena larga, por ejemplo:
  • El token de un usuario puede cambiar,
    • cuando el mismo usuario utiliza la app en un dispositivo diferente
    • cuando la app se desinstala y se vuelve a instalar
    • cuando se borran los datos de la app
    Esto significa que los antiguos tokens de notificación de un usuario pueden dejar de ser válidos, por lo que debes almacenar regularmente los tokens. En caso de que quieras que el mismo usuario utilice tu app en varios dispositivos, deberás almacenar varios tokens para cada usuario.
  • Mantén los tokens de las notificaciones push en secreto.

Referencia del punto final de la API

Obtenga la clave API específica de tu aplicación en el panel de control de la app.

Envíe su clave de API como una consulta en la URL y el cuerpo de la solicitud en formato JSON.

Visión general de las notificaciones push