> ## 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 web push
> Configure notificações web push com OneSignal para reengajar usuários no Chrome, Firefox, Safari e Edge.
Notificações web push reengajam usuários com conteúdo oportuno — mesmo quando eles não estão navegando ativamente no seu website. Elas suportam conteúdo rico incluindo texto, imagens, botões de ação e sons.
Para que web push funcione:
* **Website HTTPS**: Web push apenas funciona em sites seguros com um certificado SSL válido
* **Service worker**: Você deve ser capaz de adicionar o [service worker do OneSignal](./onesignal-service-worker) ao seu website
* **Origem de domínio único**: Deve seguir a [política de mesma origem](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy)
* **Permissão do usuário**: Usuários devem explicitamente conceder permissão para receber notificações
* **Navegadores suportados**: Funciona na maioria dos navegadores modernos (Chrome, Firefox, Safari, Edge)
Usuários não podem se inscrever enquanto estão no modo Anônimo ou navegação privada. Dispositivos iOS requerem configuração adicional (veja [Web push para iOS](./web-push-for-ios)). Alguns navegadores podem ter limites de notificação ou requerer interação do usuário — veja [FAQ de Web Push](./web-push-setup-faq).
Este guia percorre cada passo—desde configuração do SDK até envio de mensagens push personalizadas—para ajudá-lo a implementar com sucesso notificações push do OneSignal.
***
## Guias de desenvolvedor de web push
Antes que você possa enviar notificações web push, seu desenvolvedor precisa completar os seguintes passos.
Não é desenvolvedor? Veja [Gerenciar Membros da Equipe](./manage-team-members) para convidar um colega de equipe com acesso de desenvolvedor ao seu projeto OneSignal.
Guia completo para instalar e configurar o Web SDK OneSignal, incluindo testes localhost e prompts de permissão.
Integre rapidamente notificações push no WordPress usando nosso plugin oficial—sem código necessário.
Siga passos específicos da Apple para habilitar web push em iPhones e iPads rodando iOS 16.4+.
Aprenda como fazer transição de outro provedor de web push e reter seus inscritos.
***
## Opções de configuração
Configure seu website para web push no dashboard OneSignal em **Settings > Push & In-App > Web**.
Selecione o tipo de integração que corresponde ao seu site:
**Recomendado** - Configure prompts, notificação de boas-vindas e configuração de service worker diretamente no dashboard—sem código backend necessário.
Use o plugin oficial OneSignal para configurar facilmente push no seu site WordPress com configuração completa baseada em UI.
Configuração com controle completo para desenvolvedores que querem personalizar tudo via código.
Detalhes do site:
* **Nome do Site**: Usado em títulos de notificação padrão
* **URL do Site**: Deve corresponder exatamente à origem do seu domínio (sem caminhos ou incompatibilidade de `www`)
* **Auto Resubscribe**: Recomendado - Reinscreve automaticamente usuários que retornam e limparam dados do navegador
* **URL do Ícone Padrão**: Imagem `256x256px` mostrada em notificações (se não definida, um ícone de sino padrão é usado)
### Auto resubscribe
Se usuários limparem seus dados de navegador, eles pararão de receber notificações push. Habilite esta opção para reinscrever automaticamente usuários quando eles retornarem ao seu site. Veja [Subscriptions](./subscriptions) para mais detalhes.
***
### Prompts de permissão web
Solicitar permissão de notificação aos usuários é crítico para opt-in. Você pode personalizar o comportamento e aparência de requisições de permissão baseado na sua configuração.
Use mensagens claras que explicam o benefício, solicite usuários no momento certo (ex: após engajamento) e use um pré-prompt antes de acionar o diálogo nativo do navegador.
Compare diferentes tipos de prompt (slidedown, baseado em categoria, nativo, sino de subscription e mais) e aprenda quando usar cada um.
Aprenda como controlar programaticamente quando e como prompts são mostrados usando o SDK.
***
### Notificação de boas-vindas
Você pode habilitar um push de confirmação opcional que é enviado imediatamente após um usuário se inscrever.
Integração Típica e WordPress podem definir isso no dashboard.
Integração com Código Personalizado usa o objeto `welcomeNotification` na função `OneSignal.init`. Veja [Referência do Web SDK](./web-sdk-reference) para detalhes.
**Por que enviar notificações de boas-vindas?**
* Deixe usuários saberem que se inscreveram com sucesso
* Mostre como notificações futuras parecerão
* Forneça conteúdo de onboarding ou próximos passos
***
## Usuários e subscriptions
Quando um usuário se inscreve para push, o OneSignal automaticamente cria uma **subscription** única vinculada ao navegador/dispositivo dele.
Subscriptions de web push são criadas quando usuários:
* Concedem permissão para notificações push no seu website usando um navegador e dispositivo específicos
* Retornam ao seu site **após limpar dados do navegador** (se Auto Resubscribe estiver habilitado)
* Inscrevem-se de um novo navegador ou dispositivo
Cada combinação navegador/dispositivo cria uma subscription separada. Modo de navegação anônima/privada não pode criar subscriptions. Subscriptions de web push permanecem anônimas até que você atribua a elas um [External ID](./users#external-id).
Aprenda como gerenciar usuários, atribuir External IDs e rastrear sua atividade.
Entenda como subscriptions funcionam através de navegadores e dispositivos.
Agrupe usuários em segmentos para direcionar baseado em comportamento, dispositivo e mais.
### Suporte iOS
A Apple adicionou suporte de web push para iPhones e iPads rodando iOS 16.4+ mas com requisitos mais rigorosos:
* Usuários devem adicionar seu site à Tela Inicial deles
* Prompts de permissão são mostrados apenas após aquele passo
* Notificações comportam-se como alertas de app nativo uma vez habilitadas
Instruções passo a passo para habilitar suporte iOS, incluindo configuração de service worker e manifest.
Dicas para encorajar usuários a instalar seu site para que possam receber web push do iOS.
***
## Projetar notificações web push
Criar notificações push eficazes envolve mais que escrever texto. Aprenda quais elementos são personalizáveis e como usá-los efetivamente.
1. [Título](./push#title): Manchete que chama atenção (recomendado: menos de `50` caracteres)
2. [Mensagem](./push#message): Conteúdo principal da notificação (recomendado: menos de `120` caracteres)
3. [Ícone](./notification-icons): Ícone da sua marca ou imagem específica da notificação (recomendado: `256x256px` PNG ou JPG)
4. [Imagem Grande](./push#image): Conteúdo visual que chama atenção
5. [Botões de Ação](./action-buttons): Botões de call-to-action
6. Navegador: O navegador/app exibindo o push
7. Domínio: Origem do seu site definida automaticamente pelo navegador
8. Timestamp & Dismiss: Navegador adiciona estes controles
9. Mais Opções: Controles adicionais específicos do navegador
Visão geral completa de criação de notificação push, opções e comportamento de entrega.
Economize tempo com templates reutilizáveis para mensagens consistentes.
### Personalização e localização de mensagem
Você pode personalizar mensagens push para corresponder às preferências e idioma de cada usuário.
Insira variáveis dinâmicas (como nome ou preferências) para adaptar mensagens.
Entregue automaticamente mensagens no idioma preferido de cada usuário.
***
## Configurar comportamento de web push
Controle como suas mensagens push se comportam após envio—quando aparecem, por quanto tempo são armazenadas e como usuários interagem.
### Configurações de entrega, exibição e descarte
Controle velocidade de entrega de notificação.
Defina limites para prevenir envio excessivo de notificações para o mesmo usuário.
Defina por quanto tempo serviços push retêm mensagens quando o dispositivo está offline.
Use tópicos para agrupar, substituir ou suprimir notificações duplicadas.
### Comportamento de clique
Controle o que acontece quando um usuário clica em uma notificação.
**Por padrão:** Clicar abre sua página inicial.
**Personalize:**
* Direcione usuários para uma URL específica
* Use rastreamento UTM
* Suprima comportamento padrão com `?_osp=do_not_open`
Direcione usuários para conteúdo ou páginas relevantes usando deep links e rastreamento.
Deixe usuários tomarem ações imediatas da sua notificação.
Escute eventos de clique e acione comportamento in-app com código personalizado.
***
## Teste sua configuração
Antes de lançar, teste completamente sua implementação de web push através de dispositivos e navegadores.
### Checklist pré-lançamento
* SDK está carregado corretamente sem erros
* Prompt de permissão aparece e funciona
* Notificação de teste é enviada e recebida
* Ícones e imagens renderizam corretamente
* Service worker está registrado e atualizado
* Certificado HTTPS é válido
### Analytics de push e solução de problemas
Meça o desempenho de notificações e resolva problemas comuns de entrega:
Veja métricas de entrega, taxa de abertura e click-through para cada mensagem.
Explore métricas de engajamento e comportamento do usuário através de canais.
Checklist de solução de problemas se mensagens não estão aparecendo.
Corrija problemas de renderização de imagem através de diferentes navegadores.
***
## Próximos passos
Otimize mensagens com experimentos para encontrar o que gera engajamento.
Construa fluxos de mensagens automatizados de múltiplos passos acionados pelo comportamento do usuário.
Adicione dados de nível de usuário para personalização e direcionamento.
Rastreie métricas de engajamento e conversão através de canais.
***
## Perguntas frequentes
### Usuários podem se inscrever para web push no iOS?
Sim, começando com iOS 16.4+. Usuários devem primeiro adicionar seu website à Tela Inicial deles, depois conceder permissão de notificação. Veja [Web push para iOS](./web-push-for-ios) para os passos completos de configuração.
### Por que um usuário parou de receber notificações web push?
A causa mais comum é que o usuário limpou seus dados de navegador, o que remove a subscription push. Habilite **Auto Resubscribe** nas suas configurações de web push para reinscrever automaticamente usuários que retornam. Veja [Subscriptions](./subscriptions) para detalhes.
### 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 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](./web-push-setup-faq) 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](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy) 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. Consulte [Múltiplos sites e subdomínios](./web-push-setup-faq#multiple-sites--subdomains) para opções de configuração.
### 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. Para gerenciar vários domínios, redirecione usuários para uma única origem para inscrição ou crie apps OneSignal individuais por origem. Consulte [Múltiplos sites e subdomínios](./web-push-setup-faq#multiple-sites--subdomains) para estratégias detalhadas.
### Por que meu prompt de web push não está aparecendo?
Causas comuns incluem: o site não está sendo servido via HTTPS, o service worker não está registrado corretamente, o usuário já concedeu ou negou permissão, ou o usuário está no modo anônimo. Verifique o console do navegador para erros e veja [Notificações não mostradas](./notifications-not-shown-web-push) para uma lista completa.