# 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. Para iniciar a configuração, vá para **Configurações > Configuração da Plataforma > Notificações Push Web** e clique em **Configurar**. ![Configurar notificações push web](/web-configuration-1.webp) ## 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**. ![Configurar push web para todos os navegadores](/web-configuration-2.webp) 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. ![Criar uma nova configuração de push](/web-configuration-3.webp) 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](/pt/developer/pushwoosh-sdk/web-push-notifications/web-push-sdk-30/) ### 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. ![Usar configuração existente](/web-configuration-4.webp) #### 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. ![Encontrar Certificado de Push Web](/web-configuration-6.webp) 3. Cole-o no campo **Certificado de Push Web** no formulário de configuração web do Pushwoosh. ![Cole no campo **Certificado de Push Web**](/web-configuration-7.webp) ##### 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. ![Encontrar Chave Privada de Push Web](/web-configuration-8.webp) 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**. ![Colar Chave Privada de Push Web](/web-configuration-9.webp) 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**. ![Reconfigurar a configuração de push web](/web-configuration-5.webp) 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. ### 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](/pt/developer/guides/messaging-channels/subscription-prompt/) por padrão. Este widget incentiva os usuários a optarem por receber e, mediante concordância, aciona a solicitação nativa do navegador. Para personalizar o texto e a aparência da solicitação, clique em **Configurações**. ![Configurar a solicitação de inscrição](/web-configuration-16.webp) #### 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](/pt/developer/guides/messaging-channels/subscription-prompt/default-widget/). * **Widget personalizado** Use o design do seu próprio widget. [Saiba mais](/pt/developer/guides/messaging-channels/subscription-prompt/custom-subscription-widget/) > **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](#configurar-push-web-para-todos-os-navegadores-exceto-versões-mais-antigas-do-safari). #### Obtenha as credenciais necessárias da Apple 1. Vá para a seção [Certificados, Identificadores e Perfis](https://developer.apple.com/account/overview.action) do Portal do Desenvolvedor da Apple. 2. Adicione um novo certificado. Opção de adicionar novo certificado no Portal do Desenvolvedor da Apple 3. Escolha o tipo **Certificado de ID de Push de Site** e clique em **Continuar**. Seleção do tipo de Certificado de ID de Push de Site no Portal do Desenvolvedor da Apple 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._). Seleção de ID de Push de Site no Portal do Desenvolvedor da Apple 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](https://developer.apple.com/help/account/create-certificates/create-a-certificate-signing-request). 6. Depois, baixe o certificado de notificação push. Baixar certificado de notificação push do Portal do Desenvolvedor da Apple #### Configurar o Safari no Pushwoosh 1. Clique em **Configurar** em **Configuração do Safari**. ![Configurar o Safari no Pushwoosh](/web-configuration-11.webp) 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`. | ![Preencher o formulário de configuração do Safari](/web-configuration-12.webp) 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.