@capgo/capacitor-notificaciones

Resumen

@capgo/capacitor-notifications conecta una aplicación Capacitor a la pila de notificaciones nativa 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 Cloudflare, y puede enviar notificaciones, establecer insignias, inspeccionar estadísticas de entrega y desencadenar comprobaciones silenciosas de actualización 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. El estado de dispositivo activo y los eventos de notificación son filas de Motor de Análisis que se agregan solo.

¿Qué almacena Capgo?

Datos	¿Dónde vive?	¿Por qué?
Metadatos de credenciales de plataforma	Capgo Postgres	Necesario para gestionar la configuración y permisos de la aplicación.
Secretos de plataforma privados	Entorno de trabajador	Evita almacenar credenciales de acceso privado en tablas de clientes.
Diseños y configuraciones de campaña	Capgo Postgres	Datos de control de plano de baja cardinalidad.
Estado de registro de dispositivo activo	Cloudflare Motor de Análisis	Registro de dispositivo activo a bajo costo y de solo anexión.
Eventos de notificación	Cloudflare Motor de Análisis	Estadísticas a bajo costo para eventos programados, enviados, recibidos, abiertos, fallidos y de fondo.

Modelo de Identidad

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

• Su backend conoce el ID de usuario de cliente real.
• Su backend le pide a Capgo una autorización temporal identityProof.
• El registro de la aplicación con externalId y esa prueba después de que su autenticación de usuario propia tenga éxito.
• Capgo deriva claves internas determinísticas para el destinatario y la instalación nativa.
• Enviar a los mismos externalId encuentra los dispositivos activos del usuario de nuevo.

Esto le permite buscar los dispositivos de un 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 ID de usuario externo autenticado.
• Refresque etiquetas, atributos, consentimiento y estado de token al iniciar la aplicación o cambios de token.
• Reciba notificaciones en primer plano en JavaScript.
• Registre eventos de notificaciones recibidas y abiertas.
• Gestione notificaciones de datos de fondo.
• Establezca, elimine y incremente las pestañas de la aplicación.
• Crear canales de notificación de Android.
• Envíe notificaciones de un solo uso, notificaciones de campaña, actualizaciones de pestañas y comprobaciones de actualizaciones silenciosas.
• Desencadé @capgo/capacitor-updater desde una notificación silenciosa.

Estadísticas

Capgo escribe eventos de notificaciones en Cloudflare Motor de Análisis para que las estadísticas de la consola sean baratas:

• 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 actualizar la inscripción periódicamente.

Publico API

Método	Descripción
configure	Establece la ID de aplicación Capgo, el API host y el comportamiento de integración del actualizador.
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	Borra la notificación de la aplicación nativa.
incrementBadge	Incrementa la notificación de la aplicación nativa.
enableUpdaterIntegration	Activa el manejo silencioso de la verificación de actualizaciones a través de @capgo/capacitor-updater.
runUpdateCheck	Ejecuta la integración de actualizador manualmente para fines de prueba.
trackReceived	Escribe manualmente un evento recibido.
trackOpened	Escribe manualmente un evento abierto.
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 una copia duplicada si el plataforma acepta un mensaje repetido. Utilice IDs de colapso para verificaciones 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 según la batería, el comportamiento del usuario, el estado de fuerza-quit y la política del sistema. No confíe en las notificaciones silenciosas para plazos fijos.

Sigue adelante desde @capgo/capacitor-notificaciones

Si estás utilizando @capgo/capacitor-notificaciones para planificar mensajería push, conecta con Configuración inicial para la configuración para depuración para la depuración @capgo/capacitor-actualizador para verificaciones silenciosas de actualizaciones, y Directorio del plugin Capgo {"targetLanguage":"Spanish","pagePath":"/es/docs/plugins/notifications/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"para otros plugins nativos."},{"text":"Editar página"}]}