Visão Geral
“Prompting” refere-se ao processo de pedir permissão aos usuários para enviar-lhes mensagens. Os prompts são mensagens pop-up apresentadas no navegador ou aplicativo móvel e exigem que o usuário clique em “Permitir” para ser inscrito e receber mensagens. Este guia cobre os diferentes tipos de prompts web e como configurá-los. O push web funciona em desktop, Android e iOS, mas o web push para iOS requer etapas adicionais. Se você tem um aplicativo móvel, veja como solicitar Permissões Push com Mensagens no Aplicativo. Os navegadores fornecem seu próprio prompt de permissão nativo em nível de sistema, que é obrigatório ser mostrado e clicado em “Permitir” para que o usuário se inscreva para notificações push em seu site. Os navegadores agora recomendam fortemente que os sites sejam mais seletivos quando se trata de mostrar o prompt de permissão nativo. É por isso que usar Prompts do OneSignal ou seus próprios “prompts suaves” personalizados antes do prompt nativo é incentivado.Prompts do OneSignal (prompts suaves)
Os prompts suaves do OneSignal são prompts amigáveis e personalizáveis que aparecem antes do prompt de permissão nativo do navegador. Esses prompts não inscrevem os usuários para mensagens por si mesmos; em vez disso, eles ajudam a:- Explicar o valor de se inscrever para mensagens (push, email ou SMS).
- Evitar que os navegadores bloqueiem automaticamente solicitações de permissão.
- Lançar o prompt nativo do navegador somente depois que o usuário expressar interesse.
Ícone do prompt
Defina um Ícone Padrão em Configurações > Push & In-App > Web. Este ícone aparece nas notificações push web e nos prompts, a menos que você o substitua por mensagem.- Formatos aceitos: PNG, JPG ou GIF não animado
- Tamanho recomendado:
256×256pixels - Se não for definido, o OneSignal usa um ícone de sino genérico

Seção de configuração do site das configurações de push web
Configuração do prompt de permissão
Configure os prompts que você deseja exibir em seu site. No painel do OneSignal, navegue até: Configurações > Push & In-App > Configurações Web > Configuração do Prompt de Permissão. A partir daí, clique em Adicionar Prompt para escolher entre os tipos de prompt disponíveis do OneSignal. Você também pode editar quaisquer prompts existentes já mostrados na lista.
Adicione novos prompts ou selecione o prompt que você deseja editar
- Slidedown: Um prompt visualmente proeminente usado para notificações push e seleção opcional de categoria.
- Prompt de Email/Telefone: Usado para coletar endereços de email de usuários, números de telefone ou ambos.
- Prompt de sino de assinatura: Um widget flutuante persistente para assinaturas push, normalmente colocado no canto inferior do seu site.
- Prompt de link personalizado: Um botão ou link personalizável incorporado em seu site que aciona o prompt nativo do navegador.
- Prompt de permissão nativo: O prompt obrigatório em nível de navegador que deve ser aceito para que os usuários recebam notificações push.
Slidedown & category
Os prompts Slide e Category aparecem de forma proeminente no centro superior da tela no desktop e centro inferior no mobile. Estes são prompts suaves de alta visibilidade mostrados antes do prompt de permissão nativo obrigatório. Eles não inscrevem o usuário por conta própria, mas ajudam a iniciar o fluxo de assinatura e capturar o interesse do usuário.
Prompt slide com tags de categoria
- Vá para Configurações > Push & In-App > Configurações Web > Configuração do Prompt de Permissão
- Selecione Adicionar Prompt > Prompt Push > Prompt Slide Push
slidedown no objeto promptOptions do seu código init do OneSignal. Veja Referência do SDK Web para mais detalhes.

Opções do prompt slide push
Texto do prompt slide
Você pode personalizar o texto exibido no prompt slide:- Mensagem de ação: até 90 caracteres
- Rótulos dos botões: até 15 caracteres cada
- A personalização de fonte, tamanho ou cores não é suportada atualmente

