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

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__ Motor de Análisis.

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 la Solución

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

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

Registra a un usuario firmado

Mint 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

Habilita Notificaciones de Pila contexto: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de IU corta o elemento de navegación. Clave de mensaje `push_notifications` (Notificaciones de Pila). y contexto: Página/área: Sitio web de marketing de Capgo. Rol: Etiqueta de IU corta o elemento de navegación. Visto en: página trust.astro. Clave de mensaje `and` (Y).

Modos de fondo > Notificaciones remotas en Xcode. 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 androidConfigura las credenciales de la plataforma de Android en Capgo, solicita permiso de notificación en Android 13+ y prueba 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 de control.
Ver estadísticas para eventos programados, enviados, recibidos y abiertos.
Para verificaciones de actualizaciones silenciosas, verifica 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