​

Configuración app Windows

​

Requisitos

• App Universal Windows Platform (UWP) - OneSignal actualmente soporta solo apps UWP
• Registro de app Microsoft Store - Requerido para obtener Package SID y Secret Key
• Cuenta OneSignal - Cuenta gratuita con app configurada y configuraciones de plataforma

​

Configurar tu app OneSignal y plataforma

​

Paso 1: Configura tu cuenta OneSignal

​

Paso 2: Crea o configura tu app OneSignal

​

Crear nueva app

1. Haz clic en New App/Website desde tu dashboard
2. Elige un nombre de app reconocible y nombre de organización
3. Selecciona Windows (UWP) como tu plataforma
4. Haz clic en Next: Configure Your Platform

Creando una nueva app OneSignal con plataforma Windows

​

Agregar plataforma a app existente

1. Selecciona tu app existente
2. Navega a Settings > Push & In-App
3. Haz clic en Add Platform y selecciona Windows (UWP)

Configurando tu app OneSignal y seleccionando plataforma Windows

​

Paso 3: Configura plataformas adicionales (Opcional)

• Android: Configurar credenciales Firebase
• iOS: Token p8 (Recomendado) o Certificado p12
• Amazon: Generar API Key
• Huawei: Autorizar OneSignal

​

Paso 4: Selecciona SDK objetivo

Selecciona Windows UWP SDK para acceder a documentación específica de plataforma

​

Paso 5: Guarda tu App ID

Guarda tu App ID e invita a miembros del equipo que necesiten acceso

​

Configuración plataforma Windows

​

Obtener credenciales Microsoft Store

1. Publicar en Microsoft Store - Tu app debe estar registrada en Microsoft Store (incluso si no está disponible públicamente)
2. Obtener Package SID y Secret Key - Sigue la guía detallada de Microsoft para obtener estas credenciales
3. Configurar plataforma OneSignal:
   • Navega a Settings > Windows (UWP) en tu dashboard OneSignal
   • Pega tu Package SID y Secret Key
   • Haz clic en Save para activar la plataforma

Configura credenciales de plataforma Windows en dashboard OneSignal

Importante: Package SID y Secret Key solo están disponibles después de que tu app esté registrada en Microsoft Store. No puedes probar notificaciones push localmente sin estas credenciales.

​

Integración SDK

​

Entender la arquitectura

1. Windows Push Notification Service (WNS) - Servicio push nativo de Microsoft
2. OneSignal REST API - Para gestión de usuarios y envío de mensajes
3. Notification Channel URI - Actúa como el token del dispositivo para notificaciones push

​

Registrar usuarios para notificaciones push

​

Paso 1: Solicitar canal de notificación

// Ejemplo: Obtener URI de canal de notificación
var channel = await PushNotificationChannelManager.CreatePushNotificationChannelForApplicationAsync();
string channelUri = channel.Uri; // Este es tu token para OneSignal

​

Paso 2: Crear registro de usuario OneSignal

• subscription.type: "WindowsPush"
• subscription.token: El URI del canal del Paso 1

• identity.external_id: Identificador único para el usuario (ej., ID de usuario de tu sistema)
• properties: Cualquier propiedad de usuario personalizada para targeting

{
  "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"
    }
  }
}

Importante: Los URIs de canal pueden expirar y cambiar. Implementa lógica para refrescar el URI del canal periódicamente y actualizar el registro de usuario OneSignal cuando cambie.

​

Manejar cambios de URI de canal

channel.PushNotificationReceived += OnPushNotificationReceived;

// Verificar si el URI del canal ha cambiado
if (channel.Uri != storedChannelUri) {
    // Actualizar registro de usuario OneSignal con nuevo URI
    await UpdateOneSignalUser(channel.Uri);
}

​

Enviar notificaciones push

​

Usar dashboard OneSignal

1. Navega a Messages > Push en tu dashboard OneSignal
2. Crea una nueva notificación push
3. Selecciona tu plataforma Windows
4. Configura tu contenido de mensaje y targeting
5. Envía inmediatamente o programa para más tarde

​

Usar API OneSignal

{
  "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"
}

​

Siguientes pasos y mejores prácticas

​

Probar tu integración

1. Probar creación de canal de notificación - Asegúrate de que tu app cree y mantenga exitosamente un canal WNS
2. Verificar registro de usuario - Confirma que los usuarios estén registrados correctamente en tu dashboard OneSignal
3. Enviar notificaciones de prueba - Usa el dashboard OneSignal para enviar mensajes de prueba
4. Manejar eventos de notificación - Implementa manejo adecuado para eventos de notificación recibida, abierta y descartada

​

Problemas comunes y soluciones

• Verifica que tu Package SID y Secret Key estén configurados correctamente
• Asegúrate de que tu app esté registrada correctamente en Microsoft Store
• Verifica que el URI del canal no haya expirado

• Confirma que el registro de usuario OneSignal fue creado exitosamente
• Verifica que la plataforma Windows esté configurada correctamente en OneSignal
• Verifica que las notificaciones no estén siendo bloqueadas por la configuración de notificaciones de Windows

• Valida que tu OneSignal App ID sea correcto
• Asegúrate de que estás usando los endpoints API correctos y autenticación
• Revisa códigos de respuesta API y mensajes de error para solución de problemas

​

Consideraciones de producción

• Implementa manejo de errores adecuado para todas las llamadas API OneSignal
• Configura monitoreo para fallos de refresco de URI de canal
• Considera implementar cola offline para llamadas API durante problemas de red
• Planifica el escalado de registro de usuarios durante períodos de uso pico de app