Notificaciones plugin Capacitor

Uso de @capgo/capacitor-notifications

Envía notificaciones push nativas en iOS y Android desde Capgo con búsqueda de usuarios, badges, seguimiento de foreground/open, callbacks en background y comprobaciones silenciosas de Capgo live-update.

El plugin está pensado para el pipeline de notificaciones de Capgo. Capgo almacena metadatos de credenciales de plataforma y datos de control de campañas en Postgres, mientras que el estado de los dispositivos activos y los eventos de entrega se escriben en Cloudflare Analytics Engine.

Instalar

Usa 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

Generar identityProof desde tu backend con POST /notifications/recipients/proof, luego registra el dispositivo cuando tu propio login sea exitoso.

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

Activar Notificaciones push y Background Modes > Remote notifications en Xcode.

Reenviar 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

Ejecuta npx cap sync android, configura las credenciales de la plataforma Android en Capgo, solicita permiso de notificaciones en Android 13+ y prueba en un dispositivo o emulador con Google Play services.

Checklist de depuración

• Ejecuta npx @capgo/cli@latest notifications setup com.example.app desde la carpeta que contiene capacitor.config.*.
• Busca al destinatario en Capgo por su ID de cliente externo.
• Confirma que el dispositivo tiene android o ios y se ha concedido el permiso.
• Añade listeners temporales para registrationChanged, notificationReceived, notificationOpened, y backgroundNotification.
• Envía una notificación de prueba desde el dashboard.
• Consulta las estadísticas de eventos en cola, enviados, recibidos y abiertos.
• Para comprobaciones de actualización 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/

Continúa desde Uso de @capgo/capacitor-notifications

Si estás usando Uso de @capgo/capacitor-notifications para planificar la mensajería push nativa, conéctala con @capgo/capacitor-notifications para ver los detalles de implementación, Depuración para solucionar problemas, @capgo/capacitor-updater para comprobaciones silenciosas de actualización, y Directorio de plugins de Capgo para otros plugins nativos.