Inviare un messaggio di prova a un'app in background

Per iniziare a utilizzare FCM, crea lo scenario d'uso più semplice: invia un messaggio di notifica a un utente specifico quando l'app è in background sul dispositivo. Questa pagina elenca tutti i passaggi per raggiungere questo obiettivo, dalla configurazione alla verifica e potrebbe includere passaggi che hai già completato se hai configurato un'app client JavaScript per FCM.

Configura l'SDK

Se non l'hai già fatto, aggiungi Firebase al tuo progetto JavaScript.

Accedere al token di registrazione

Quando devi recuperare il token di registrazione corrente per un'istanza dell'app, per prima cosa richiedi le autorizzazioni di notifica all'utente con Notification.requestPermission(). Se chiamato come mostrato, restituisce un token se l'autorizzazione viene concessa o rifiuta la promessa se negata:

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

FCM richiede un file firebase-messaging-sw.js. A meno che tu non abbia già un file firebase-messaging-sw.js, crea un file vuoto con questo nome e inseriscilo nella radice del tuo dominio prima di recuperare un token. Puoi aggiungere contenuti significativi al file in un secondo momento nella procedura di configurazione del client.

Per recuperare il token attuale:

Web

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

// 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);
  // ...
});

Dopo aver ottenuto il token, invialo al server dell'app e archivialo utilizzando il metodo che preferisci.

Invia un messaggio di notifica di prova

  1. Installa ed esegui l'app sul dispositivo di destinazione. Sui dispositivi Apple, dovrai accettare la richiesta di autorizzazione per ricevere notifiche da remoto.

  2. Assicurati che l'app sia in background sul dispositivo.

  3. Nella console Firebase, apri la pagina Messaggistica.

  4. Se questo è il tuo primo messaggio, seleziona Crea la tua prima campagna.

    1. Seleziona Messaggi di notifica Firebase e poi Crea.
  5. In caso contrario, nella scheda Campagne, seleziona Nuova campagna e poi Notifiche.

  6. Inserisci il testo del messaggio. Tutti gli altri campi sono facoltativi.

  7. Seleziona Invia messaggio di prova dal riquadro a destra.

  8. Nel campo etichettato Aggiungi un token di registrazione FCM, inserisci il token di registrazione che hai ottenuto in una sezione precedente di questa guida.

  9. Seleziona Testa.

Dopo aver selezionato Test, il dispositivo client di destinazione (con l'app in background) dovrebbe ricevere la notifica.

Passaggi successivi

Inviare messaggi alle app in primo piano

Una volta inviati correttamente i messaggi di notifica mentre l'app è in background, consulta Ricevere messaggi in un client JavaScript per iniziare a inviare messaggi alle app in primo piano.

Andare oltre i messaggi di notifica

Per andare oltre i messaggi di notifica e aggiungere altri comportamenti più avanzati alla tua app, consulta: