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.
- El usuario "John" abre la app.
- Tu sitio web llama a la función de javascript
getNotificationTokenque devuelve el token de notificación push de la app. - Tu sitio web almacena el token (por ejemplo, en la entrada de John en tu base de datos de usuarios).
- 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). Esta es la antigua implementación utilizada en las aplicaciones creadas/actualizadas antes de agosto de 2021.
Necesitas definir la función receivePushNotificationToken en tu sitio web para que pueda ser contactada por la app. Puedes hacerlo de la siguiente manera:
<script>
// this function automatically gets called by the app
function receivePushNotificationToken(token) {
// store the token (or whatever you want to do with it)
}
</script>
Cosas a tener en cuenta:
- La app llamará a la función javascript en cada carga de página. Es normal que a veces no hagas nada con el token, por ejemplo cuando el usuario no está conectado y, por tanto, no puede almacenar el token en la base de datos de usuarios.
- La app no llamará a la función de javascript si la aplicación, por alguna razón, no puede determinar el token de notificación push (muy poco probable, pero podría suceder en teoría).
- Obviamente, no todos los visitantes de tu sitio web utilizarán tu app, por lo que la función no será llamada en cada carga de página.
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
- 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.