Como verificar o estado da subscrição push de visitantes do site

Ao construir uma estratégia de comunicação robusta e eficaz utilizando notificações push da web, é crucial conhecer o estado de subscrição dos visitantes do seu website. Isto é especialmente importante se conectar a sua base de dados existente à sua lista de subscritores de push.

Compreender se os seus utilizadores com sessão iniciada estão subscritos em notificações push permite-lhe adaptar a sua mensagem, criar experiências mais personalizadas e maximizar a taxa de envolvimento das suas notificações. Esta documentação irá guiá-lo através do processo de utilização da nossa API para verificar o estado de subscrição dos visitantes do seu website.

Verificar o Estado de Subscrição Utilizando o Web SDK

Antes de verificar o estado de subscrição, certifique-se de que a instalação do PushEngage está completa. Se não tiver isto integrado, siga este guia e complete a sua instalação.

Aqui o método getPermission() é uma forma direta de determinar o estado de subscrição de um utilizador. Este método retorna o estado atual da permissão de notificação push do utilizador que visita o seu website.

A sintaxe para este Método é:

getPermission().then(successFunctionCallback).catch(errorFunctionCallback);

Pode utilizá-lo da seguinte forma

PushEngage.push(function () {
  PushEngage.getPermission()
    .then(function (notificationPermission) {
      console.log(notificationPermission);
    })
    .catch(function (error) {
      console.log(error.message, error.details);
    });
});

Se estiver a lidar com múltiplos casos com base em respostas ou no estado de permissão do utilizador. Pode utilizar o código de exemplo abaixo:

// Check the user's push notification subscription status
PushEngage.getPermission().then(function(permissionStatus) {
    console.log("User's push subscription status: ", permissionStatus);
    
    // Handle different subscription statuses
    switch(permissionStatus) {
        case 'default':
            console.log("User has not yet made a decision about push notifications.");
            break;
        case 'granted':
            console.log("User has granted permission for push notifications.");
            break;
        case 'denied':
            console.log("User has denied permission for push notifications.");
            break;
        default:
            console.log("Unknown permission status.");
    }
}).catch(function(error) {
    console.error("An error occurred while checking the subscription status: ", error);
});

O método getPermission() retorna um dos três valores possíveis:

  • default: O utilizador ainda não tomou uma decisão relativamente a notificações push.
  • granted: O utilizador concedeu permissão para receber notificações push.
  • denied: O utilizador negou permissão para receber notificações push.

Com base nestes valores, pode decidir como interagir eficazmente com os seus utilizadores. Por exemplo, se o estado for default, pode querer solicitar ao utilizador que opte por receber notificações push. Se o estado for denied, pode optar por oferecer um método de interação alternativo.

Caso se depare com algum problema, não hesite em contactar-nos clicando aqui. A nossa equipa de suporte poderá ajudá-lo.

Última atualização em 9 de março de 2026

Interaja e Mantenha Visitantes Depois de Saírem do Seu Website

Aumente o valor de cada visita web com Notificações Push que são difíceis de ignorar.

  • Plano Gratuito para Sempre
  • Configuração Fácil
  • Suporte 5 Estrelas