Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-Benachrichtigungen
Anleitung
@capgo/capacitor-Benachrichtigungen

Benachrichtigungen

Senden Sie native iOS- und Android-Benachrichtigungen von Capgo mit Benutzerlookup, Badges, Statistiken und stummen Aktualisierungsprüfungen

Richtlinie

Benutzerhandbuch zu Benachrichtigungen

Mit @capgo/capacitor-benachrichtigungen native iOS- und Android-Benachrichtigungen senden

Die Erweiterung ist für den Capgo-Benachrichtigungs-Pipeline erstellt. Capgo speichert Plattform-Zugriffsmetadaten und Kampagnensteuerungsdaten in Postgres, während aktive Gerätestatus und Lieferungsereignisse in __CAPGO_KEEP_2__ Analytics Engine geschrieben werden.

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.

Verwenden Sie die __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ für eine geführte Einrichtung:

Use the Capgo CLI for a guided setup:

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

Manuelle Installation:

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

Konfigurieren

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

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

Ein registrierter Benutzer registrieren

Minten identityProof von Ihrem Backend mit POST /notifications/recipients/proof, dann registrieren Sie das Gerät nach Ihrem eigenen Login erfolgreich ist.

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

Für Ereignisse lauschen

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

iOS-Einrichtung

Zulassen Benachrichtigungen über Push und Hintergrundmodi > Remotebenachrichtigungen in Xcode.

Fernübertragung von Benachrichtigungen von 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)
}

Android-Einrichtung

Ausführen npx cap sync androidAusführen, konfigurieren Sie die Android-Plattformkredenziale in Capgo, stellen Sie die Benachrichtigungsrechte auf Android 13+ ein und testen Sie auf einem Gerät oder einem Emulator mit Google Play-Diensten.

Überprüfungscheckliste

  • Ausführen npx @capgo/cli@latest notifications setup com.example.app aus dem Ordner, der __CAPGO_KEEP_0__ enthält capacitor.config.*.
  • Suchen Sie den Empfänger in Capgo nach externer Kunden-ID.
  • Bestätigen Sie, dass das Gerät die Plattform android oder ios und die Genehmigung ist erteilt.
  • Hinzufügen von temporären Hörern für registrationChanged, notificationReceived, notificationOpened, und backgroundNotification.
  • Senden Sie einen Testbenachrichtigung von der Dashboard aus.
  • Überprüfen Sie die Statistiken für die angesammelten, gesendeten, empfangenen und geöffneten Ereignisse.
  • Für stille Aktualisierungsprüfungen, überprüfen Sie @capgo/capacitor-updater ist installiert und autoUpdater ist aktiviert.

Vollständige Referenz

Weitermachen von @capgo/capacitor-Benachrichtigungen

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen verwenden Verwenden Sie @capgo/capacitor-Benachrichtigungen Um native Push-Benachrichtigungen zu planen, verbinden Sie sie mit @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen @capgo/capacitor-notifications Fehlersuche für das Fehlersuchen @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Updater @capgo/capacitor-updater __CAPGO_KEEP_0__ Plugin-Verzeichnis Capgo Plugin Directory @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-Benachrichtigungen