Esta tarefa mostra como preparar a tela Configurações > Plataformas > Web Push da Context Cloud para que o seu site receba Web Push e exiba On Site Messages: URLs, funcionalidades, Service Worker e scripts. A customização da pré-permissão está em Referência da pré-permissão de Web Push — campos e regras.

Antes de começar

  • App Web criado na Context Cloud.
  • Lista dos domínios onde o script vai rodar (ex.: www.seusite.com.br).
  • Acesso para inserir código no <head> das páginas do site.
  • Decisão sobre onde hospedar o Service Worker: no seu servidor ou em um subdomínio inng.me da Inngage (ver tabela em "Passos", passo 5).

Passos

  1. Acesse Configurações > Plataformas > Web Push.
  2. Em URLs do Projeto, digite o domínio em Adicionar nova URL e clique em Adicionar. Repita para cada domínio. Use Editar ou Excluir para corrigir. A mesma URL não pode ser cadastrada duas vezes.
  3. Em Funcionalidades, ligue as opções que vai usar:
Opção O que faz
Ativar Web push Permite enviar notificações push para navegadores
Ativar On Site Messages Exibe mensagens On Site no site para os visitantes
Ativar Captura de Forms Captura automaticamente dados de formulários do site
Ativar logs de Script Registra eventos do script no console do navegador. Útil na implantação; desligue em produção
  1. Em Instalação do Service Worker, escolha o Modo de instalação:
Modo Quando usar Como funciona
Instalar Service Worker em Ambiente Próprio Você consegue publicar um arquivo no seu domínio Você baixa o arquivo, hospeda no seu servidor e informa diretório, nome e escopo. A permissão é pedida no seu próprio domínio
Configurar Service Worker Externo em Sub Ambiente Inngage Você não consegue instalar arquivos no servidor A Inngage hospeda o Service Worker em um subdomínio inng.me. Ao aceitar as notificações, o visitante é levado a um pop-up de opt-in nesse subdomínio
  1. Preencha os campos do modo escolhido:
Modo Campo Descrição
Ambiente Próprio Diretório do arquivo Onde o arquivo ficará hospedado
Ambiente Próprio Nome do arquivo Nome do arquivo do Service Worker
Ambiente Próprio Escopo do Registro Escopo em que o Service Worker será registrado
Ambiente Próprio Download Baixa o arquivo pronto. Ele deve ficar acessível no endereço exibido na tela
Sub Ambiente Inngage Nome do Subdomínio Ex.: minhaloja. Os visitantes serão inscritos em https://minhaloja.inng.me. O subdomínio precisa ser único; use Clique para visualizar para conferir
  1. Em Scripts, copie o Script de Configuração Web Push (integration.html) com Copiar e cole na página que vai pedir permissão de notificações, antes da tag </head>.
  2. (Opcional) Use o script Login e atributos do usuário (user-login.js) para identificar usuários logados, enviar campos personalizados e registrar e-mail e telefone. Substitua os valores de exemplo pelas variáveis do seu sistema.
  3. (Opcional) Use o script Eventos (events-tracking.html) para registrar eventos por meio do Pixel da Inngage, uma imagem invisível de 1 px cuja URL leva event_name (evento configurado), identifier ou registration (usuário) e app_token (chave do app).
  4. Configure a pré-permissão conforme Referência da pré-permissão de Web Push — campos e regras.

Como validar

  1. Abra o site em um navegador sem inscrição anterior.
  2. Aceite as notificações no pedido do navegador (ou no pop-up inng.me, no modo Sub Ambiente).
  3. No Envio Rápido, selecione o canal Web Push Notifications e use Enviar mensagem teste para o seu identifier. A notificação deve chegar no navegador.

Problemas comuns

  • O pedido de permissão não aparece → o Service Worker não está acessível no endereço informado → confira o arquivo no endereço exibido na tela e o Escopo do Registro.
  • A URL não é aceita em URLs do Projeto → a mesma URL já está cadastrada → edite a existente em vez de adicionar outra.
  • O subdomínio não é aceito → o nome já está em uso por outro app → escolha outro Nome do Subdomínio.
  • O On Site não aparece → Ativar On Site Messages está desligado ou o domínio não está em URLs do Projeto → ligue a opção e confira o domínio.