Configuração de web push

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

Importante

Certifique-se de que o SDK de Web Push esteja devidamente integrado ao seu site. Esta é uma etapa obrigatória para permitir que os usuários se inscrevam e recebam notificações. Saiba mais

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

Configurar web push 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 da web nativamente.

Nota: Versões mais antigas do Safari (macOS 10.14–12) exigem 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 da 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á tiver chaves VAPID, por exemplo, do Firebase, e quiser 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 da 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 aplicativos ao enviar notificações push para navegadores da web. A chave pública é compartilhada com o navegador quando um usuário se inscreve para receber 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 Web Push

Usar configuração existente

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

Para isso:

1. Selecione Usar configuração existente.

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

3. No campo Chave Privada de 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 de 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 de Web Push no formulário de configuração da web do Pushwoosh.

Chave privada de 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 de Web Push funcionem corretamente.

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

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

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

Reconfigurar a configuração de web push

Se você já configurou as notificações push da 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 de Web Push: sua nova chave pública VAPID
   • Chave Privada de Web Push: sua nova chave privada VAPID

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

Importante

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

Configurar a solicitação de inscrição

Para enviar notificações push, os usuários devem conceder permissão explicitamente através da solicitação 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 depois que o usuário interage com a página (por exemplo, clicando em um botão). Para atender a esse requisito, o Pushwoosh exibe um widget de Solicitação de Inscrição por padrão. Este widget incentiva os usuários a optarem por participar e, mediante concordância, aciona a solicitação nativa do navegador.

Dica

Uma solicitação bem projetada 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 da solicitação, clique em Configurações.

Tipos de solicitação

Existem dois tipos de solicitações de inscrição disponíveis:

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

• Widget personalizado Use o design do seu próprio 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. Esta etapa é necessária 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 web push incluída na Configuração de Todos os Navegadores.

Obtenha as credenciais necessárias da Apple

1. Vá para a seção Certificates, Identifiers & Profiles 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 na solicitação 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.