Envía un mensaje de prueba a una app en segundo plano

Para comenzar a usar FCM, crea el caso de uso más sencillo: enviar un mensaje de notificación a un usuario específico cuando la app se encuentra en segundo plano en el dispositivo. En esta página, se indican todos los pasos necesarios para lograrlo, desde la configuración hasta la verificación. Es posible que ya hayas realizado algunos de los pasos si configuraste una app cliente de JavaScript para FCM.

Configura el SDK

Si no lo hiciste antes, agrega Firebase al proyecto de JavaScript.

Accede al token de registro

Cuando necesites recuperar el token de registro actual de una instancia de app, primero solicita los permisos de notificación del usuario con Notification.requestPermission(). Cuando se realiza la llamada como en el ejemplo, se muestra un token si se otorga el permiso o se rechaza la promesa si se niega:

function requestPermission() {
  console.log('Requesting permission...');
  Notification.requestPermission().then((permission) => {
    if (permission === 'granted') {
      console.log('Notification permission granted.');

FCM necesita un archivo firebase-messaging-sw.js. A menos que ya tengas un archivo firebase-messaging-sw.js, crea un archivo vacío con ese nombre y guárdalo en la raíz de tu dominio antes de recuperar un token. Puedes agregar contenido significativo al archivo en etapas posteriores del proceso de configuración del cliente.

Para recuperar el token actual, sigue este ejemplo:

Web version 9

import { getMessaging, getToken } from "firebase/messaging";

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
const messaging = getMessaging();
getToken(messaging, { vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});

Web version 8

// Get registration token. Initially this makes a network call, once retrieved
// subsequent calls to getToken will return from cache.
messaging.getToken({ vapidKey: '<YOUR_PUBLIC_VAPID_KEY_HERE>' }).then((currentToken) => {
  if (currentToken) {
    // Send the token to your server and update the UI if necessary
    // ...
  } else {
    // Show permission request UI
    console.log('No registration token available. Request permission to generate one.');
    // ...
  }
}).catch((err) => {
  console.log('An error occurred while retrieving token. ', err);
  // ...
});

Después de obtener el token, envíalo a tu servidor de apps y almacénalo con el método que prefieras.

Envía un mensaje de notificación de prueba

  1. Instala y ejecuta la app en el dispositivo de destino.

  2. Asegúrate de que la app se encuentre en segundo plano en el dispositivo.

  3. Abre el Compositor de Notifications y selecciona Notificación nueva.

  4. Ingresa el texto del mensaje.

  5. Selecciona Enviar mensaje de prueba.

  6. En el campo Agregar un token de registro de FCM, ingresa el token de registro que obtuviste en una sección anterior de esta guía.

  7. Haz clic en Probar.

Después de hacer clic en Probar, los dispositivos cliente de destino que tienen la app en segundo plano recibirán la notificación en el navegador.

Próximos pasos

Envía mensajes a apps en primer plano

Una vez que hayas enviado mensajes de notificación de manera correcta mientras la app está en segundo plano, consulta cómo recibir mensajes en un cliente de JavaScript para comenzar a enviar mensajes a apps en primer plano.

Más allá de las notificaciones

Para ir más allá de las notificaciones y agregar otros comportamientos más avanzados a tu app, consulta lo siguiente: