Notifications Plugin Capacitor

Usare @capgo/capacitor-notifications

Invia notifiche push native iOS e Android da Capgo con ricerca utenti, badge, tracciamento foreground/open, callback in background e controlli silent Capgo live-update.

Il plugin è ottimizzato per la pipeline di notifica Capgo. Capgo memorizza i metadati delle credenziali di piattaforma e i dati di controllo delle campagne in Postgres, mentre lo stato del dispositivo e gli eventi di consegna vengono scritti in Cloudflare Analytics Engine.

Installa

Usa 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 dal tuo backend con POST /notifications/recipients/proof, quindi registra il dispositivo dopo il login.

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()
  }
})

Setup iOS

Abilita Notifiche push e Modalità in 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 android, configura le credenziali della piattaforma Android in Capgo, richiedi il permesso per le notifiche su Android 13+ e testa su un dispositivo o emulatore con Google Play services.

Checklist per il debugging

• Esegui npx @capgo/cli@latest notifications setup com.example.app dalla cartella che contiene capacitor.config.*.
• Cerca il destinatario in Capgo tramite l'ID cliente esterno.
• Conferma che il dispositivo abbia la piattaforma android o ios e il permesso è stato concesso.
• Aggiungi listener temporanei per registrationChanged, notificationReceived, notificationOpened, e backgroundNotification.
• Invia una notifica di test dal dashboard.
• Controlla le statistiche di eventi in coda, inviati, ricevuti e aperti.
• Per i controlli di aggiornamento silenziosi, verifica @capgo/capacitor-updater è installato e autoUpdater è abilitato.

Riferimento completo

• Documentazione: /docs/plugins/notifications/
• Debugging: /docs/plugins/notifications/debugging/
• Sorgente: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/

Continua da Usare @capgo/capacitor-notifications

Se stai usando Usare @capgo/capacitor-notifications per pianificare la messaggistica push nativa, collegalo a @capgo/capacitor-notifications per i dettagli di implementazione, Debug per il troubleshooting, @capgo/capacitor-updater per i controlli degli aggiornamenti silenziosi, e Directory dei plugin di Capgo per altri plugin nativi.