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

# Configuração de aplicativo macOS

> Aprenda como integrar OneSignal em seu aplicativo macOS, seja usando Mac Catalyst ou acesso direto à API. Orientação passo a passo para configurar plataformas, instalar o SDK e enviar notificações push.

## Configure seu aplicativo e plataforma OneSignal

Para enviar notificações push no macOS, seu aplicativo OneSignal deve ser configurado com a Apple (APNs).

<Note>
  Se sua equipe já tem uma conta OneSignal, [peça para ser convidado como uma função de administrador](./manage-team-members) para que você possa configurar o aplicativo. Caso contrário, [inscreva-se para uma conta gratuita](https://onesignal.com) para começar.
</Note>

### 1. Criar ou selecionar seu aplicativo

* Selecione seu aplicativo e vá para **Settings > Push & In-App**.
* Ou crie um novo aplicativo clicando em **New App/Website**.

<Frame caption="Exemplo mostra a criação de um novo aplicativo.">
  <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 e ativar a plataforma macOS

* Escolha um nome de aplicativo e organização reconhecível.
* Selecione (More Options) macOS como a plataforma a ativar.
* Clique em **Next: Configure Your Platform**.

<Frame caption="Exemplo configurando seu primeiro aplicativo, organização e canal 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 credenciais

Siga os prompts para adicionar:

* [Chave de autenticação p8 (Recomendado)](./ios-p8-token-based-connection-to-apns)
* Ou [Certificado p12](./ios-p12-generate-certificates)

<Frame caption="Exemplo mostrando a página de configuração da Chave de autenticação 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>

Clique em **Save & Continue** após inserir suas credenciais.

### 4. Salvar seu App ID

Você verá seu OneSignal App ID — certifique-se de salvá-lo, pois você precisará dele durante a configuração.

<Frame caption="Salve seu App ID para configuração.">
  <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>

***

## Configuração

Se seu aplicativo macOS foi construído com Mac Catalyst, você pode integrar nosso SDK iOS diretamente. Caso contrário, você pode aproveitar nossas APIs para gerenciar usuários e notificações.

<Tabs>
  <Tab title="Mac Catalyst">
    Se você construiu seu aplicativo com Mac Catalyst, você pode integrar nosso [SDK iOS](./ios-sdk-setup) diretamente.
  </Tab>

  <Tab title="Integração somente API">
    Se você não está usando Mac Catalyst, ou precisa de controle total, você pode integrar via API REST do OneSignal.

    <Steps>
      <Step title="Obter um token push macOS">
        Siga a [documentação da Apple](https://developer.apple.com/notifications/) para implementar suporte a push nativo e recuperar o token APNs do seu aplicativo macOS.
      </Step>

      <Step title="Registrar uma Assinatura macOS com o OneSignal">
        Chame nossa [API Create user](/reference/create-user) para definir o objeto `subscription`:

        * `type` de `macOSPush`
        * `token` do token APNs
        * Inclua todos os outros dados do usuário, especialmente `external_id` para rastrear o usuário no OneSignal.
      </Step>

      <Step title="Atualizar usuários">
        Use as APIs [Create user](/reference/create-user) ou [Update user](/reference/update-user) com o `external_id` para atualizar dados de usuário e assinatura.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

<Check>
  Configuração do macOS concluída!
  Próximos passos recomendados:

  * Entenda [Usuários](./users) e [Assinaturas](./subscriptions)
  * [API Create message](/reference/create-message) para enviar notificações
</Check>

***