Ao tentar ativar notificações push web no Mastodon, você pode ver o erro Push Notification Failed. Isso impede que o navegador envie alertas em tempo real para respostas, impulsionamentos e seguidores. O erro geralmente ocorre porque o navegador não consegue registrar um service worker ou o endpoint de assinatura push está bloqueado. Este artigo explica os três principais motivos para a falha e fornece correções passo a passo para cada causa.
Principais conclusões: Corrigindo falha de notificação push no Mastodon
- Preferências > Notificações > Notificações Push Web: Alterne essa opção para ligar e desligar para re-registrar a assinatura push.
- Ferramentas do Desenvolvedor do Navegador > Aplicativo > Service Workers: Verifique se o service worker está registrado e em execução.
- Configurações do Navegador > Permissões do Site > Notificações: Certifique-se de que o Mastodon tem permissão para enviar notificações.
Por que o erro Push Notification Failed ocorre
O Mastodon usa a Web Push API para enviar notificações do servidor para o seu navegador. O processo requer três coisas funcionando juntas: um service worker registrado no navegador, um objeto de assinatura push válido e uma URL de endpoint push acessível. Se qualquer uma dessas etapas falhar, o navegador exibe Push Notification Failed.
As causas raiz mais comuns são:
- Service worker não registrado: O navegador não encontra ou não consegue iniciar o arquivo JavaScript que lida com eventos push.
- Notificações bloqueadas nas permissões do navegador: O site teve a permissão de Notificação negada.
- Endpoint push inacessível: Um firewall, proxy ou extensão do navegador bloqueia a conexão com o servidor push.
Causas menos comuns incluem uma assinatura push expirada ou um navegador que não suporta a Web Push API. Este guia cobre todos os cenários.
Passos para corrigir Push Notification Failed no Mastodon
- Verifique e ative as permissões de notificação do navegador para o Mastodon
Abra as configurações do navegador e vá para Permissões do Site ou Privacidade e Segurança. Encontre a URL da instância do Mastodon e defina a permissão de Notificação como Permitir. Se estiver usando Chrome, vá em Configurações > Privacidade e Segurança > Configurações do Site > Notificações e adicione sua instância do Mastodon à lista Permitir. - Re-registre a assinatura push nas preferências do Mastodon
Faça login na sua conta do Mastodon. Vá em Preferências > Notificações. Role até Notificações Push Web. Se a opção estiver ativada, desligue-a. Aguarde 10 segundos e ligue-a novamente. Isso envia uma nova solicitação de assinatura push para o navegador. - Verifique se o service worker está registrado
Abra as Ferramentas do Desenvolvedor do navegador (F12). Vá para a guia Aplicativo. No Chrome, selecione Service Workers no menu à esquerda. Você deve ver um service worker registrado para sua instância do Mastodon com o status Running. Se o status for Error ou Stopped, clique em Unregister, recarregue a página do Mastodon e repita o passo 2. - Limpe a assinatura push e o cache do service worker
No mesmo painel de Ferramentas do Desenvolvedor, vá em Armazenamento ou Cache Storage. Exclua todas as entradas relacionadas à sua instância do Mastodon. Depois, vá ao painel Service Workers e clique em Unregister. Recarregue a página do Mastodon e ative as notificações push web novamente em Preferências. - Desative extensões do navegador que bloqueiam APIs push
Extensões como uBlock Origin, Privacy Badger ou NoScript podem bloquear o registro do service worker ou o endpoint push. Desative temporariamente todas as extensões, recarregue o Mastodon e tente ativar as notificações push novamente. Se o erro desaparecer, reative as extensões uma por uma para encontrar a culpada. - Verifique interferência de firewall corporativo ou VPN
Algumas redes corporativas ou VPNs bloqueiam conexões WebSocket ou endpoints push. Tente acessar o Mastodon de uma rede diferente, como um hotspot móvel. Se o erro desaparecer, a rede está bloqueando push. Entre em contato com o departamento de TI ou mude para um provedor de VPN que permita tráfego WebSocket. - Atualize seu navegador para uma versão que suporte Web Push
O push web do Mastodon requer um navegador que suporte a Push API e Service Workers. Navegadores compatíveis incluem Chrome 50+, Firefox 44+, Edge 17+ e Safari 16+. Opera e Brave também funcionam. Se você usa um navegador desatualizado, atualize-o para a versão mais recente.
Se o Mastodon ainda mostrar Push Notification Failed após a correção principal
Assinatura push expirou e não pode ser renovada
Cada assinatura push tem um tempo de vida. Alguns navegadores expiram assinaturas após 24 horas. Se você não visitar o Mastodon por um longo período, a assinatura se torna inválida. Para corrigir, faça login no Mastodon, vá em Preferências > Notificações, desligue Notificações Push Web, salve, depois ligue novamente. Isso cria uma nova assinatura.
O servidor da instância do Mastodon bloqueia endpoints push
Algumas instâncias do Mastodon desativam notificações push por motivos de desempenho ou privacidade. Administradores de instância podem definir a variável de ambiente PUSH_ENDPOINT para um endpoint personalizado ou deixá-la vazia para desativar o push completamente. Se você não conseguir ativar o push em uma instância, tente fazer login em uma instância diferente que suporte push. Você pode verificar o status da sua instância perguntando ao administrador ou consultando a página Sobre da instância.
O navegador usa configurações de privacidade rigorosas que bloqueiam service workers
Navegadores como Brave com Shields Up ou Firefox com Proteção Contra Rastreamento Aprimorada definida como Estrita podem bloquear service workers. Para Brave, clique no ícone do leão na barra de endereços e defina Shields como Down para a instância do Mastodon. Para Firefox, clique no ícone do escudo e desative a Proteção Contra Rastreamento Aprimorada para o site. Depois recarregue o Mastodon e repita a configuração push.
Métodos de notificação push do Mastodon: navegador vs aplicativo móvel
| Item | Push Web do Navegador | Push do Aplicativo Móvel |
|---|---|---|
| Método de entrega | Service Worker + Push API | Serviço push da plataforma (APNs, FCM) |
| Requer navegador aberto | Não, mas o navegador precisa estar em execução | Não, funciona com o app fechado |
| Causa comum de falha | Service worker ou permissões bloqueados | Token de dispositivo inválido ou permissões do app |
| Local da configuração | Preferências > Notificações | Configurações do App > Notificações |
| Navegadores ou SO compatíveis | Chrome, Firefox, Edge, Safari 16+ | iOS 14+, Android 6+ |
Se o push do navegador continuar falhando, considere usar o aplicativo móvel oficial do Mastodon para notificações push confiáveis. O aplicativo usa o serviço push específico da plataforma e não depende de service workers do navegador.