Saltar al contenido principal
La mayoría de las guías de OneSignal explican una función a la vez. Esta sigue una sola app de principio a fin y muestra cómo se conectó cada función de mensajería, con el código que se ejecuta en producción. La app es Clean Beans, un turno de limpieza para hogares compartidos. Está creada con Expo (React Native) y usa Supabase para su base de datos, autenticación y funciones de backend. OneSignal gestiona todos los mensajes que envía la app.
Tres pantallas de Clean Beans: el panel, una sesión de limpieza y el turno semanal

Clean Beans: el panel, una sesión de limpieza y el turno semanal.

Qué hace Clean Beans \

Un hogar añade sus habitaciones y la app las convierte en una lista de tareas de limpieza con frecuencias razonables. Un generador de turnos reparte esas tareas a lo largo de la semana para ajustarse al tiempo disponible de cada persona. Los miembros realizan sesiones de limpieza, marcan tareas, acumulan rachas diarias, se envían kudos y compiten en una clasificación semanal. La limpieza es compartida, recurrente y con plazos, lo que la hace ideal para casi cualquier tipo de mensaje: recordatorios, novedades sociales, cuentas atrás, resúmenes y orientación.

Por qué existe esta guía \

Úsala para responder tres preguntas:
  • ¿Qué función de OneSignal encaja con cada tarea? Cada página parte de algo que la app necesitaba hacer y luego muestra la función que lo hace.
  • ¿Dónde va el código? Parte del trabajo corresponde a la app, parte a tu backend y parte al panel de OneSignal. Cada ejemplo indica cuál.
  • ¿Qué sale mal? Las advertencias y notas de cada página recogen lo que se aprendió al publicarlo. Un ajuste, collapse_id, se probó y luego se eliminó, y Push fiable y bien comportado explica por qué.

Cómo leerla \

La guía es un conjunto de páginas, una por tema. No necesitas leerlas en orden. Configuración del SDK e identidad del usuario es la base de todo lo demás. Después, cada página es independiente. La mayoría de las funciones se presentan de la misma manera:
  1. Lo que ve el usuario, normalmente con una captura de pantalla.
  2. Cómo funciona, como una breve secuencia de quién hace qué.
  3. El código, tomado de la app. El título de cada bloque de código es el archivo del que procede.
  4. Configuración del panel, cuando la función necesita configurarse en OneSignal.
Los límites y las sorpresas se señalan en advertencias y notas junto a la función a la que afectan.
El código es real, pero los identificadores se sustituyen por marcadores de posición como YOUR_ONESIGNAL_APP_ID y YOUR_PROJECT_REF. Los archivos largos se recortan a las líneas importantes. Una línea que solo contiene // ... marca dónde se omitió código.

Cómo encajan las piezas \

El External ID conecta los tres. Clean Beans lo establece con el ID de usuario de Supabase al iniciar sesión, de modo que el backend puede dirigirse a cualquier persona con un ID que ya almacena.
Diagrama de arquitectura con la app de Expo, el backend de Supabase y el panel de OneSignal

La app, el backend y el panel se comunican con OneSignal. El External ID los vincula a un mismo usuario.

Mapa de funciones \

Qué necesitas \

  • Una app de OneSignal con push configurado para iOS y Android, y con email y SMS configurados. Consulta Configuración de canales.
  • Una app de Expo compilada con EAS Build. El SDK de OneSignal necesita código nativo, así que Expo Go no es suficiente. Consulta Configuración del SDK de Expo.
  • Tu App ID y una App API key. Consulta Claves e IDs.
  • Un backend que pueda ejecutar código de forma programada y en respuesta a solicitudes. Clean Beans usa Supabase Edge Functions con pg_cron. Los mismos patrones se aplican a cualquier backend.

Principios que funcionaron \

  • Establece primero el External ID. Casi todas las funciones de esta guía dependen de él. Usa un ID que tu backend ya almacene.
  • Pon cada tarea donde corresponde. La app gestiona el dispositivo y el usuario que ha iniciado sesión. El backend gestiona las programaciones y los cambios de datos. El panel contiene todo lo que quieras cambiar sin una nueva versión.
  • Comprueba antes de enviar. Cada envío del backend comprueba las preferencias del usuario y confirma que hay algo que merezca la pena decir.
  • Haz que los envíos programados sean repetibles. Una clave de idempotencia construida a partir del tipo, el destinatario y la fecha convierte un reintento en una operación sin efecto.
  • Enruta por tipo, no por URL. Un campo data.type mantiene funcionando las notificaciones antiguas cuando cambian las pantallas.
  • Verifica lo que te dicen quienes llaman. Una función que envía mensajes debe confirmar primero los datos en tu propia base de datos.

Todas las funciones de un vistazo \

Secretos \

Las funciones del backend los leen de su entorno. Ninguno se incluye nunca en la app.
Tu App API key puede enviar mensajes a todos los usuarios. Mantenla en tu backend. La app solo necesita el App ID.