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 raggiungere questo obiettivo, 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()
.
Quando viene chiamato come mostrato, restituisce un token se viene concessa l'autorizzazione oppure se la promessa viene rifiutata:
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 delle app e archivialo utilizzando il tuo metodo preferito.
Inviare un messaggio di notifica di prova
Installa ed esegui l'app sul dispositivo di destinazione. Sui dispositivi Apple, dovrai accettare la richiesta di autorizzazione per ricevere notifiche da remoto.
Assicurati che l'app sia in background sul dispositivo.
Nella console Firebase, apri la pagina Messaggistica.
Se è il tuo primo messaggio, seleziona Crea la tua prima campagna.
- Seleziona Messaggi di notifica Firebase e Crea.
In caso contrario, nella scheda Campagne, seleziona Nuova campagna e poi Notifiche.
Inserisci il testo del messaggio. Tutti gli altri campi sono facoltativi.
Seleziona Invia messaggio di prova dal riquadro a destra.
Nel campo Aggiungi un token di registrazione FCM, inserisci il token di registrazione ottenuto in una sezione precedente di questa guida.
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: