Pular para o conteúdo principal
Este guia explica como gerenciar assinaturas 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.

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.

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

​
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: 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.

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.

Prompts OneSignal Se o site contém o Bell Prompt ou Custom Link prompt 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.

Exemplo mostra o OneSignal Bell Prompt.

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

Exemplo mostra a limpeza do histórico do navegador e dados do site.


Exemplo mostra a limpeza dos dados do site.

​
Como testar seus prompts de permissão

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

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

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.

Menu de configurações do site do Chrome > Redefinindo permissões para Notificações.

3

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.

Tela de dados do site no dispositivo do Chrome.

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

Exemplo mostra a limpeza dos cookies do seu site.

4

Abra suas ferramentas de desenvolvedor.

Geralmente você pode apenas clicar com o botão direito na tela e pressionar Inspect.
5

Siga as etapas necessárias para solicitar notificações push e no prompt de permissão no nível do sistema exigido, selecione "Allow".

Se você não vir o prompt ou não souber as etapas, veja Prompts de permissão da web.

Exemplo mostra o prompt no nível do sistema exigido pelo Chrome.

6

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

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 para detalhes.

Obtendo o ID de assinatura push usando o Console.

Visualizando o ID de assinatura na página Subscriptions do painel OneSignal.

8

Ao lado da assinatura, selecione o botão de opções de 3 pontos e "Add to Test Subscriptions". Em seguida, nomeie e date o usuário de teste para que seja reconhecível."

Adicione sua assinatura como uma assinatura de teste.

9

Navegue até Messages > Push > New Message > New Push e no formulário de criação de Push adicione uma mensagem.

Veja Push para mais detalhes, se necessário.

Crie um novo push para enviar para sua assinatura de teste.

10

Selecione "Test & Preview", encontre e marque sua assinatura de teste, então clique em "Send Test Push".

Envie a si mesmo um push de teste.

11

Você deve receber o push que testou.

Se você não recebeu um push, veja Web push: Notificações não mostradas para depuração adicional.

Push de teste recebido.

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

​
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 navegadorAndroidWindowsmacOS
Chrome / ChromiumSimSimNão
FirefoxSimSimNão
SafariN/AN/ASim
OperaSimSimNão
EdgeSimSimNã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.