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 ativar a solicitação de inscrição mostrada 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 irá 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 irá 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 usadas 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 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 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 de Push Web, insira sua chave pública VAPID.

3. No campo Chave Privada de Push Web, 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 Push Web

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

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

Chave Privada de Push Web

1. No Console do Firebase, vá para Configurações do Projeto → Cloud Messaging → Configuração 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 Push Web 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 de Push Web.

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

Reconfigurar a configuração de push web

Se você já configurou as 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 de Push Web: sua nova chave pública VAPID
   • Chave Privada de Push Web: 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 push web 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 a mudanças recentes nas políticas do Chrome e Firefox, o pop-up de permissão nativo só pode aparecer após a interação do usuário 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 receber 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 da 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 da Apple.

2. Adicione um novo certificado.

3. Escolha o tipo Certificado de ID de Push de Site e clique em Continuar.

4. Selecione o ID de Push de Site - 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://seusite.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 da Apple.
Senha da chave privada	Senha usada ao exportar o arquivo .p12.

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

O Pushwoosh irá 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 pacote de push. 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.