Envoyer des notifications push natives iOS et Android à partir de capgo avec recherche d'utilisateur, badges, suivi en avant-plan/ouverture, rappels en arrière-plan et vérifications de mise à jour silencieuses capacitor

Le plugin est conçu pour le pipeline de notification Capgo. Capgo stocke les métadonnées de la plateforme et les données de contrôle de campagne dans Postgres, tandis que l'état actif des appareils et les événements de livraison sont écrits dans l'__CAPGO_KEEP_2__ Engine d'analyse

The plugin is built for the Capgo notification pipeline. Capgo stores platform credential metadata and campaign control data in Postgres, while active device state and delivery events are written to Cloudflare Analytics Engine.

Utilisez le __CAPGO_KEEP_0 CAPGO_KEEP_1__ pour un guide de configuration :

Use the Capgo CLI for a guided setup:

npx @capgo/cli@latest notifications setup com.example.app

Configurer

npm install @capgo/capacitor-notifications @capgo/capacitor-updater
npx cap sync

Voir la documentation

import { CapgoNotifications } from '@capgo/capacitor-notifications'

await CapgoNotifications.configure({
  appId: 'com.example.app',
  autoUpdater: true,
  updateInstallMode: 'next',
})

Inscription d'un Utilisateur Signé

Mint identityProof à partir de votre backend avec POST /notifications/recipients/proof, puis enregistrez ensuite le dispositif après que votre propre connexion réussisse.

await CapgoNotifications.register({
  externalId: 'customer-user-123',
  identityProof,
  tags: ['paid'],
  attributes: { plan: 'team' },
  consent: true,
})

Ecoutez Les Événements

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

Configuration iOS

Activer Notifications Push et Modes d'arrière-plan > Notifications à distance dans Xcode.

Transmettez les notifications à distance depuis 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)
}

Configuration Android

Exécuter npx cap sync androidConfigurez les informations de plateforme Android dans Capgo, demandez la permission de notification sur Android 13+ et testez sur un appareil ou un émulateur avec Google Play services.

Liste de vérification de débogage

Exécuter npx @capgo/cli@latest notifications setup com.example.app à partir du dossier qui contient capacitor.config.*.
Recherchez le destinataire dans Capgo par l'ID client externe.
Confirmez que l'appareil a la plateforme android ou ios Confirmez que la permission est accordée.
Ajoutez des écouteurs temporaires pour registrationChanged, notificationReceived, notificationOpenedet backgroundNotification.
Envoyer une notification de test depuis l'interface de dashboard.
Vérifier les statistiques pour les événements en attente, envoyés, reçus et ouverts.
Pour les vérifications de mise à jour silencieuses, vérifiez que @capgo/capacitor-updater est installé et autoUpdater est activé.

Référence complète

Docs : /docs/plugins/notifications/
Débogage : /docs/plugins/notifications/debugging/
Source : https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/

Continuez à partir de l'utilisation de @capgo/capacitor-notifications

Si vous utilisez Utilisez @capgo/capacitor-notifications pour planifier la messagerie push native, connectez-l’avec @capgo/capacitor-notifications pour les détails d'implémentation, Débogage pour le dépannage, @capgo/capacitor-updater pour les vérifications de mise à jour silencieuses, et Répertoire des plugins Capgo pour d'autres plugins natifs.

Notifications

Tutoriel sur les notifications