Pulsa para ir al contenido principal
Volver a plugins
@capgo/capacitor-notificaciones
Tutorial
@capgo/capacitor-notificaciones

Notificaciones

Envía notificaciones push nativas de iOS y Android desde Capgo con búsqueda de usuarios, insignias, estadísticas y comprobaciones de actualizaciones silenciosas

Guía

Tutoriales sobre Notificaciones

Usando @capgo/capacitor-notificaciones

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

Instalar

Utilice el Capgo CLI para un setup guiado:

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

Crear identityProof desde su servidor con POST /notifications/recipients/proof, luego 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()
  }
})

Configuración de iOS

Habilitar Notificaciones push y 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 androidEjecuta, configura 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 el folder que contiene capacitor.config.*.
  • Busca al destinatario en Capgo por ID de cliente externo.
  • Confirma que el dispositivo tiene plataforma android o ios y se le ha concedido 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

Continúa desde Notificaciones @capgo/capacitor

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