Saltare al contenuto principale
Indietro ai plugin
@capgo/capacitor-notifications
Guida
@capgo/capacitor-notifications

Notifiche

Invia notifiche native iOS e Android da Capgo con ricerca utente, badge, statistiche e controlli di aggiornamento silenzioso

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.app dalla cartella che contiene capacitor.config.*.
  • Cerca il destinatario in Capgo tramite ID cliente esterno.
  • Conferma che il dispositivo ha la piattaforma android o ios e la autorizzazione è stata concessa.
  • Aggiungi ascoltatori temporanei per registrationChanged, notificationReceived, notificationOpened, e backgroundNotification.
  • 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 e autoUpdater è abilitato.

Riferimento completo

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.