@capgo/capacitor-notificaciones

Resumen

@capgo/capacitor-notifications conecta una aplicación Capacitor a la canalización 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 de actualización silenciosa Capgo en vivo desde la consola de Capgo o API.

Esta 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 de forma solo de lectura.

¿Qué almacena Capgo?

Datos	¿Dónde viven?	¿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.
Bocetos de campaña y ajustes	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 sin cambios.
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 un token de vida corta 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 de fondo 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.
• Desencadene @capgo/capacitor-updater desde una notificación silenciosa.

Sección titulada “Estadísticas”

Capgo writes notification events to Cloudflare Analytics Engine so dashboard stats stay cheap:

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

Publico API

Método	Descripción
configure	Establece el ID de 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	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')	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 puede ser reintentada, y un dispositivo puede recibir una copia duplicada si la plataforma acepta un mensaje repetido. Utilice IDs de colapso para las 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 operativo 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.

Seguir 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 solucionar problemas @capgo/capacitor-actualizador para verificaciones de actualizaciones silenciosas, 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"}]}