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. La mayoría de las notificaciones de Clean Beans las envía el backend, porque dependen de una programación o de algo que ha hecho otra persona. Todas llaman al mismo endpoint, Create message, y se dirigen a las personas por External ID.
Notificaciones push de Clean Beans

Un ejemplo de algunos de los push que envía Clean Beans.

Envíos programados que respetan las zonas horarias \

Las personas eligen la hora a la que quieren su recordatorio diario. Clean Beans no programa un trabajo por usuario. Ejecuta un trabajo cada hora y se pregunta: “¿para quién es esa hora ahora mismo?”
1

Una programación de la base de datos llama a una función cada hora

pg_cron hace una solicitud HTTP a una Supabase Edge Function. La clave de servicio que necesita se lee de Supabase Vault, así que nunca aparece en el SQL.
2

La función busca a los usuarios cuya hora local coincide

Carga a todas las personas que tienen ese recordatorio activado, convierte la hora actual a la zona horaria de cada usuario y se queda con aquellos cuya hora elegida es ahora.
3

Comprueba que hay algo que decir

Un usuario sin nada pendiente no recibe ningún push.
4

Llama a OneSignal una vez por usuario

Cada push tiene su propio contenido, así que cada uno es una solicitud independiente.
La programación:
supabase/migrations/006_cron_daily_digest.sql
La coincidencia de zona horaria:
supabase/functions/send-daily-digest/index.ts
El envío:
supabase/functions/send-daily-digest/index.ts
Los campos ...DELIVERY.daily_digest, idempotency_key y de insignia se explican en Push fiable y bien comportado. El campo data.type es la forma en que la app sabe qué pantalla abrir cuando se toca el push. Consulta Deep links y clics en notificaciones. El título y el cuerpo se construyen a partir de las tareas, así que el push dice algo concreto.
supabase/functions/send-daily-digest/index.ts

El recordatorio de tareas vencidas: un segundo aviso, diferente \

El recordatorio de tareas vencidas reutiliza el mismo patrón con dos cambios. Se dispara seis horas después de la hora del resumen del usuario y solo cuenta las tareas que están realmente vencidas.
supabase/functions/send-overdue-reminders/index.ts
Su trabajo se ejecuta a la media hora, así que nunca compite con el trabajo del resumen al inicio de la hora. El texto también es diferente. Un segundo recordatorio que repite el primero es fácil de ignorar.
supabase/functions/send-overdue-reminders/index.ts

El recordatorio de limpieza: una solicitud para muchas personas \

El recordatorio de limpieza dice lo mismo a todo el mundo, así que no necesita una solicitud por persona. La función recopila todos los IDs de usuario que cumplen los requisitos y los envía en lotes.
supabase/functions/send-cleaning-reminder/index.ts
Envía una solicitud por persona cuando el contenido sea diferente. Envía una solicitud para muchas personas cuando sea idéntico. Menos solicitudes significan menos cosas que pueden fallar y menos riesgo de superar los límites de frecuencia.

Sesión completada: un push disparado desde la app \

Cuando alguien termina una sesión de limpieza, el resto del hogar se entera. La app no puede enviar ese push por sí misma, porque no debe contener una API key. Llama a una función del backend y la función envía el push.
src/lib/database.ts
La solicitud dice qué se ha limpiado, pero no quién lo ha limpiado. La función obtiene quién llama a partir de su token de inicio de sesión, comprueba que es un miembro activo del hogar y toma su nombre y su avatar de su perfil. Consulta Comprobar quién llama. Después busca a los demás miembros del hogar y elimina a quien tenga desactivado este tipo de push.
supabase/functions/session-completed/index.ts
Envía un único push a todos ellos. El avatar de judía de quien lo envía se adjunta como imagen, usando un campo distinto para cada plataforma.
supabase/functions/session-completed/index.ts
Una notificación push expandida que muestra una imagen de avatar de judía

Un push de sesión completada, expandido para mostrar el avatar de quien lo envía.

Kudos: de una persona a otra \

Los kudos funcionan igual, con un solo destinatario. En la pantalla de actividad, un miembro toca Send Kudos en la sesión de un compañero de casa, elige un mensaje y la app llama a la función send-kudos.
La hoja inferior de kudos con mensajes predefinidos

Elegir un mensaje de kudos para la sesión de limpieza de un compañero de casa.

supabase/functions/send-kudos/index.ts

Unión aprobada: un push disparado por la base de datos \

Quien pide unirse a un hogar espera a que un administrador lo apruebe. Cuando eso ocurre, su fila de membresía cambia de pending a active. Un disparador de base de datos sobre ese cambio llama a una función, y la función le avisa de que ya forma parte del hogar. Poner el disparador en la base de datos significa que el push se envía sea cual sea la forma en que se produce la aprobación, y la app no necesita código para ello.
supabase/migrations/027_join_approved_trigger.sql
La función no se fía de lo que le dicen. Vuelve a leer la membresía y solo envía si la aprobación es real y reciente.
supabase/functions/join-approved/index.ts
Una función que envía mensajes bajo petición es algo que otras personas pueden intentar llamar. Comprueba los datos en tu propia base de datos antes de enviar, como hace esta, y nunca aceptes contenido de mensajes ni destinatarios de alguien que llama y que no has verificado.

Comprobar quién llama \

Supabase verifica que una solicitud a una edge function lleve un token válido, pero el token de un usuario que ha iniciado sesión es tan válido como el del programador de tareas. Sin una comprobación adicional, cualquier usuario podría disparar el resumen diario para todo el mundo o enviar un push en nombre de otra persona. Por eso cada función decide por sí misma quién puede llamarla. Las funciones programadas empiezan con una línea:
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
La comprobación del rol depende de que Supabase ya haya verificado la firma del token. Despliega estas funciones con la verificación de JWT activada, que es la opción predeterminada. Nunca las despliegues con --no-verify-jwt.
Las funciones llamadas desde la app identifican al remitente a partir del token y luego comprueban que el remitente puede llegar al destinatario. Los kudos solo pueden ir a alguien que comparte hogar con el remitente, y el nombre que aparece en el push se lee del perfil del remitente.
supabase/functions/send-kudos/index.ts

API de creación de mensajes

Segmentación, contenido y programación para todos los canales.

Rich media

Imágenes en notificaciones push en cada plataforma.