Saltar al contenido principal
Esta página forma parte de App de ejemplo: una integración completa de OneSignal, que sigue una app real de principio a fin. La app es Clean Beans, un turno de limpieza para hogares compartidos, creada con Expo (React Native) y un backend de Supabase. Conseguir que llegue un push es el primer paso. Esta página trata las decisiones más pequeñas que hacen que los push sean de confianza: no enviar nunca el mismo dos veces, dejar que caduquen los que ya no sirven y hacer que cada tipo se comporte de la forma que le corresponde.

No enviar nunca el mismo recordatorio dos veces \

Los trabajos programados se reintentan. Un trabajo también puede ejecutarse dos veces por error. Sin protección, cada repetición envía otro push. El idempotency_key de OneSignal resuelve esto. Si dos solicitudes llevan la misma clave, la segunda no se envía. La clave debe ser un UUID, y OneSignal la recuerda durante 30 días. Una función programada no tiene dónde guardar una clave aleatoria entre ejecuciones, así que Clean Beans deriva la clave de lo que es el envío: su tipo, su destinatario y su fecha. El mismo envío produce siempre la misma clave.
supabase/functions/_shared/idempotency.ts
En un envío por lotes, la clave cubre todo el lote.
supabase/functions/send-cleaning-reminder/index.ts
Las claves de idempotencia funcionan en los endpoints Create message y Create custom events. Las solicitudes de Live Activity no las aceptan. Estas se identifican por su activity_id.

Dar a cada tipo de push su propio comportamiento \

Un recordatorio de limpieza que llega con dos horas de retraso es peor que no recibir ninguno. Los kudos son agradables de recibir, pero nunca urgentes. Clean Beans describe estas diferencias una sola vez, en un conjunto de perfiles de entrega, y aplica el adecuado a cada solicitud.
supabase/functions/_shared/delivery.ts
El perfil member_lapsed de la lista de tipos corresponde a un push enviado desde un webhook de Journey, que esta guía no trata. Qué hace cada ajuste:
  • ttl es el tiempo que se conserva un push para un dispositivo sin conexión. El recordatorio de limpieza dice “en 1 hora”, así que se descarta pasada una hora.
  • thread_id y android_group agrupan los push relacionados en la lista de notificaciones.
  • ios_interruption_level controla lo insistente que es un push. time_sensitive puede atravesar los modos de concentración. passive llega en silencio.
  • ios_relevance_score ordena los push en el resumen de notificaciones de iOS. Clean Beans reserva 1.0 para los mensajes críticos y no envía ninguno.
Configuración de la app. iOS solo respeta time_sensitive si la app declara la capacidad.
app.json
Una lección aprendida: collapse_id. Al principio, Clean Beans dio al resumen y al recordatorio de tareas vencidas el mismo collapse_id, para que el recordatorio sustituyera al resumen. En iOS, un push que sustituye a otro que sigue en la lista de notificaciones se reemplaza en su sitio, sin banner y sin sonido. El recordatorio pasaba desapercibido, lo que anulaba su propósito, así que se eliminó el ajuste. Usa collapse_id solo cuando quieras una actualización silenciosa, como un marcador en directo.

Mostrar un número en el icono de la app \

Los dos push de tareas establecen la insignia del icono de la app con el número de su título.
supabase/functions/send-overdue-reminders/index.ts
El icono de la app Clean Beans con un número en la insignia

La insignia del icono de la app muestra cuántas tareas están vencidas.

Se usa SetTo, no Increase, porque la insignia es un recuento de tareas y no de notificaciones sin leer. El recordatorio de la tarde sustituye el número de la mañana.
El SDK de OneSignal borra la insignia automáticamente cada vez que se abre la app, así que la app no necesita código para restablecerla. Un push que llega mientras la app está abierta nunca muestra su insignia. Android no tiene una insignia numérica que se pueda establecer mediante la API.

Solicitudes idempotentes

Cómo funcionan las claves y cuánto duran.

Niveles de interrupción

Los modos de concentración y los cuatro niveles.

Insignias

Comportamiento de las insignias en cada plataforma.