Opções de texto do prompt slide
text dentro do objeto promptOptions do seu código init do OneSignal. Veja Referência do SDK Web para mais detalhes.Categorias
Você pode aprimorar o prompt Slidedown adicionando categorias—caixas de seleção que permitem aos usuários indicar interesse em tópicos de mensagens específicos (por exemplo, Notícias, Vendas, Atualizações).- Até 10 categorias permitidas
- Cada categoria é armazenada como uma Tag de Dados com
1(selecionada) ou0(não selecionada) - Útil para segmentação e direcionamento de mensagens por preferências do usuário
- Rótulo: o que o usuário vê no prompt. Recomenda-se colocar a primeira letra em maiúscula.
- Chave da Tag: o que a tag será no OneSignal. Use a convenção de nomenclatura
cat_<category>(letras minúsculas, sublinhados para espaços) — por exemplo,cat_breaking_news,cat_sports,cat_apparel. Isso corresponde à convenção usada nos guias de indústria do OneSignal e permite que o mesmo namespace de Tags seja preenchido automaticamente a partir do comportamento de visita a páginas. Veja Marcar usuários por tópico de página para o padrão de auto-tag. - Instruções de Atualização, Botões Positivo e Negativo: se você optar por exibir o prompt de categoria novamente depois que o usuário já estiver inscrito para push, as instruções de atualização serão mostradas em vez da mensagem de ação. Isso permite que você informe ao usuário que ele pode atualizar suas categorias.

Configuração de categoria com rótulo e chave da tag
categories dentro do objeto promptOptions do seu código init do OneSignal. Veja Referência do SDK Web para mais detalhes.Prompt de email e número de telefone
O Prompt de Email e Telefone coleta informações de contato opcionais do usuário diretamente dentro de um Slidedown. Cada campo possui validação integrada para garantir a formatação correta. Uma vez enviado:- Novas assinaturas de Email e/ou SMS são criadas para o usuário
- Você pode começar a enviar mensagens para eles por meio desses canais
- Navegue até Configurações > Push & In-App > Configurações Web > Configuração do Prompt de Permissão > Adicionar Prompt > Prompt de Email/Telefone.

Configuração do prompt de email e número de telefone

Opções do prompt de email e número de telefone
promptOptions do seu código init do OneSignal, adicione o type como email, sms ou smsAndEmail. Veja Referência do SDK Web para mais detalhes.Prompt de sino de assinatura
O Prompt de Sino de Assinatura é um pequeno widget persistente que aparece no canto inferior do seu site. Quando clicado por um usuário não inscrito, ele aciona o Prompt Nativo do Navegador. Devido à sua pegada mínima, o sino pode permanecer visível o tempo todo, tornando-o uma opção passiva, mas eficaz, para oportunidades contínuas de adesão. Ele não requer descarte e fornece aos usuários controle sobre quando se inscrever.
Widget do prompt de sino de assinatura
Configuração Típica de Site e WordPress: Prompt de Sino de Assinatura
Configuração Típica de Site e WordPress: Prompt de Sino de Assinatura
- Cor
- Tamanho
- Posição inferior (esquerda ou direita)
- Texto e rótulos

Configuração do sino de assinatura no painel
Configuração de Código Personalizado: Prompt de Sino de Assinatura
Configuração de Código Personalizado: Prompt de Sino de Assinatura
notifyButton nas opções de inicialização do seu SDK web. Você pode alternar entre diferentes exemplos para personalizações do Prompt de Sino.Ocultar: Para ocultar o sino de assinatura depois que um usuário se inscrever ou mostrá-lo apenas em certas páginas, certifique-se de retornar o valor false ou uma Promise que resolve para o valor false na função displayPredicate durante a inicialização. Esta função é avaliada antes do sino de assinatura ser mostrado. Você pode retornar qualquer outro valor para mostrar o sino de assinatura.Prompt de link personalizado
O Prompt de Link Personalizado é um botão ou link acionado pelo usuário que você pode incorporar em qualquer lugar do seu site. Quando clicado, ele exibe o Prompt Nativo do Navegador para notificações push.
Exemplo de prompt de link personalizado
- Abaixo de uma postagem de blog: “Gostou deste artigo? Receba atualizações assim que publicarmos!”
- No rodapé do seu site
- Em um cabeçalho fixo ou barra de ferramentas flutuante
Configuração Típica de Site e WordPress: Prompt de Link Personalizado
Configuração Típica de Site e WordPress: Prompt de Link Personalizado

Configuração de link personalizado no painel
Configuração de Código Personalizado: Link Personalizado
Configuração de Código Personalizado: Link Personalizado
promptOptions do seu código init do OneSignal, adicione o objeto customlink e suas propriedades disponíveis.Configuração Típica e de Código Personalizado: Estilização Adicional
Configuração Típica e de Código Personalizado: Estilização Adicional
onesignal-reset que remove qualquer estilização anterior do elemento para garantir que não haja conflito com nossos estilos internos e que pareça exatamente como você o definiu no painel.Se você se encontrar precisando redefinir quaisquer estilos do OneSignal, aqui está uma breve referência das classes usadas no widget de Link PersonalizadoPrompt de permissão nativo
O prompt de permissão nativo é o diálogo controlado pelo navegador que os usuários devem aceitar para se inscrever para notificações push do seu site. Este prompt é:- Obrigatório para assinatura
- Automaticamente acionado após prompts suaves do OneSignal
- Não personalizável em aparência, texto ou comportamento

Prompt de permissão nativo no Chrome
Comportamento do prompt nativo do navegador
Diferentes navegadores impõem comportamentos e restrições únicos para reduzir solicitações de permissão spam. Em um esforço para combater spam e má experiência do usuário, o OneSignal automaticamente usará o Prompt Slide por padrão em certos casos listados abaixo. Se você não quiser mostrar o Prompt Slide e gostaria de usar o prompt de permissão nativo diretamente, você deve desativar as opções de Prompt Automático e usar nosso métodorequestPermission() do SDK Web. Exibir o prompt de permissão nativo diretamente pode não funcionar em todos os navegadores conforme descrito abaixo.
Chrome
Chrome 80+ pode exibir uma UI mais discreta em vez do prompt completo:- Aplica-se automaticamente a usuários que frequentemente negam prompts
- Também se aplica a sites com uma alta taxa de negações

UI de notificação mais discreta no Chrome desktop
- Você tem 3 tentativas para solicitar
- Após a 3ª dispensa, o prompt é suprimido por 7 dias (fonte).
Firefox
Firefox 72+ começou a exigir um gesto do usuário para acionar o prompt de permissão nativo. Se você tentar mostrar automaticamente o prompt de permissão nativo no Firefox, você verá um ícone dentro do navegador assim, exigindo que o usuário clique no ícone para mostrar o prompt de permissão nativo.
Ícone de permissão de notificação do Firefox
Safari
Safari 12.1+ começou a exigir um gesto do usuário para acionar o prompt de permissão nativo.Edge
Edge usa um modelo baseado em confiança:- Se o site não for confiável, o prompt é suprimido e substituído por um ícone de sino na barra do navegador:

Ícone de sino para sites não confiáveis no Edge
- Se o site for confiável, o prompt nativo aparece normalmente:

Prompt nativo para sites confiáveis no Edge
Configurações de exibição e prompt automático
Para maximizar o engajamento e evitar interromper seus usuários, é melhor atrasar a exibição de prompts até que eles tenham passado algum tempo no seu site. O OneSignal permite que você exiba automaticamente prompts com base no comportamento do usuário usando duas condições de atraso:- Visualizações de Página: Número de vezes que o usuário carrega qualquer página do seu site
- Segundos na Página: Quantidade de tempo que o usuário deve passar na página
Configuração Típica de Site e WordPress: Prompt Automático
Configuração Típica de Site e WordPress: Prompt Automático
- Navegue até: Configurações > Push & In-App > Configurações Web > Configuração do Prompt de Permissão
- Escolha um prompt ou crie um novo
- Ative o Prompt Automático
- Defina suas preferências de atraso (visualizações de página e atraso de tempo)

Configurações de atraso do prompt automático
- Clique em Concluído, depois em Salvar
Configuração de Código Personalizado: Prompt Automático
Configuração de Código Personalizado: Prompt Automático
promptOptions do seu código init do OneSignal, use as opções autoPrompt e delay. Também existem métodos para acionar os prompts slidedown ou nativos desejados diretamente. Veja Referência do SDK Web para mais detalhes.Acionamento Manual (Em vez de Prompt Automático)
Acionamento Manual (Em vez de Prompt Automático)
- Desative o Prompt Automático
- Use os métodos de Slidedown ou Prompt Nativo do SDK para mostrar o prompt via código
Lógica de recuo do prompt slidedown
Uma vez que um prompt Slidedown (Push, Categoria ou Email/Telefone) é mostrado e dispensado (via Permitir, Cancelar ou fechar o diálogo), ele recuará e reaparecerá em um cronograma definido:Melhores práticas para solicitar permissões de push web
Fazer com que os usuários concedam permissões de push web requer o momento certo, confiança e design amigável ao usuário. Siga estas melhores práticas para maximizar as taxas de adesão enquanto mantém uma experiência positiva no site.Seja estratégico sobre quando perguntar
O momento é mais importante do que a frequência. Exiba prompts de permissão quando os usuários já estiverem engajados ou mostrando intenção. Por exemplo:- Depois que eles adicionarem um item ao carrinho ou interagirem com uma postagem ou comentário
- Quando atualizarem seu perfil ou fizerem login em sua conta
- Após a conclusão de uma ação que mostre comprometimento com sua marca
Use o prompt de sino de assinatura
O prompt de sino é uma maneira persistente e não intrusiva para os usuários se inscreverem a qualquer momento. Este ícone de sino flutuante é ideal para engajamento de longo prazo porque:- Mantém a opção de assinatura visível sem interromper a navegação.
- Permite que os usuários se inscrevam quando escolherem.
- Constrói confiança ao não forçar solicitações de permissão imediatas.
Deixe os usuários personalizarem suas assinaturas com categorias
O prompt de categoria permite que os usuários escolham quais tópicos ou tipos de mensagem desejam—como “Promoções”, “Atualizações de Produto” ou “Postagens de Blog”. Esta abordagem:- Faz com que o prompt pareça menos intrusivo e mais relevante
- Melhora o engajamento e as taxas de cliques nas mensagens
- Reduz opt-outs posteriores ao definir expectativas antecipadamente
Teste e otimize ao longo do tempo
Não confie em uma única estratégia. Teste diferentes tipos de prompt, mensagens e momentos para ver o que ressoa com seu público. Tente esta abordagem:- Comece com o prompt nativo do navegador por alguns meses para medir sua taxa de adesão de linha de base.
- Após coletar dados, experimente com o prompt slidedown ou fluxos de prompt personalizados para melhorar as conversões em navegadores e segmentos de público.
- Rastreie o desempenho usando os eventos
permissionPromptDisplayepermissionChangee os eventosslidedowndo nosso SDK.
FAQ
Problemas de exibição de prompt
O prompt de permissão nativo de um navegador pode não ser mostrado se alguma das seguintes condições for verdadeira: 1. O navegador bloqueou a exibição do prompt. Navegue até as configurações do navegador e verifique a configuração de permissão de “Notificações”. Exemplo do Chrome:chrome://settings/content/notifications

Configurações de notificação do Chrome
- O usuário selecionou “Não permitir que sites enviem notificações”, o que impedirá a exibição do prompt de permissão nativo. Isso deve mostrar “Sites podem solicitar para enviar notificações” para permitir que o prompt de permissão nativo seja mostrado.
- O usuário adicionou
https://yoursite.comà lista “Não permitido enviar notificações”, o que impedirá a exibição do prompt de permissão nativo. Deve ser removido da lista para permitir que o prompt de permissão nativo seja mostrado.
- Chrome - Esta página explica como gerenciar notificações no Chrome navegando para Configurações > Privacidade e segurança > Configurações do site > Notificações, onde você pode controlar o comportamento padrão e gerenciar permissões para sites individuais.
- Firefox - Este guia cobre as notificações Web Push do Firefox, explicando como gerenciar permissões de notificação através de Configurações > Privacidade e Segurança > Notificações, e como controlar permissões para sites específicos através do ícone de informações do site na barra de endereços.
- Safari - Este guia da Apple explica como personalizar notificações do Safari no Mac através de Safari > Preferências > Sites > Notificações, onde você pode gerenciar quais sites podem enviar notificações e controlar o comportamento das notificações através das Preferências do Sistema.
- Edge - Este artigo detalha como gerenciar notificações no Edge navegando para Configurações > Privacidade, pesquisa e serviços > Permissões de site > Notificações, ou clicando no ícone de informações do site na barra de endereços.
Como mostro prompts em um webview de aplicativo de mídia social?
Webviews usados por aplicativos de mídia social (Instagram, TikTok, Facebook, etc.) não suportam notificações push na web. O aplicativo deve abrir seu site em um navegador completo que suporte push na web.Por que o prompt slide continua aparecendo?
Existem duas causas comuns:- Você está no modo anônimo, modo de navegador privado ou modo de navegador convidado.
- Você está acionando o prompt programaticamente sem usar a opção de Prompt Automático. Veja a Referência do SDK Web e verifique os métodos de prompt que você está usando.
Após dispensar um prompt, quando ele é mostrado novamente?
Para prompts do OneSignal, veja Lógica de recuo do prompt slidedown. Para o prompt de permissão nativo, veja Comportamento do prompt nativo do navegador.Por que vejo o prompt slide em vez do prompt nativo do navegador?
Certos navegadores exigem um gesto do usuário antes de mostrar o prompt nativo. O OneSignal automaticamente mostra um prompt slide primeiro nesses casos. Veja Comportamento do prompt nativo do navegador para detalhes.Como traduzo ou localizo o prompt?
Use a Configuração de Código Personalizado para detectar programaticamente o idioma do navegador do usuário e inicializar o SDK do OneSignal com textos diferentes. O prompt de permissão nativo é traduzido automaticamente para o idioma definido no navegador.Posso fazer teste A/B de prompts?
Sim. Usando a Configuração de Código Personalizado, você pode inicializar o OneSignal com diferentes opções de prompt. Você precisa configurar seu próprio método para acionar os testes A/B. Use o evento Mudança de Assinatura para detectar quando um usuário se inscreve e adicionar Tags com base em qual variante venceu.Posso segmentar assinaturas com base na página em que se inscreveram?
Sim. Veja o guia Segmentação Automática por Página de Assinatura.Posso alterar o ícone do sino?
Não. Você não pode alterar a imagem do sino, mas pode personalizar as cores, o texto e a posição (inferior esquerda ou inferior direita).Por que minha auditoria de acessibilidade sinaliza o sino de assinatura?
As versões atuais do SDK Web dão ao botão do sino um nome acessível padrão de “Manage notifications”, então ele passa na verificação “buttons must have discernible text” usada pelo Lighthouse, PageSpeed Insights e axe. Para alterar ou localizar o rótulo, defina a chavelauncher.button.aria-label em notifyButton.text usando a Configuração de Código Personalizado.
Posso alterar as categorias com base na página?
Sim, de duas maneiras. Para mostrar caixas de seleção de categorias diferentes em páginas diferentes, use a Configuração de Código Personalizado e configure ascategories de promptOptions por página. Para aplicar automaticamente Tags cat_<category> conforme os leitores navegam (sem mostrar um prompt), veja Marcar usuários por tópico de página — o padrão de auto-tag usa o mesmo namespace de Tags que o Prompt de Categoria, então as duas abordagens se combinam perfeitamente.
Como rastreio eventos do prompt slide?
O SDK Web do OneSignal fornece Métodos de Evento do Prompt Slide para detectar quando o prompt é mostrado, fechado ou recebe uma ação de “Permitir” ou “Cancelar”.Como posso mostrar o prompt apenas em certas páginas?
Desative o Prompt Automático, depois use o método do SDK de prompt Slidedown nas páginas específicas onde você deseja que os prompts apareçam. O prompt de Sino não pode ser desativado página por página.Por que vejo o prompt slide no mobile em vez do prompt nativo?
O Chrome para Android exibe um prompt nativo em tela cheia que interrompe a experiência de navegação. O OneSignal mostra um prompt slide primeiro para fornecer uma melhor experiência ao usuário. Para contornar isso, desative o Prompt Automático no Editor de Prompts e use o métodorequestPermission() do SDK Web.