> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# App de ejemplo: configuración del SDK e identidad del usuario

> Cómo la app de ejemplo Clean Beans instala el SDK de OneSignal en Expo, vincula cada dispositivo a un usuario con un External ID y añade el email.

Esta página forma parte de [App de ejemplo: una integración completa de OneSignal](https://documentation.onesignal.com/docs/es/example-full-integration-overview.md), 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.

```json app.json theme={null}
{
  "expo": {
    "plugins": [
      ["onesignal-expo-plugin", { "mode": "production" }],
      "expo-router",
      "./plugins/withLiveActivityWidget"
    ],
    "ios": {
      "bundleIdentifier": "com.onesignal.cleaningapp",
      "infoPlist": {
        "UIBackgroundModes": ["remote-notification"],
        "NSSupportsLiveActivities": true
      },
      "entitlements": {
        "aps-environment": "production",
        "com.apple.security.application-groups": [
          "group.com.onesignal.cleaningapp.onesignal"
        ]
      }
    }
  }
}
```

## 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.

```typescript app/_layout.tsx theme={null}
// Verbose logging is for debugging during the beta. Remove it, or lower
// the level, before a public release.
OneSignal.Debug.setLogLevel(LogLevel.Verbose);
OneSignal.initialize('YOUR_ONESIGNAL_APP_ID');
OneSignal.Notifications.requestPermission(true);
```

> [!TIP]
>
> 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](https://documentation.onesignal.com/docs/es/example-full-integration-in-app-messages.md#push-permission-pre-prompt).

## 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.

```typescript app/_layout.tsx theme={null}
// Link OneSignal identity to authenticated user and sync timezone
//
// Wait until the saved session has been restored. On a cold start `user`
// is null for a moment while it loads; calling logout() then, followed by
// login() a moment later, can leave this device's push subscription on an
// anonymous OneSignal user, so pushes sent to the External ID never reach
// the phone. logout() is only called on a real sign-out.
const wasSignedIn = useRef(false);
useEffect(() => {
  if (loading) return;

  if (user) {
    wasSignedIn.current = true;
    OneSignal.login(user.id);
    syncDeviceTimezone();
    // Add email subscription and sync data tags to OneSignal
    if (user.email) syncOneSignalEmail(user.email);
    // Add the SMS subscription if the user has a verified phone number
    syncOneSignalSms();
    syncOneSignalTags();
  } else if (wasSignedIn.current) {
    wasSignedIn.current = false;
    OneSignal.logout();
  }
}, [user, loading]);
```

> [!WARNING]
>
> 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.

```typescript src/lib/onesignalSync.ts theme={null}
export function syncOneSignalEmail(email: string): void {
  try {
    if (!email) return;
    OneSignal.User.addEmail(email);
    console.log('[onesignalSync] Email subscription added');
  } catch (e) {
    console.warn('[onesignalSync] syncOneSignalEmail error:', e);
  }
}
```

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](https://documentation.onesignal.com/docs/es/example-full-integration-sms.md).

## 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](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-notifications.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=57fef32f8987a51e7bdf8c40a6273087)

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.

```typescript app/notification-settings.tsx theme={null}
const handlePushMasterToggle = async (enabled: boolean) => {
  try {
    if (enabled) {
      OneSignal.User.pushSubscription.optIn();
    } else {
      OneSignal.User.pushSubscription.optOut();
    }
  } catch (e) {
    console.warn('OneSignal subscription toggle failed:', e);
  }
  save({ ...prefs, pushEnabled: enabled });
};
```

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.

```typescript src/lib/database.ts theme={null}
  const { error } = await supabase
    .from('profiles')
    .update({
      notifications_enabled: prefs.pushEnabled,
      push_daily_reminders: prefs.pushDailyReminders,
      push_streak_reminders: prefs.pushStreakReminders,
      push_cleaning_done: prefs.pushCleaningDone,
      push_leaderboard_updates: prefs.pushLeaderboardUpdates,
      push_upcoming_cleaning: prefs.pushUpcomingCleaning,
      push_overdue_reminders: prefs.pushOverdueReminders,
      email_weekly_summary: prefs.emailWeeklySummary,
      notification_hour: prefs.notificationHour,
      timezone: prefs.timezone,
    })
    .eq('id', user.id);
```

> [!NOTE]
>
> 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.

> [card] [Referencia del SDK móvil](https://documentation.onesignal.com/docs/es/mobile-sdk-reference.md)
>
> Todos los métodos de cliente usados en esta guía.

> [card] [Usuarios y External IDs](https://documentation.onesignal.com/docs/es/users.md)
>
> Cómo la identidad vincula las suscripciones entre canales y dispositivos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.