Configuração de web push

Siga este guia para habilitar web push e alcançar usuários com conteúdo oportuno quando eles não estão no seu site. Web push suporta texto, imagens, botões de ação e sons. Web push requer:

• Um website HTTPS seguro com um certificado SSL válido
• A capacidade de adicionar o service worker do OneSignal ao seu website
• Uma única origem que siga a política de mesma origem
• Permissão do usuário para receber notificações
• Navegadores suportados (Chrome, Firefox, Safari, Edge)

---

​

Escolha seu guia de configuração

Complete um destes caminhos de configuração de site. Se seu site é construído com Angular, React ou Vue, use o guia do framework correspondente. Se você carrega o SDK com o Google Tag Manager, finalize a configuração do dashboard e do service worker em Configuração do Web SDK e depois inicialize no GTM. Web push no iOS em iPhones e iPads funciona a partir do iOS 16.4+. Após finalizar um caminho de configuração de site, adicione um manifest.json e faça com que os usuários adicionem seu site à Tela Inicial deles.

​

Tipos de integração

No dashboard do OneSignal, vá para Settings > Push & In-App > Web e selecione o tipo de integração que corresponde ao seu site. Após selecionar um tipo de integração, finalize o guia de configuração correspondente. Os detalhes dos campos de Site Típico estão em Configuração do Web SDK. Os detalhes dos campos de Código Personalizado estão em Configuração de Código Personalizado.

---

​

Prompts de permissão web

Usuários devem conceder permissão antes de poderem receber web push. Os navegadores mostram um diálogo nativo do sistema para essa concessão. O OneSignal recomenda um pré-prompt personalizável primeiro para que você possa explicar o valor e evitar que o navegador bloqueie prompts nativos repetidos. Site Típico e WordPress: adicione, remova e atualize prompts no dashboard do OneSignal a qualquer momento. Código Personalizado: controle os prompts em OneSignal.init(). Veja a Referência do Web SDK.

---

​

Usuários e subscriptions

Quando um usuário se inscreve para push, o OneSignal cria uma subscription vinculada àquele navegador e dispositivo. Subscriptions de web push são criadas quando usuários:

• Concedem permissão para notificações push no seu website em um navegador e dispositivo específicos
• Retornam ao seu site após limpar os dados do navegador (se Auto Resubscribe estiver habilitado)
• Inscrevem-se de um novo navegador ou dispositivo

---

​

Projetar notificações web push

Notificações web push suportam títulos, mensagens, ícones, imagens e botões de ação. O diagrama mostra quais elementos você pode personalizar (1–5) e quais o navegador controla (6–9). Elementos personalizáveis:

1. Título: Manchete que chama atenção (recomendado: menos de 50 caracteres)
2. Mensagem: Conteúdo principal da notificação (recomendado: menos de 120 caracteres)
3. Ícone: Ícone quadrado da marca (recomendado: PNG, JPG ou GIF não animado de 256×256)
4. Imagem grande: Conteúdo visual que chama atenção
5. Botões de ação: Botões de call-to-action

Elementos controlados pelo navegador (não personalizáveis):

6. Navegador: O navegador exibindo o push
7. Domínio: A origem do seu site, definida pelo navegador
8. Timestamp e dispensar: Controles adicionados pelo navegador
9. Mais opções: Controles adicionais específicos do navegador

​

Personalização e localização

Personalize mensagens push para corresponder às preferências e ao idioma de cada usuário.

---

​

Configurar comportamento de web push

Controle quando as mensagens aparecem, por quanto tempo são armazenadas e o que acontece ao clicar.

​

Configurações de entrega, exibição e descarte

---

​

Teste sua configuração

Confirme a integração através de navegadores antes de enviar para toda a sua audiência.

​

Checklist pré-lançamento

• SDK está carregado sem erros no console
• Prompt de permissão aparece e funciona corretamente
• Notificação de teste é enviada e recebida
• Ícones e imagens renderizam corretamente
• Service worker está registrado e atualizado
• Certificado HTTPS é válido

​

Analytics e solução de problemas

---

​

Próximos passos

---

​

Perguntas frequentes

​

Usuários podem se inscrever para web push no iOS?

Sim, a partir do iOS 16.4+. Finalize primeiro Site Típico, Código Personalizado, WordPress ou Shopify, depois adicione um manifest.json e faça com que os usuários adicionem seu site à Tela Inicial deles. Veja Configuração de web push para iOS.

​

Por que um usuário parou de receber notificações web push?

As razões mais comuns são:

1. O usuário limpou os dados do navegador. Ele será reinscrito automática e silenciosamente quando retornar ao seu site se você tiver habilitado a opção Auto Resubscribe nas suas configurações de Web Push.
2. O usuário desativou notificações push nas configurações do sistema operacional. Ele precisará se reinscrever manualmente no seu site para receber notificações push novamente.

Para mais detalhes sobre estas e outras razões, veja Notificações web push não mostradas.

​

Notificações web push funcionam no modo anônimo ou navegação privada?

Não. Usuários não podem se inscrever para web push enquanto estão no modo anônimo ou de navegação privada. Subscriptions criadas em uma sessão normal não são acessíveis no modo privado.

​

Quais navegadores suportam notificações web push?

Chrome, Firefox, Safari (macOS e iOS 16.4+) e Edge suportam web push. Cada navegador pode ter comportamento de prompt e exibição de notificação diferente. Veja FAQ de web push para detalhes específicos de cada navegador.

​

Posso usar subdomínios com web push?

Cada subdomínio (por exemplo, app.example.com vs shop.example.com) é uma origem separada. Os navegadores aplicam a política de mesma origem para web push, portanto cada subdomínio requer seu próprio app OneSignal. O service worker também deve ser hospedado na mesma origem que a página de inscrição. CDNs e outros subdomínios não são permitidos. Veja Múltiplos sites e subdomínios.

​

Como registro mais de um domínio para web push?

Você precisa de um app OneSignal separado para cada domínio ou subdomínio. Um único app OneSignal pode servir apenas uma origem. Redirecione usuários para uma única origem para inscrição ou crie um app OneSignal por origem. Veja Múltiplos sites e subdomínios.

​

Por que meu prompt de web push não está aparecendo?

Causas comuns incluem um site servido via HTTP, um service worker que não está registrado, o usuário já ter concedido ou negado permissão, ou o modo anônimo. Verifique o console do navegador e veja Prompts de permissão web e Problemas de exibição de prompt.