​

Configuração de App Windows

​

Requisitos

• App Universal Windows Platform (UWP) - OneSignal atualmente suporta apenas apps UWP
• Registro de App Microsoft Store - Necessário para obter Package SID e Secret Key
• Conta OneSignal - Conta gratuita com configurações de app e plataforma configuradas

​

Configure Seu App e Plataforma OneSignal

​

Passo 1: Configure Sua Conta OneSignal

​

Passo 2: Crie ou Configure Seu App OneSignal

​

Criar Novo App

1. Clique em New App/Website do seu dashboard
2. Escolha um nome de app reconhecível e nome de organização
3. Selecione Windows (UWP) como sua plataforma
4. Clique em Next: Configure Your Platform

​

Adicionar Plataforma a App Existente

1. Selecione seu app existente
2. Navegue para Settings > Push & In-App
3. Clique em Add Platform e selecione Windows (UWP)

​

Passo 3: Configure Plataformas Adicionais (Opcional)

• Android: Configure Credenciais Firebase
• iOS: Token p8 (Recomendado) ou Certificado p12
• Amazon: Gere API Key
• Huawei: Autorize OneSignal

​

Passo 4: Selecione SDK Alvo

​

Passo 5: Salve Seu App ID

​

Configuração de Plataforma Windows

​

Obtenha Credenciais Microsoft Store

1. Publique na Microsoft Store - Seu app deve estar registrado na Microsoft Store (mesmo que não esteja publicamente disponível)
2. Obtenha Package SID e Secret Key - Siga guia detalhado da Microsoft para recuperar estas credenciais
3. Configure Plataforma OneSignal:
   • Navegue para Settings > Windows (UWP) no seu dashboard OneSignal
   • Cole seu Package SID e Secret Key
   • Clique em Save para ativar a plataforma

Atenção: Package SID e Secret Key estão disponíveis apenas após seu app estar registrado na Microsoft Store. Você não pode testar notificações push localmente sem estas credenciais.

​

Integração do SDK

​

Entendendo a Arquitetura

1. Windows Push Notification Service (WNS) - Serviço de push nativo da Microsoft
2. OneSignal REST API - Para gerenciamento de usuário e envio de mensagem
3. Notification Channel URI - Age como o token de dispositivo para notificações push

​

Registre Usuários para Notificações Push

​

Passo 1: Solicite Canal de Notificação

// Example: Getting notification channel URI
var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
string channelUri = channel.Uri; // This is your token for OneSignal

​

Passo 2: Crie Registro de Usuário OneSignal

• subscription.type: "WindowsPush"
• subscription.token: O URI do canal do Passo 1

• identity.external_id: Identificador único para o usuário (por exemplo, ID de usuário do seu sistema)
• properties: Quaisquer propriedades de usuário personalizadas para segmentação

{
  "identity": {
    "external_id": "your-user-id-123"
  },
  "subscriptions": [
    {
      "type": "WindowsPush",
      "token": "https://cloud.notify.windows.com/?token=..."
    }
  ],
  "properties": {
    "tags": {
      "user_type": "premium",
      "app_version": "1.2.0"
    }
  }
}

Atenção: URIs de canal podem expirar e mudar. Implemente lógica para atualizar o URI do canal periodicamente e atualizar o registro de usuário OneSignal quando ele mudar.

​

Trate Mudanças de URI de Canal

channel.PushNotificationReceived += OnPushNotificationReceived;

// Check if channel URI has changed
if (channel.Uri != storedChannelUri) {
    // Update OneSignal user record with new URI
    await UpdateOneSignalUser(channel.Uri);
}

​

Enviando Notificações Push

​

Usando Dashboard OneSignal

1. Navegue para Messages > Push no seu dashboard OneSignal
2. Crie uma nova notificação push
3. Selecione sua plataforma Windows
4. Configure seu conteúdo de mensagem e segmentação
5. Envie imediatamente ou agende para depois

​

Usando OneSignal API

{
  "app_id": "your-onesignal-app-id",
  "contents": {"en": "Your notification message"},
  "headings": {"en": "Notification Title"},
  "include_external_user_ids": ["your-user-id-123"],
  "channel_for_external_user_ids": "push"
}

​

Próximos Passos e Melhores Práticas

​

Testando Sua Integração

1. Teste Criação de Canal de Notificação - Garanta que seu app cria e mantém com sucesso um canal WNS
2. Verifique Registro de Usuário - Confirme que usuários estão propriamente registrados no seu dashboard OneSignal
3. Envie Notificações de Teste - Use o dashboard OneSignal para enviar mensagens de teste
4. Trate Eventos de Notificação - Implemente tratamento adequado para eventos de notificação recebida, aberta e dispensada

​

Problemas Comuns e Soluções

• Verifique se seu Package SID e Secret Key estão corretamente configurados
• Garanta que seu app está propriamente registrado na Microsoft Store
• Verifique se o URI do canal não expirou

• Confirme que o registro de usuário OneSignal foi criado com sucesso
• Verifique se a plataforma Windows está propriamente configurada no OneSignal
• Verifique que notificações não estão sendo bloqueadas pelas configurações de notificação do Windows

• Valide se seu OneSignal App ID está correto
• Garanta que você está usando os endpoints de API e autenticação corretos
• Revise códigos de resposta de API e mensagens de erro para solução de problemas

​

Considerações de Produção

• Implemente tratamento de erro adequado para todas as chamadas de API OneSignal
• Configure monitoramento para falhas de atualização de URI de canal
• Considere implementar enfileiramento offline para chamadas de API durante problemas de rede
• Planeje para escalar registro de usuário durante períodos de pico de uso do app