Notificaciones plugin de Capacitor

Usando @capgo/capacitor-notifications

Envía notificaciones push nativas para iOS y Android desde Capgo con búsqueda de usuarios, etiquetas, seguimiento de antecedentes y llamadas de fondo, y comprobaciones silenciosas de Capgo.

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

Instalar

Utilice el Capgo CLI para una configuración guiada:

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

Instalación manual:

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

Configurar

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

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

Registrar un usuario firmado

Mintear identityProof desde su servidor con POST /notifications/recipients/proofluego registre el dispositivo después de que su inicio de sesión tenga éxito.

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

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

iOS Setup

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

Enviar 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 android, configura credenciales de plataforma 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 el folder que contiene capacitor.config.*.
• Búsqueda del destinatario en Capgo por ID de cliente externo.
• Confirmar que el dispositivo tiene plataforma android o ios y se le concede permiso.
• Agregar oyentes temporales para registrationChanged, notificationReceived, notificationOpened, y backgroundNotification.
• Enviar una notificación de prueba desde la consola.
• Verificar estadísticas para eventos programados, enviados, recibidos y abiertos.
• Para verificaciones de actualizaciones silenciosas, verificar @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/paquetes/capacitor-notificaciones/

Sigue adelante desde @capgo/capacitor-notifications

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