Enviar notificaciones push nativas de iOS y Android desde capgo con búsqueda de usuarios, insignias, seguimiento de apertura/abertura, llamadas de fondo y comprobaciones silenciosas de actualizaciones en vivo de capacitor.

El plugin está diseñado para el pipeline de notificaciones de Capgo. Capgo almacena metadatos de credenciales de plataforma y datos de control de campaña en Postgres, mientras que el estado activo de dispositivos y eventos de entrega se escriben en __CAPGO_KEEP_2__ Analytics Engine.

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.

Utilice el __CAPGO_KEEP_0 CAPGO_KEEP_1__ para una configuración guiada:

Use the Capgo CLI for a guided setup:

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

Configurar

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

Ver Documentación de __CAPGO_KEEP_0__

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

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

Registra a un usuario firmado

Mintear identityProof desde tu backend con POST /notifications/recipients/proof, luego registra el dispositivo después de que tu inicio de sesión tenga éxito.

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

Escucha Eventos

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

Configuración de iOS

Habilitar Notificaciones de Pulsación y Modos de fondo > Notificaciones remotas en Xcode.

Reenvía notificaciones remotas desde 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)
}

Configuración de Android

Ejecutar npx cap sync androidConfigure las credenciales de la plataforma de Android en Capgo, solicite la autorización de notificaciones en Android 13+ y pruebe en un dispositivo o emulador con servicios de Google Play.

Lista de Verificación de Depuración

Ejecutar npx @capgo/cli@latest notifications setup com.example.app desde la carpeta que contiene capacitor.config.*.
Buscar al destinatario en Capgo por ID de cliente externo.
Confirmar que el dispositivo tiene plataforma android o ios y se le ha concedido permiso.
Agregar oyentes temporales para registrationChanged, notificationReceived, notificationOpenedy backgroundNotification.
Enviar una notificación de prueba desde la consola.
Ver estadísticas para eventos programados, enviados, recibidos y abiertos.
Para verificaciones de actualizaciones silenciosas, verifique que @capgo/capacitor-updater está instalado y autoUpdater está habilitado.

Referencia completa

Documentación: /docs/plugins/notifications/
Depuración: /docs/plugins/notifications/debugging/
Fuente: https://github.com/Cap-go/capgo/tree/main/packages/capacitor-notifications/

Sigue adelante desde Using @capgo/capacitor-notifications

Si estás utilizando Usando @capgo/capacitor-notifications para planificar mensajería de empuje nativa, conecte con @capgo/capacitor-notifications para los detalles de implementación, Depuración para el seguimiento de errores, @capgo/capacitor-updater para verificaciones de actualizaciones silenciosas, y Capgo Directorio de Plugins para otros plugins nativos.

Notificaciones

Tutoriales sobre Notificaciones