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

Benachrichtigungen

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

Anleitung

Tutorial zu Benachrichtigungen

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

Mit Capgo native iOS- und Android-Benachrichtigungen senden, einschließlich Benutzerlookup, Badges, Vordergrund-/Offen-Tracking, Hintergrundaufrufe und stille Capgo Live-Update-Überprüfungen

Das Plugin ist für den Capgo-Benachrichtigungs-Pipeline entwickelt. Capgo speichert Plattform-Zugriffsmetadaten und Kampagnensteuerungsdaten in Postgres, während aktive Gerätestatus und Lieferungsereignisse in Cloudflare Analytics Engine geschrieben werden

Installieren

Verwenden Sie den Capgo CLI für eine geführte Einrichtung:

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',
})

Registrieren Sie einen signierten Benutzer

Mint identityProof aus 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,
})

Hören Sie auf Ereignisse

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

Enable Push-Benachrichtigungen und Hintergrundmodi > Remote-Benachrichtigungen in Xcode.

Senden Sie Remote-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 androidKonfigurieren Sie die Android-Plattformkredenziale in Capgo, fordern Sie die Benachrichtigungsrechte auf Android 13+ an und testen Sie auf einem Gerät oder einem Emulator mit Google Play-Diensten.

Fehlersuche-Checkliste

  • Ausführen npx @capgo/cli@latest notifications setup com.example.app aus dem Ordner, der 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 Bestätigen Sie, dass die Berechtigung erteilt wurde.
  • Hinzufügen Sie temporäre Listener für registrationChanged, notificationReceived, notificationOpenedund backgroundNotification.
  • Ein Testbenachrichtigung von der Dashboard senden.
  • Überprüfen Sie die Statistiken für die angesammelten, gesendeten, empfangenen und geöffneten Ereignisse.
  • Für stumme Aktualisierungsprüfungen, überprüfen Sie @capgo/capacitor-updater ob autoUpdater installiert ist und

aktiviert ist.

https://capgo.com/Cap-go/capacitor/tree/main/packages/__CAPGO_KEEP_2__-notifications/

Fortsetzen Sie mit der Verwendung von @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-notifications. Wenn Sie die Benachrichtigung verwenden Mit @capgo/capacitor-Benachrichtigungen um native Push-Nachrichten zu planen, verbinden Sie es mit @capgo/capacitor-Benachrichtigungen für die Implementierungsdetails Fehlersuche für die Fehlerbehebung @capgo/capacitor-Updater für stille Aktualisierungsprüfungen und Capgo-Plugin-Verzeichnis für andere native Plugins.