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

# Aplicativo de exemplo: configuração do SDK e identidade do usuário

> Como o aplicativo de exemplo Clean Beans instala o SDK do OneSignal no Expo, vincula cada dispositivo a um usuário com um External ID e adiciona o email.

Esta página faz parte de [Aplicativo de exemplo: uma integração completa do OneSignal](https://documentation.onesignal.com/docs/pt-BR/example-full-integration-overview.md), que acompanha um aplicativo real do início ao fim. O aplicativo é o **Clean Beans**, uma escala de limpeza para casas compartilhadas, construído com Expo (React Native) e um backend Supabase.

Todo o resto depende de quatro coisas estarem corretas: o SDK está instalado, ele inicia quando o aplicativo inicia, cada dispositivo está vinculado a um usuário e as pessoas podem controlar o que recebem.

## Instalar com o plugin do Expo \\

O `onesignal-expo-plugin` configura os projetos nativos de iOS e Android no momento da compilação. Ele adiciona a capability de push, o App Group e a Notification Service Extension de que o OneSignal precisa para imagens, badges e confirmação 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 uma vez, na raiz \\

O Clean Beans inicializa o OneSignal no layout raiz, de modo que a inicialização roda uma vez a cada abertura, antes de qualquer tela aparecer.

```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 permissão na primeira abertura é a abordagem mais simples. Para explicar o benefício antes, mostre uma mensagem in-app antes do aviso do sistema. O Clean Beans tem uma pronta: consulte [Pré-solicitação de permissão de push](https://documentation.onesignal.com/docs/pt-BR/example-full-integration-in-app-messages.md#push-permission-pre-prompt).

## Vincular cada dispositivo a um usuário \\

Quando alguém faz login, o aplicativo passa o ID de usuário do Supabase para `OneSignal.login()`. Esse ID se torna o External ID. Quando a pessoa faz logout, `logout()` desvincula o dispositivo para que a próxima pessoa a fazer login não herde as mensagens dela.

```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]
>
> Aguarde a sessão salva carregar antes de chamar qualquer um dos métodos. Em uma inicialização a frio, o usuário conectado fica desconhecido por um instante. Se o aplicativo chamar `logout()` nesse momento e `login()` logo depois, a Subscription de push do dispositivo pode ficar em um usuário anônimo, e os pushes enviados ao External ID deixam de chegar ao telefone. Chame `logout()` somente quando alguém realmente sair da conta.

Essa única chamada é o que torna possível cada envio do backend neste guia. Uma função que conhece o ID de um usuário no banco de dados pode enviar mensagens a ele sem saber nada sobre seus dispositivos.

## Adicionar o canal de email \\

O aplicativo já conhece o endereço de email de cada usuário desde o cadastro, então ele o registra como Subscription de email no login. O OneSignal ignora chamadas repetidas com o mesmo endereço.

```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);
  }
}
```

O SMS é adicionado da mesma forma com `addSms()`, mas somente depois que o número é verificado. Consulte [SMS: códigos de verificação e convites](https://documentation.onesignal.com/docs/pt-BR/example-full-integration-sms.md).

## Deixar as pessoas controlarem o que recebem \\

A tela de configurações de notificação tem um interruptor principal e um interruptor para cada tipo de mensagem.

![A tela de configurações de notificação com um 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)

Configurações de notificação: um interruptor principal, interruptores por tipo e o horário do lembrete diário.

O interruptor principal chama `optOut()` e `optIn()` na Subscription de push, então o OneSignal interrompe e retoma a entrega para aquele 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 também é salvo na linha de perfil do usuário. O backend lê essas colunas antes de enviar qualquer coisa, e é assim que as preferências por tipo são aplicadas.

```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]
>
> Armazenar as preferências no seu próprio banco de dados e verificá-las antes de cada envio mantém a lógica em um só lugar. A alternativa é armazená-las como tags e filtrar por tag no OneSignal. Isso funciona bem quando você envia para segmentos. O Clean Beans envia para usuários específicos, então verificar o banco de dados é mais simples.

> [card] [Referência do SDK mobile](https://documentation.onesignal.com/docs/pt-BR/mobile-sdk-reference.md)
>
> Todos os métodos de cliente usados neste guia.

> [card] [Usuários e External IDs](https://documentation.onesignal.com/docs/pt-BR/users.md)
>
> Como a identidade vincula Subscriptions entre canais e dispositivos.


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