Usando @capgo/capacitor-notificaciones

Envía notificaciones push nativas de iOS y Android desde Capgo con búsqueda de usuarios, etiquetas, seguimiento de antecedentes/abiertos, llamadas de fondo y verificaciones silenciosas de actualizaciones en vivo 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 Cloudflare Analytics Engine.

Instalar

Este paquete se encuentra actualmente en vista previa privada. Capgo debe habilitar el acceso al paquete para su cuenta npm antes de que la instalación funcione.

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

Configuración

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

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

Registrar a un usuario firmado

Mintear identityProof desde tu backend con POST /notifications/recipients/proof, luego regístrate al 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,
})

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

Configuración de iOS

Habilitar Notificaciones push y Modos de fondo > Notificaciones remotas en Xcode.

Enviar notificaciones remotos 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, configure las credenciales de la plataforma de Android en Capgo, solicite permiso de notificación 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.*.
Búsqueda del destinatario en Capgo por ID de cliente externo.
Confirmar que el dispositivo tiene plataforma android o ios y el permiso está concedido.
Agregar oyentes temporales para registrationChanged, notificationReceived, notificationOpenedy 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/packages/capacitor-notifications/

Sigue adelante desde Using @capgo/capacitor-notifications

Si estás utilizando Usando @capgo/capacitor-notifications para planificar mensajería de notificación nativa, conecta con @capgo/capacitor-notifications para los detalles de implementación, Depuración para la depuración, @capgo/capacitor-updater para verificaciones de actualizaciones silenciosas, y Capgo Directorio de plugins nativos para otros plugins nativos.

Notificaciones

Tutorial sobre Notificaciones