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

# Configuración de app macOS

> Aprende a integrar OneSignal en tu app de macOS, ya sea usando Mac Catalyst o acceso directo a la API. Guía paso a paso para configurar plataformas, instalar el SDK y enviar notificaciones push.

## Configurar tu app y plataforma de OneSignal

Para enviar notificaciones push en macOS, tu app de OneSignal debe estar configurada con Apple (APNs).

<Note>
  Si tu equipo ya tiene una cuenta de OneSignal, [solicita ser invitado como rol de administrador](./manage-team-members) para que puedas configurar la app. De lo contrario, [regístrate para una cuenta gratuita](https://onesignal.com) para comenzar.
</Note>

### 1. Crear o seleccionar tu app

* Selecciona tu app y ve a **Configuración > Push e In-App**.
* O crea una nueva app haciendo clic en **Nueva App/Sitio web**.

<Frame caption="El ejemplo muestra la creación de una nueva app.">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/13e619dc5fd638b4d9adf5505ddd645de431dc963dbeeac923462060c030ce7c-Screenshot_2025-04-07_at_3.48.57_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=77c331bb0aea78c3f5d96ed065e14d1f" width="2344" height="1544" data-path="images/docs/13e619dc5fd638b4d9adf5505ddd645de431dc963dbeeac923462060c030ce7c-Screenshot_2025-04-07_at_3.48.57_PM.png" />
</Frame>

### 2. Configurar y activar la plataforma macOS

* Elige un nombre de app y organización reconocible.
* Selecciona (Más opciones) macOS como la plataforma a activar.
* Haz clic en **Siguiente: Configura tu plataforma**.

<Frame caption="Ejemplo configurando tu primera app, org y canal de OneSignal.">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/macOS-setup.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=25be1bfb506afd630785c68e6df28066" width="2232" height="1658" data-path="images/dashboard/macOS-setup.png" />
</Frame>

### 3. Configurar credenciales

Sigue las indicaciones para agregar:

* [Clave de autenticación p8 (Recomendado)](./ios-p8-token-based-connection-to-apns)
* O [Certificado p12](./ios-p12-generate-certificates)

<Frame caption="Ejemplo que muestra la página de configuración de Clave de autenticación p8.">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/macOS-configuration.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=2f0dd6fb8f8956df4d8fd3172813e5ed" width="2232" height="1658" data-path="images/dashboard/macOS-configuration.png" />
</Frame>

Haz clic en **Guardar y continuar** después de ingresar tus credenciales.

### 4. Guardar tu ID de app

Se te mostrará tu ID de app de OneSignal — asegúrate de guardarlo, ya que lo necesitarás durante la configuración.

<Frame caption="Guarda tu ID de app para la configuración.">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/macOS-appid.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=abc964a5bdbee6f40b36d0d181b3fc63" width="2154" height="1304" data-path="images/dashboard/macOS-appid.png" />
</Frame>

***

## Configuración

Si tu app de macOS se creó con Mac Catalyst, puedes integrar nuestro iOS SDK directamente. De lo contrario, puedes aprovechar nuestras APIs para gestionar usuarios y notificaciones.

<Tabs>
  <Tab title="Mac Catalyst">
    Si creaste tu app con Mac Catalyst, puedes integrar nuestro [iOS SDK](./ios-sdk-setup) directamente.
  </Tab>

  <Tab title="API-only integration">
    Si no estás usando Mac Catalyst, o necesitas control total, puedes integrar a través de la API REST de OneSignal.

    <Steps>
      <Step title="Obtener un token push de macOS">
        Sigue la [documentación de Apple](https://developer.apple.com/notifications/) para implementar soporte push nativo y recuperar el token APNs de tu app de macOS.
      </Step>

      <Step title="Registrar una Suscripción de macOS con OneSignal">
        Llama a nuestra [Create user API](/reference/create-user) para establecer el objeto `subscription`:

        * `type` de `macOSPush`
        * `token` del token APNs
        * Incluye todos los demás datos de usuario, especialmente `external_id` para rastrear al usuario en OneSignal.
      </Step>

      <Step title="Actualizar usuarios">
        Usa las APIs [Create user](/reference/create-user) o [Update user](/reference/update-user) con el `external_id` para actualizar datos de usuario y suscripción.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

<Check>
  ¡Configuración de macOS completa!
  Próximos pasos recomendados:

  * Comprende [Usuarios](./users) y [Suscripciones](./subscriptions)
  * [Create message API](/reference/create-message) para enviar notificaciones
</Check>

***