@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 la aplicación, metadatos de credenciales de plataforma, borradores de campañas, horarios y registros de campañas agregados.

¿Qué almacena Capgo?

Datos	¿Dónde viven?	¿Por qué
Metadata de credenciales de plataforma	Capgo Postgres	Needed to manage app setup and permissions.
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 plan de baja cardinalidad.
Estado de registro de dispositivo activo	Cloudflare Motor de análisis	Registro de dispositivos de escritura única asequible.
Eventos de notificación	Motor de análisis Cloudflare	Estadísticas asequibles para eventos programados, 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 del cliente real.
• Su backend solicita Capgo para una sesión temporal. identityProof.
• La aplicación se registra con externalId y esa prueba después de que tu autenticación de usuario tenga éxito.
• Capgo deriva claves internas determinísticas para el destinatario y la instalación nativa.
• Enviando a la misma externalId vuelve a encontrar los dispositivos activos del usuario.

Este te permite buscar dispositivos de un usuario, establecer badges y dirigir campañas de notificaciones sin almacenar filas de notificaciones por dispositivo en Capgo Postgres.

Capacidades básicas

• Registra dispositivos con un ID de usuario externo autenticado.
• Refresca etiquetas, atributos, consentimiento y estado de token en inicio de aplicación o cambios de token.
• Recibe notificaciones de fondo en JavaScript.
• Registra eventos de notificaciones recibidas y abiertas.
• Administra notificaciones de datos de fondo.
• Establece, elimina y incrementa badges de aplicación.
• Crear canales de notificaciones de Android.
• Envía notificaciones ocasionales, notificaciones de campaña, actualizaciones de pestañas y comprobaciones de actualizaciones silenciosas.
• Trigger @capgo/capacitor-updater desde una notificación silenciosa.

Estadísticas

Capgo escribe eventos de notificaciones a Cloudflare Motor de Análisis para mantener estadísticas de la consola asequibles.

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

Señales de estado están operativas, no un registro permanente por destinatario. El motor de análisis retiene los dispositivos activos, que deben refrescar la inscripción periódicamente.

Public API

Método	Descripción
configure	Sets the Capgo app ID, API host, and updater integration behavior.
register	Registra la instalación actual para un ID de usuario de cliente externo.
setExternalId	Cambia el ID de usuario 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	Borra la notificación de la aplicación nativa.
incrementBadge	Aumenta la notificación de la aplicación nativa.
enableUpdaterIntegration	Enables silent update-check handling through @capgo/capacitor-updater.
runUpdateCheck	Ejecuta la integración de actualizador manualmente para pruebas.
trackReceived	Escribe manualmente un evento recibido.
trackOpened	Escribe manualmente un evento de apertura.
addListener('notificationReceived')	Dispara cuando se recibe una notificación mientras JavaScript está activo.
addListener('notificationOpened')	Dispara cuando un usuario abre una notificación.
addListener('backgroundNotification')	Dispara para notificaciones de datos de fondo y expone finish().
addListener('registrationChanged')	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 se puede volver a intentar, y un dispositivo puede recibir un duplicado si el 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 puede ralentizar o saltar la ejecución de fondo en función de la batería, el comportamiento del usuario, el estado de fuerza-quit 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 de empuje, conecta con Getting Started for setup, Depuración para la depuración, @capgo/capacitor-actualizador para verificaciones de actualizaciones silenciosas, y Directorio de Plugins Capgo __CAPGO_KEEP_0__ Directorio de plugins