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. Todo lo demás depende de que cuatro cosas estén bien: el SDK está instalado, se inicia cuando se inicia la app, cada dispositivo está vinculado a un usuario y las personas pueden controlar lo que reciben.

Instalar con el plugin de Expo \

El onesignal-expo-plugin configura los proyectos nativos de iOS y Android en el momento de la compilación. Añade la capacidad de push, el App Group y la Notification Service Extension que OneSignal necesita para imágenes, insignias y confirmación de entrega.
app.json

Inicializar una vez, en la raíz \

Clean Beans inicializa OneSignal en su layout raíz, de modo que se ejecuta una vez en cada inicio antes de que aparezca ninguna pantalla.
app/_layout.tsx
Pedir permiso en el primer inicio es el enfoque más sencillo. Para explicar antes la ventaja, muestra un mensaje in-app antes del aviso del sistema. Clean Beans tiene uno listo: consulta Aviso previo de permiso de push.

Vincular cada dispositivo a un usuario \

Cuando alguien inicia sesión, la app pasa su ID de usuario de Supabase a OneSignal.login(). Ese ID se convierte en el External ID. Cuando cierra sesión, logout() desvincula el dispositivo para que la siguiente persona que inicie sesión no herede sus mensajes.
app/_layout.tsx
Espera a que se cargue la sesión guardada antes de llamar a cualquiera de los dos métodos. En un arranque en frío, el usuario que ha iniciado sesión es desconocido durante un momento. Si la app llama a logout() en ese momento y a login() un instante después, la suscripción push del dispositivo puede quedar en un usuario anónimo, y los push dirigidos al External ID dejan de llegar al teléfono. Llama a logout() solo cuando alguien cierre sesión de verdad.
Esta única llamada es lo que hace posible cada envío desde el backend en esta guía. Una función que conoce el ID de base de datos de un usuario puede enviarle mensajes sin saber nada de sus dispositivos.

Añadir el canal de email \

La app ya conoce la dirección de email de cada usuario desde el registro, así que la registra como suscripción de email al iniciar sesión. OneSignal ignora las llamadas repetidas con la misma dirección.
src/lib/onesignalSync.ts
El SMS se añade de la misma forma con addSms(), pero solo después de verificar el número. Consulta SMS: códigos de verificación e invitaciones.

Permitir que las personas controlen lo que reciben \

La pantalla de ajustes de notificaciones tiene un interruptor principal y un interruptor por cada tipo de mensaje.
La pantalla de ajustes de notificaciones con un interruptor principal e interruptores por tipo

Ajustes de notificaciones: un interruptor principal, interruptores por tipo y la hora del recordatorio diario.

El interruptor principal llama a optOut() y optIn() en la suscripción push, de modo que OneSignal detiene y reanuda la entrega a ese dispositivo.
app/notification-settings.tsx
Cada interruptor también se guarda en la fila del perfil del usuario. El backend lee estas columnas antes de enviar nada, y así se aplican las preferencias por tipo.
src/lib/database.ts
Guardar las preferencias en tu propia base de datos y comprobarlas antes de cada envío mantiene la lógica en un solo lugar. La alternativa es guardarlas como etiquetas y filtrar por etiqueta en OneSignal. Eso funciona bien cuando envías a segmentos. Clean Beans envía a usuarios concretos, así que comprobar la base de datos es más sencillo.

Referencia del SDK móvil

Todos los métodos de cliente usados en esta guía.

Usuarios y External IDs

Cómo la identidad vincula las suscripciones entre canales y dispositivos.