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.appdesde el folder que contienecapacitor.config.*. - Busca al destinatario en Capgo por ID de cliente externo.
- Confirma que el dispositivo tiene plataforma
androidoiosy se le ha concedido permiso. - Agregar oyentes temporales para
registrationChanged,notificationReceived,notificationOpened, ybackgroundNotification. - 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-updaterestá instalado yautoUpdaterestá 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 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.