Guida
Tutoriale sulle notifiche
Utilizzare @capgo/capacitor-notifiche
Inviare notifiche push native per iOS e Android da Capgo con ricerca utente, badge, tracciamento aperto/foreground, callback di background e controlli di aggiornamento silenzioso Capgo
Il plugin è progettato per il flusso di notifiche Capgo. Capgo memorizza i metadati delle credenziali delle piattaforme e i dati di controllo delle campagne nel Postgres, mentre lo stato attivo dei dispositivi e gli eventi di consegna sono scritti nel Cloudflare Analytics Engine
Installa
Utilizza il Capgo CLI per una configurazione guidata:
npx @capgo/cli@latest notifications setup com.example.app
Installazione manuale:
npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync
Configura
import { CapgoNotifications } from '@capgo/capacitor-notifications'
await CapgoNotifications.configure({
appId: 'com.example.app',
autoUpdater: true,
updateInstallMode: 'next',
})
Registra un utente firmato
Mint identityProof dalla tua backend con POST /notifications/recipients/proofpoi registra il dispositivo dopo che il tuo login ha avuto successo.
await CapgoNotifications.register({
externalId: 'customer-user-123',
identityProof,
tags: ['paid'],
attributes: { plan: 'team' },
consent: true,
})
Ascolta gli eventi
await CapgoNotifications.addListener('notificationReceived', (notification) => {
console.log('Received', notification)
})
await CapgoNotifications.addListener('notificationOpened', (event) => {
console.log('Opened', event.notification.id)
})
await CapgoNotifications.addListener('backgroundNotification', async (event) => {
try {
console.log('Background payload', event.notification.data)
} finally {
await event.finish()
}
})
Configurazione iOS
Abilita Notifiche push e Modalità di background > Notifiche remote in Xcode.
Inoltra le notifiche remote da ios/App/App/AppDelegate.swift:
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
NotificationCenter.default.post(name: Notification.Name("CapgoNotificationsRemoteNotification"), object: userInfo)
completionHandler(.newData)
}
Configurazione Android
Esegui npx cap sync androidEsegui, configurare le credenziali della piattaforma Android in Capgo, richiedere la autorizzazione alla notifica su Android 13+ e testare su un dispositivo o emulatore con Google Play services.
Elenco di controllo di debug
- Esegui
npx @capgo/cli@latest notifications setup com.example.appdalla cartella che contienecapacitor.config.*. - Cerca il destinatario in Capgo tramite ID cliente esterno.
- Conferma che il dispositivo ha la piattaforma
androidoiose la autorizzazione è stata concessa. - Aggiungi ascoltatori temporanei per
registrationChanged,notificationReceived,notificationOpened, ebackgroundNotification. - Inviare una notifica di prova dalla dashboard.
- Verifica le statistiche per gli eventi in coda, inviati, ricevuti e aperti.
- Per controlli di aggiornamento silenziosi, verificare
@capgo/capacitor-updaterè installato eautoUpdaterè abilitato.
Riferimento completo
- Documentazione: /docs/plugins/notifications/
- Debugging: /docs/plugins/notifications/debugging/
- Fonte: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/
Continua con l'utilizzo di @capgo/capacitor-notifications
Se stai utilizzando Utilizza @capgo/capacitor-notifications per pianificare la messaggistica push nativa, connettilo con @capgo/capacitor-notifications per i dettagli di implementazione, Debugging per la risoluzione dei problemi, @capgo/capacitor-updater per controlli di aggiornamento silenziosi, e Capgo Directory dei plugin per altri plugin nativi.