Per iniziare con FCM, crea il caso d'uso più semplice: inviare 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 coprire i passaggi già completati se hai configurato un'app client JavaScript per FCM.
Configura l'SDK
Se non l'hai già fatto, aggiungi Firebase al tuo progetto JavaScript .
Accedi al token di registrazione
Quando devi recuperare il token di registrazione corrente per un'istanza dell'app, richiedi innanzitutto le autorizzazioni di notifica all'utente con Notification.requestPermission()
. Quando 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 quel nome e inseriscilo nella radice del tuo dominio prima di recuperare un token. È possibile aggiungere contenuto significativo al file in un secondo momento nel processo di configurazione del client.
Per recuperare il token corrente:
Web modular API
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 namespaced API
// 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 preferito.
Invia 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 remote.
Assicurati che l'app sia in background sul dispositivo.
Nella console Firebase, apri la pagina Messaggistica .
Se questo è il tuo primo messaggio, seleziona Crea la tua prima campagna .
- Seleziona Messaggi di notifica Firebase e seleziona Crea .
Altrimenti, 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 di destra.
Nel campo denominato Aggiungi un token di registrazione FCM , inserisci il token di registrazione ottenuto in una sezione precedente di questa guida.
Seleziona Prova .
Dopo aver selezionato Test , il dispositivo client di destinazione (con l'app in background) dovrebbe ricevere la notifica.
Prossimi passi
Invia messaggi alle app in primo piano
Dopo aver inviato correttamente i messaggi di notifica mentre l'app è in background, vedi Ricevere messaggi in un client JavaScript per iniziare a inviare alle app in primo piano.
Vai oltre i messaggi di notifica
Per andare oltre i messaggi di notifica e aggiungere altri comportamenti più avanzati alla tua app, consulta: