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

# Comportamento de navegador para web push

> Aprenda como cancelar a assinatura de notificações e entender como os navegadores lidam com assinaturas de web push.

Este guia explica como gerenciar [assinaturas](./subscriptions) de web push e como o status da assinatura é afetado tanto pela ação do usuário quanto pelo comportamento do navegador.

***

## Entender permissões push

Os usuários devem conceder ao seu site permissão para enviar notificações push. Não é possível receber notificações push sem conceder explicitamente permissão ao site usando o prompt de permissão no nível do sistema.

<Frame caption="Exemplo do prompt de permissão no nível do sistema exigido pelo Chrome no qual você deve clicar em 'Permitir' para receber notificações push deste site.">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/60324a7f57f452db6054d4442689b8fb7f269f8dc123cc5b4154481ae8b89db4-Screenshot_2025-04-07_at_12.08.33_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=6d9631d8e6c3fb165068b20259df4457" width="1578" height="974" data-path="images/docs/60324a7f57f452db6054d4442689b8fb7f269f8dc123cc5b4154481ae8b89db4-Screenshot_2025-04-07_at_12.08.33_PM.png" />
</Frame>

As permissões podem ser:

* **Padrão**: a permissão não foi concedida nem negada.
* **Concedida**: você permitiu que o site lhe envie notificações.
* **Negada**: você bloqueou o site de lhe enviar notificações. Isso pode ser um bloqueio temporário se você clicou no **x** para fechar o prompt repetidamente ou um bloqueio permanente se você clicou em **Bloquear** ou desativou a permissão nas configurações do navegador.

<Note>
  Para mais detalhes sobre o prompt de permissão nativo no nível do sistema e/ou qualquer um dos prompts do OneSignal, veja [Prompts de permissão da web](./permission-requests).
</Note>

***

## Como cancelar assinatura de notificações da web

Você pode cancelar a assinatura de notificações push da web de três maneiras:

### Cancelar assinatura dentro das configurações do navegador

Você pode gerenciar ou remover permissões de notificação diretamente nas configurações do navegador. Aqui estão URLs de acesso rápido e documentos oficiais para saber mais:

* **Chrome**: `chrome://settings/content/notifications` ([Saiba mais nos documentos do Chrome](https://support.google.com/chrome/answer/3220216?hl=en\&co=GENIE.Platform%3DDesktop\&sjid=12874758545589453111-NA))
* **Edge**: `edge://settings/content/notifications` ([Saiba mais nos documentos da Microsoft](https://www.microsoft.com/en-us/edge/learning-center/how-to-turn-off-block-browser-notifications?form=MA13I2))
* **Firefox**: `about:preferences#privacy` role até Permissions > Notifications > Settings ([Saiba mais nos documentos da Mozilla](https://support.mozilla.org/en-US/kb/push-notifications-firefox))
* **Safari**: Settings > Websites > Notifications ([Saiba mais nos documentos do Safari](https://support.apple.com/guide/safari/customize-website-notifications-sfri40734/16.1/mac/13.0))

Nessas páginas, basta clicar nas opções para remover ou bloquear o(s) site(s) dos quais você não deseja notificações.

### Cancelar assinatura enquanto estiver no site

**Redefinir permissão**

A maioria dos navegadores tem um ícone de "cadeado" ou "configurações" ao lado da URL. Clicar nele revela permissões específicas do site onde os usuários podem desabilitar notificações push.

<Frame caption="Exemplo mostra o navegador Chrome onde você pode desativar completamente as permissões push para o site ou redefinir permissões, o que permitirá que o site solicite a você novamente.">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/6264e883e1d4c19f71712be79859cf48e26a47d4283571846d3e585ca2d26d6b-Screenshot_2025-04-07_at_10.56.32_AM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=38fbcf821abf6b7077e5e4b1e736ecb9" width="1636" height="974" data-path="images/docs/6264e883e1d4c19f71712be79859cf48e26a47d4283571846d3e585ca2d26d6b-Screenshot_2025-04-07_at_10.56.32_AM.png" />
</Frame>

**Prompts OneSignal**

Se o site contém o [Bell Prompt](./permission-requests) ou [Custom Link prompt](./permission-requests) do OneSignal, os usuários podem cancelar a assinatura diretamente por meio desses elementos de UI e podem se reinscrever usando os mesmos conforme desejado.

<Frame caption="Exemplo mostra o OneSignal Bell Prompt.">
  <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/400a59de59dcc7ec2cb46e09a29f99bbd1da11861bba418e76e7a0b90f86ed4d-Screenshot_2025-04-07_at_10.59.38_AM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=3226ef886346ee6abbc25ebb17abf36b" width="1636" height="974" data-path="images/docs/400a59de59dcc7ec2cb46e09a29f99bbd1da11861bba418e76e7a0b90f86ed4d-Screenshot_2025-04-07_at_10.59.38_AM.png" />
</Frame>

### Excluir dados do navegador, limpar cookies e dados do site

Se você excluir o histórico e/ou excluir seus cookies e dados do site, isso impedirá temporariamente que as notificações sejam exibidas. No entanto, se você não remover as permissões push do site, poderá ser automaticamente reinscrito e começar a receber notificações novamente ao retornar ao site.

<Frame caption="Exemplo mostra a limpeza do histórico do navegador e dados do site.">
  <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5e463a765566c11fee159b98a88f0a66314be75e16d7963296b53cfb880d0640-Screenshot_2025-04-07_at_11.56.43_AM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=c133664ca1396ee6ed0dcc03c20f9c9b" width="2962" height="1458" data-path="images/docs/5e463a765566c11fee159b98a88f0a66314be75e16d7963296b53cfb880d0640-Screenshot_2025-04-07_at_11.56.43_AM.png" />
</Frame>

<br />

<Frame caption="Exemplo mostra a limpeza dos dados do site.">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/9e18eb2c46e65b05e98bfe488268daaf8e1cb3d958767393b9e935de3189327c-Screenshot_2025-04-07_at_11.56.34_AM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=56d550b0d11955804d5b7f6a71544125" width="2962" height="1458" data-path="images/docs/9e18eb2c46e65b05e98bfe488268daaf8e1cb3d958767393b9e935de3189327c-Screenshot_2025-04-07_at_11.56.34_AM.png" />
</Frame>

***

## Como testar seus prompts de permissão

Estas etapas explicam como testar seu prompt e fluxo de assinatura como um visitante pela primeira vez.

<Steps>
  <Step title="Visite seu site com a configuração do SDK OneSignal.">
    **Não use uma configuração de navegador anônimo, privado ou convidado.** Este exemplo usa a versão 135 do Chrome no macOS, mas o fluxo deve ser relativamente o mesmo para a maioria dos navegadores.
  </Step>

  <Step title="Redefinir permissões push">
    Clique no ícone de configurações do site ou cadeado ao lado da URL do site e selecione **Reset permission** ou remova permissões para Notificações.
    Pule para a próxima etapa se você não vir esta opção de permissão.

    <Frame caption="Menu de configurações do site do Chrome > Redefinindo permissões para Notificações.">
      <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0caa8967d5d339eb83795e9c8aae6fd58dfb370e7937eec2689286bc37b7d3ad-Screenshot_2025-04-07_at_1.15.10_PM.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=cc627d94184116ba58ab88a9ebd192b3" width="1642" height="1038" data-path="images/docs/0caa8967d5d339eb83795e9c8aae6fd58dfb370e7937eec2689286bc37b7d3ad-Screenshot_2025-04-07_at_1.15.10_PM.png" />
    </Frame>
  </Step>

  <Step title="Excluir dados do site.">
    Clique em **Cookies and site data > Manage on-device site data** ou siga o fluxo do navegador para ver a opção de dados do seu site.

    <Frame caption="Tela de dados do site no dispositivo do Chrome.">
      <img src="https://mintcdn.com/onesignal/_KaXe4GQkxsEfa17/images/docs/3ddc97a656d2a7e72851bb723c3ef6bb7cf451f43f2980b6e16326b34ad0694d-Screenshot_2025-04-07_at_1.17.51_PM.png?fit=max&auto=format&n=_KaXe4GQkxsEfa17&q=85&s=cc96365a817a37b63a008bf300dba8b2" width="1642" height="1264" data-path="images/docs/3ddc97a656d2a7e72851bb723c3ef6bb7cf451f43f2980b6e16326b34ad0694d-Screenshot_2025-04-07_at_1.17.51_PM.png" />
    </Frame>

    Exclua os dados do seu site e saia das configurações para voltar ao seu site.

    <Frame caption="Exemplo mostra a limpeza dos cookies do seu site.">
      <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/14356bf800a63a9cb7ce3396c86ab636720ff152d65f266cb253142266b246d2-Screenshot_2025-04-07_at_1.22.02_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=61dcb2f2c4967bf79dfd609b820a2507" width="1554" height="1216" data-path="images/docs/14356bf800a63a9cb7ce3396c86ab636720ff152d65f266cb253142266b246d2-Screenshot_2025-04-07_at_1.22.02_PM.png" />
    </Frame>
  </Step>

  <Step title="Abra suas ferramentas de desenvolvedor.">Geralmente você pode apenas clicar com o botão direito na tela e pressionar **Inspect**.</Step>

  <Step title="Siga as etapas necessárias para solicitar notificações push e no prompt de permissão no nível do sistema exigido, selecione &#x22;Allow&#x22;.">
    Se você não vir o prompt ou não souber as etapas, veja [Prompts de permissão da web](./permission-requests).

    <Frame caption="Exemplo mostra o prompt no nível do sistema exigido pelo Chrome.">
      <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/99abfc40c2cbce6d99a32295716ba683e77a1ef4c3d8e26736d1448a62513703-Screenshot_2025-04-07_at_1.22.55_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=d522e924e8cf68c5e2e331705571159b" width="1642" height="1038" data-path="images/docs/99abfc40c2cbce6d99a32295716ba683e77a1ef4c3d8e26736d1448a62513703-Screenshot_2025-04-07_at_1.22.55_PM.png" />
    </Frame>
  </Step>

  <Step title="Verifique o console em busca de erros.">
    Se você ver algo em vermelho relacionado ao OneSignal, consulte nossa documentação de [solução de problemas do SDK Web](./troubleshooting-web-push).
  </Step>

  <Step title="Obter ID de assinatura">
    No **Console** digite ou copie e cole este código: `OneSignal.User.PushSubscription.id`

    1. Isso registrará seu ID de assinatura do OneSignal. Copie e cole isso no seu painel OneSignal Audience > aba Subscriptions.
    2. Se um ID de assinatura não foi registrado no console, então você não está inscrito com sucesso. Consulte [Solução de problemas do SDK Web](./troubleshooting-web-push) para detalhes.

    <Frame caption="Obtendo o ID de assinatura push usando o Console.">
      <img src="https://mintcdn.com/onesignal/6v_cVPknFpo5qSVB/images/docs/0585c363af7bf9154c7cd204b9ce4636049694af313c80564ab94c75dc898da3-Screenshot_2025-04-07_at_1.35.26_PM.png?fit=max&auto=format&n=6v_cVPknFpo5qSVB&q=85&s=96e4c0b9515e7e62cb3e29ed0afdc8a5" width="1642" height="1038" data-path="images/docs/0585c363af7bf9154c7cd204b9ce4636049694af313c80564ab94c75dc898da3-Screenshot_2025-04-07_at_1.35.26_PM.png" />
    </Frame>

    <Frame caption="Visualizando o ID de assinatura na página Subscriptions do painel OneSignal.">
      <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/97de08625efcb3ae048d8db0ce79ab6400d4edb1e32fb586ee2ccfdec64ef533-Screenshot_2025-04-07_at_1.35.39_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=f0e59d2577e9301240efca039c941212" width="2268" height="1320" data-path="images/docs/97de08625efcb3ae048d8db0ce79ab6400d4edb1e32fb586ee2ccfdec64ef533-Screenshot_2025-04-07_at_1.35.39_PM.png" />
    </Frame>
  </Step>

  <Step title="Ao lado da assinatura, selecione o botão de opções de 3 pontos e &#x22;Add to Test Users&#x22;. Em seguida, nomeie e date o usuário de teste para que seja reconhecível.&#x22;">
    <Frame caption="Adicione sua assinatura como uma assinatura de teste.">
      <img src="https://mintcdn.com/onesignal/Z6xkXGfmy814If53/images/docs/daee83f7f444a1361390186abfd493252ae59b8ffbdb42f4a14fd979f2f9e268-Screenshot_2025-04-07_at_1.35.46_PM.png?fit=max&auto=format&n=Z6xkXGfmy814If53&q=85&s=65ddc58a9861c912ccc19abe1225c6aa" width="2268" height="1320" data-path="images/docs/daee83f7f444a1361390186abfd493252ae59b8ffbdb42f4a14fd979f2f9e268-Screenshot_2025-04-07_at_1.35.46_PM.png" />
    </Frame>
  </Step>

  <Step title="Navegue até Messages > Push > New Message > New Push e no formulário de criação de Push adicione uma mensagem.">
    Veja [Push](./push) para mais detalhes, se necessário.

    <Frame caption="Crie um novo push para enviar para sua assinatura de teste.">
      <img src="https://mintcdn.com/onesignal/3zq1PvSaqvUE2bIx/images/docs/2b9d9a6022f8c8566fe9ab63dde56ef8a6dc5bca9e4a1902c5b939748eea696a-Screenshot_2025-04-07_at_1.39.55_PM.png?fit=max&auto=format&n=3zq1PvSaqvUE2bIx&q=85&s=c153b7d978104a1639d5b2269871c7ce" width="2268" height="1320" data-path="images/docs/2b9d9a6022f8c8566fe9ab63dde56ef8a6dc5bca9e4a1902c5b939748eea696a-Screenshot_2025-04-07_at_1.39.55_PM.png" />
    </Frame>
  </Step>

  <Step title="Selecione &#x22;Test & Preview&#x22;, encontre e marque sua assinatura de teste, então clique em &#x22;Send Test Push&#x22;.">
    <Frame caption="Envie a si mesmo um push de teste.">
      <img src="https://mintcdn.com/onesignal/jBdBk5XvQR5eKOks/images/docs/7829f46df767772414b32b05edb166a59b3d853b054263057dbb3042c1f13606-Screenshot_2025-04-07_at_1.41.19_PM.png?fit=max&auto=format&n=jBdBk5XvQR5eKOks&q=85&s=b6efff85cdd63ce7b1ebfd41394d8f49" width="2268" height="1320" data-path="images/docs/7829f46df767772414b32b05edb166a59b3d853b054263057dbb3042c1f13606-Screenshot_2025-04-07_at_1.41.19_PM.png" />
    </Frame>
  </Step>

  <Step title="Você deve receber o push que testou.">
    Se você não recebeu um push, veja [Web push: Notificações não mostradas](./notifications-not-shown-web-push) para depuração adicional.

    <Frame caption="Push de teste recebido.">
      <img src="https://mintcdn.com/onesignal/0qspEXXeJ8zJbkJ-/images/docs/81a55eefc69a1cc6e4aba2bc240e780bb8cb5bdcafac2891862e3c11f1d45591-Screenshot_2025-04-07_at_1.43.07_PM.png?fit=max&auto=format&n=0qspEXXeJ8zJbkJ-&q=85&s=c779697abc1576141e9a542bec927be2" width="740" height="198" data-path="images/docs/81a55eefc69a1cc6e4aba2bc240e780bb8cb5bdcafac2891862e3c11f1d45591-Screenshot_2025-04-07_at_1.43.07_PM.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  Você configurou com sucesso o web push com o OneSignal. Próximos passos:

  * [Configuração de web push](./web-push-setup) - etapas adicionais de configuração web para não desenvolvedores.
  * [Configuração do SDK Web](./web-sdk-setup) - etapas de configuração do SDK web para desenvolvedores.
  * [Solução de problemas do SDK Web](./troubleshooting-web-push) - solução de problemas se você ver erros no console ou não estiver obtendo um ID de assinatura.
  * [Web push: Notificações não mostradas](./notifications-not-shown-web-push) - solução de problemas de notificações não exibidas no seu dispositivo.
</Check>

***

### Receber notificações quando o navegador está fechado

Os navegadores se comportam de maneira diferente entre plataformas. Consulte a tabela abaixo para suporte para receber notificações mesmo quando o navegador está fechado.

| Nome do navegador | Android | Windows | macOS |
| ----------------- | ------- | ------- | ----- |
| Chrome / Chromium | Sim     | Sim     | Não   |
| Firefox           | Sim     | Sim     | Não   |
| Safari            | N/A     | N/A     | Sim   |
| Opera             | Sim     | Sim     | Não   |
| Edge              | Sim     | Sim     | Não   |

**Chrome** - O Chrome é executado como um processo em segundo plano por padrão, mesmo quando todas as janelas estão fechadas. Contanto que o processo em segundo plano esteja em execução, as notificações ainda serão recebidas. Se o processo em segundo plano do Chrome não estiver em execução, as notificações não serão recebidas.

**Firefox** - No Mac OS X, o processo ainda existe mesmo se as janelas estiverem fechadas, e uma notificação pode ser recebida se todas as janelas estiverem fechadas (contanto que ainda haja um ponto no dock mostrando que o Firefox ainda está em execução). No Windows, o processo sai depois que todas as janelas são fechadas, então as notificações não podem ser recebidas, a menos que uma janela do Firefox ainda esteja aberta.

**Safari** - O Safari não precisa estar em execução para receber notificações, pois elas são enviadas diretamente ao sistema operacional. O usuário ainda precisa se inscrever para notificações web do Safari, mas depois disso elas serão recebidas mesmo quando o Safari estiver completamente fechado.

Os assinantes têm até 3 dias para recuperar a última notificação perdida conhecida antes que as mensagens expirem permanentemente.

Por exemplo, suponha que um assinante devesse receber uma notificação push da web do Firefox, mas o Firefox estava fechado. Se o assinante abrir o Firefox dentro de 3 dias, o assinante receberá apenas a última notificação push da web conhecida que não expirou. Se o assinante abrir o Firefox após 3 dias, a notificação push da web enviada há mais de 3 dias não será recebida.

***