Inviare un messaggio di prova a un'app in background

Per iniziare a utilizzare FCM, crea il caso d'uso più semplice: l'invio di un messaggio di notifica a un utente specifico quando l'app è in background sul dispositivo. Questa pagina elenca tutti i passaggi per farlo, dalla configurazione alla verifica. Potrebbe includere passaggi che hai già completato se hai configurato un'app client JavaScript per FCM.

Configura l'SDK

Se non lo 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, prima richiedi all'utente le autorizzazioni di notifica con Notification.requestPermission(). Se viene 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. Se non hai già un file firebase-messaging-sw.js, crea un file vuoto con questo nome e posizionalo nella directory principale del tuo dominio prima di recuperare un token. Puoi aggiungere contenuti significativi al file in un secondo momento durante la procedura di configurazione del client.

Per recuperare il token corrente:

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.

Inviare 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 è il tuo primo messaggio, seleziona Crea la tua prima campagna.

    1. Seleziona Messaggi di notifica Firebase e 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 Aggiungi un token di registrazione FCM, inserisci il token di registrazione 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

Dopo aver inviato 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 un altro comportamento più avanzato alla tua app, consulta: