Configuração de push web

Para começar a enviar notificações push web com o Pushwoosh, você precisa configurar sua plataforma de push web e habilitar o prompt de inscrição mostrado aos usuários.

Importante

Certifique-se de que o SDK de Push Web está devidamente integrado ao seu site. Este é um passo obrigatório para permitir que os usuários se inscrevam e recebam notificações. Saiba mais

Para iniciar a configuração, vá para Configurações > Configuração da Plataforma > Notificações Push Web e clique em Configurar.

Configurar push web para todos os navegadores (exceto versões mais antigas do Safari)

Esta configuração se aplica a todos os navegadores modernos, incluindo as versões mais recentes do Safari, que agora suportam notificações push web nativamente.

Nota: Versões mais antigas do Safari (macOS 10.14–12) requerem uma configuração separada. Você pode configurar isso em uma seção dedicada. Saiba mais

Para iniciar a configuração, clique em Configurar em Configuração de todos os navegadores.

Na janela de configuração, escolha uma das seguintes opções:

• Criar uma nova configuração de push Recomendado se você não configurou anteriormente notificações push web através de outro serviço. O Pushwoosh gerará automaticamente um novo par de chaves VAPID.

• Usar configuração existente Escolha esta opção se você já possui chaves VAPID, por exemplo, do Firebase, e deseja continuar a usá-las sem pedir aos usuários para se inscreverem novamente.

Criar uma nova configuração de push

Escolha Criar uma nova configuração de push se você não configurou anteriormente notificações push web com outro serviço. O Pushwoosh gerará automaticamente as chaves VAPID (Voluntary Application Server Identification) necessárias para você.

O que são chaves VAPID?

As chaves VAPID são um par de chaves pública-privada usado no Protocolo Web Push para autenticar o servidor de aplicação ao enviar notificações push para navegadores web. A chave pública é compartilhada com o navegador quando um usuário se inscreve para notificações. A chave privada permanece no seu servidor e é usada para assinar com segurança cada mensagem que você envia.

Clique em Configurar para gerar e aplicar as chaves.

Uma vez criadas, o Pushwoosh usará automaticamente essas chaves na configuração do SDK. Saiba mais sobre a integração do SDK de Push Web

Usar configuração existente

Se você já possui chaves VAPID (como as geradas através do Firebase), pode reutilizá-las para configurar notificações push web no Pushwoosh.

Para isso:

1. Selecione Usar configuração existente.

2. No campo Certificado Web Push, insira sua chave pública VAPID.

3. No campo Chave Privada Web Push, insira sua chave privada VAPID.

4. Clique em Configurar para salvar e aplicar as configurações.

Como encontrar chaves VAPID no Firebase

Se você está migrando do Firebase e precisa reutilizar suas chaves VAPID existentes, siga estes passos para encontrá-las.

Certificado Web Push

1. No Firebase, navegue para Configurações do Projeto → Cloud Messaging.
2. Role para baixo até a seção Configuração da Web e copie o par de chaves existente.

3. Cole-o no campo Certificado Web Push no formulário de configuração web do Pushwoosh.

Chave privada Web Push

1. No Console do Firebase, vá para Configurações do Projeto → Cloud Messaging → Configuração da Web.
2. Clique no menu de três pontos em Ações ao lado do par de chaves e selecione Mostrar chave privada. Esta chave é essencial para garantir que as notificações Web Push funcionem corretamente.

3. Copie a chave exibida para a sua área de transferência.

4. No formulário de Configuração Web do Pushwoosh, cole-a no campo Chave Privada Web Push.

5. Clique em Aplicar para salvar suas alterações.

Reconfigurar a configuração de push web

Se você já configurou notificações push web, mas precisa atualizar suas credenciais (como substituir suas chaves VAPID), veja como fazer:

1. Clique em Reconfigurar em Configuração de todos os navegadores.

2. No pop-up que aparece, insira suas novas chaves VAPID:

   • Certificado Web Push: sua nova chave pública VAPID
   • Chave Privada Web Push: sua nova chave privada VAPID

3. Clique em Configurar para salvar as alterações.

Importante

Substituir suas chaves VAPID afeta toda a sua configuração de push web e pode interromper a entrega de notificações se não for gerenciado corretamente. Altere as chaves apenas se for realmente necessário e certifique-se de entender o impacto antes de fazer qualquer atualização.

Configurar o prompt de inscrição

Para enviar notificações push, os usuários devem conceder permissão explicitamente através do prompt do sistema do navegador. Sem essa permissão, as notificações não podem ser entregues.

Devido às recentes mudanças nas políticas do Chrome e Firefox, o pop-up de permissão nativo só pode aparecer após o usuário interagir com a página (por exemplo, clicando em um botão). Para atender a esse requisito, o Pushwoosh exibe um widget de Prompt de Inscrição por padrão. Este widget incentiva os usuários a optarem por receber e, mediante concordância, aciona o prompt nativo do navegador.

Dica

Um prompt bem projetado explicando o valor das notificações (por exemplo, “Receba as últimas notícias e atualizações”) pode melhorar significativamente as taxas de adesão.

Para personalizar o texto e a aparência do prompt, clique em Configurações.

Tipos de prompt

Existem dois tipos de prompts de inscrição disponíveis:

• Widget padrão Fornecido pelo Pushwoosh e exibido automaticamente. Aprenda a personalizar o widget padrão.

• Widget personalizado Use seu próprio design de widget. Saiba mais

Nota: Devido a limitações da plataforma, as alterações no widget podem levar até 30 minutos para aparecer. Se as alterações não forem refletidas, entre em contato com a equipe de Suporte do Pushwoosh.

Configuração do Safari (macOS 10.14–12)

Para suportar notificações push em versões mais antigas do Safari (macOS 10.14–12), você precisa concluir um processo de configuração separado usando suas credenciais de Desenvolvedor Apple. Este passo é necessário apenas para essas versões mais antigas, pois as versões mais recentes do Safari (macOS Ventura e posterior) suportam a configuração padrão de push web incluída na Configuração de Todos os Navegadores.

Obtenha as credenciais necessárias da Apple

1. Vá para a seção Certificados, Identificadores e Perfis do Portal do Desenvolvedor Apple.

2. Adicione um novo certificado.

3. Escolha o tipo Website Push ID Certificate e clique em Continuar.

4. Selecione o Website Push ID - sua string de domínio reverso única, como web.com.example.domain (deve começar com web.).

5. Faça o upload de uma Solicitação de Assinatura de Certificado. Para saber mais sobre como criar Solicitações de Assinatura de Certificado, consulte o artigo de Ajuda da Conta de Desenvolvedor.

6. Depois, baixe o certificado de notificação push.

Nota

O certificado que você baixa da Apple é um arquivo .cer. Para obter o arquivo .p12 necessário para configurar o Pushwoosh, você deve exportar uma chave privada. Veja detalhes no guia de Configuração do iOS.

Configurar o Safari no Pushwoosh

1. Clique em Configurar em Configuração do Safari.

2. Preencha os seguintes campos no formulário de configuração:

Nome do site	O nome do seu site que aparece no prompt de push.
Domínios permitidos	Lista de domínios autorizados a solicitar permissão de notificação (um por linha).
Modelo de URL	URL aberta quando um usuário clica na notificação. Suporta placeholders como %@ para inserir valores dinâmicos. Exemplo: https://yourwebsite.com/%@
Ícone do site	Faça o upload de uma imagem PNG quadrada (256×256 px). O Pushwoosh a redimensiona automaticamente para diferentes interfaces.
Arquivo de chave	Faça o upload do certificado .p12 exportado da sua conta de Desenvolvedor Apple.
Senha da chave privada	Senha usada ao exportar o arquivo .p12.

3. Clique em Configurar para salvar suas alterações.

O Pushwoosh gerará automaticamente o pacote de push com o conjunto de ícones, o dicionário JSON do site e o arquivo de manifesto que o Safari solicita do servidor. Você pode baixá-lo sempre que precisar.

Importante

Quando um usuário é solicitado a dar permissão para receber notificações push, o Safari solicita ao servidor web do Pushwoosh um push package. O pacote contém dados usados pela interface de notificação, como o nome e o ícone do seu site, bem como uma assinatura criptográfica que verifica se a sua notificação está vindo de uma fonte confiável: você.

O pacote de push com todo o seu conteúdo é baixado APENAS UMA VEZ por cada usuário inscrito no momento do registro e não pode ser atualizado à força nos dispositivos.

Considere isso ao lançar notificações push do Safari para o seu site em produção.