@capgo/capacitor-notificaciones

Resumen

@capgo/capacitor-notifications conecta una aplicación Capacitor a la canalización de notificaciones nativas de Capgo. Su aplicación registra un ID de usuario cliente firmado con Capgo, Capgo mantiene el estado de dispositivo activo más reciente en el Motor de Análisis de Cloudflare, y puede enviar notificaciones, establecer insignias, inspeccionar estadísticas de entrega y desencadenar comprobaciones silenciosas de actualizaciones en vivo con Capgo desde la consola de Capgo o API.

La característica está diseñada para evitar una tabla de dispositivos de notificación de alta cardinalidad en Capgo Postgres. Postgres almacena solo datos de control de plano de baja cardinalidad, como ajustes de aplicación, metadatos de credenciales de plataforma, borradores de campaña, horarios y registros de campaña agregados.

¿Qué almacena Capgo?

Datos	¿Dónde vive?	¿Por qué?
Metadatos de credenciales de plataforma	Capgo Postgres	Se necesita para gestionar la configuración y permisos de la aplicación.
Secretos de plataforma privados	Entorno de trabajador	Evita almacenar credenciales privadas en tablas de cliente.
Bocetos de campaña y ajustes	Capgo Postgres	Datos de control plane de baja cardinalidad.
Estado de registro de dispositivo activo	Cloudflare Motor de Análisis	Registro de dispositivo activo a bajo costo sin cambios.
Eventos de notificación	Cloudflare Motor de Análisis	Estadísticas baratas para eventos en cola, enviados, recibidos, abiertos, fallidos y de fondo.

Modelo de Identidad

Capgo no le pide que suba una lista de usuarios ni mantenga una tabla de dispositivos.

• Su backend conoce el ID de usuario de cliente real.
• Su backend le pide a Capgo un token de corta duración. identityProof.
• The app se registra con externalId y esa prueba después de que la autenticación del usuario propio tiene éxito.
• Capgo deriva claves internas determinísticas para el destinatario y la instalación nativa.
• Enviar a la misma externalId encuentra los dispositivos activos del usuario de nuevo.

Esto te permite buscar los dispositivos del usuario, establecer insignias y dirigir campañas de notificaciones sin almacenar filas de notificaciones por dispositivo en Capgo Postgres.

Capacidades básicas

• Registra dispositivos con un usuario externo autenticado.
• Refresca etiquetas, atributos, consentimiento y estado de token en inicio de aplicación o cambios de token.
• Recibe notificaciones en primer plano en JavaScript.
• Rastrea eventos de notificaciones recibidas y abiertas.
• Administre notificaciones de datos de fondo.
• Establecer, eliminar y actualizar la pestaña de la aplicación.
• Crear canales de notificación de Android.
• Enviar notificaciones de un solo uso, notificaciones de campaña, actualizaciones de la pestaña de la aplicación y comprobaciones de actualizaciones silenciosas.
• Desencadenar @capgo/capacitor-updater desde una notificación silenciosa.

Estadísticas

Capgo escribe eventos de notificación a Cloudflare Motor de Análisis para que las estadísticas de la consola sean económicas:

• queued
• sent
• provider_accepted
• received
• opened
• failed
• permission_changed
• background_started
• background_finished

Las estadísticas son señales de operación, no un registro permanente por destinatario. La retención del Motor de Análisis significa que los dispositivos activos deben refrescar la registro periódicamente.

Público API

Método	Descripción
configure	Establece el ID de la aplicación Capgo, el host API y el comportamiento de integración de actualizaciones.
register	Registra la instalación actual para un ID de usuario de cliente externo.
setExternalId	Cambia el ID de usuario de cliente externo después de iniciar sesión o cambiar de cuenta.
setTags	Sustituye los etiquetas utilizadas para el targeting de audiencia.
setBadge	Establece la notificación de la aplicación nativa.
clearBadge	Elimina la notificación de la aplicación nativa.
incrementBadge	Incrementa la notificación de la aplicación nativa.
enableUpdaterIntegration	Habilita el manejo silencioso de la verificación de actualizaciones a través de @capgo/capacitor-updater.
runUpdateCheck	Ejecuta la integración de actualizaciones manualmente para pruebas.
trackReceived	Escribe manualmente un evento recibido.
trackOpened	Escribe un evento de notificación abierta manualmente.
addListener('notificationReceived')	Se dispara cuando se recibe una notificación mientras JavaScript está activo.
addListener('notificationOpened')	Se dispara cuando un usuario abre una notificación.
addListener('backgroundNotification')	Se dispara para notificaciones de datos de fondo y expone finish().
addListener('registrationChanged')	Se dispara cuando cambia el token de notificación nativa.

Garantías de entrega.

La notificación push nativa es al menos una vez. Una campaña puede ser reintentada, y un dispositivo puede recibir un duplicado si la plataforma acepta un mensaje repetido. Utilice IDs de colapso para comprobaciones de actualizaciones y haga que el trabajo de fondo sea idóneo.

Las notificaciones de fondo de iOS son de mejor esfuerzo. El sistema operativo puede ralentizar o saltar la ejecución de fondo en función de la batería, el comportamiento del usuario, el estado de forzar la cierre y la política del sistema. No confíe en notificaciones silenciosas para plazos fijos.

Sigue adelante desde @capgo/capacitor-notificaciones.

Si estás utilizando @capgo/capacitor-notificaciones para planificar mensajería push, conectarlo con Iniciación para la configuración, Depuración para el seguimiento de errores, @capgo/capacitor-actualizador para verificaciones de actualizaciones silenciosas, y Capgo Directorio de plugins nativos para otros plugins nativos.