O Element pode receber mensagens normalmente enquanto está aberto, mas falha ao enviar notificações após o bloqueio da tela. Em um telefone Android sem os Serviços do Google Play, isso geralmente indica um problema no caminho de entrega, e não na conta Matrix em si. O objetivo deste guia não é apenas fazer com que uma notificação de teste apareça. Um bom resultado é aquele que se repete: as mensagens chegam enquanto o Element está em segundo plano, após o telefone estar ocioso e sem a necessidade de reabrir o aplicativo.
Este guia se concentra na versão atual do Element X para Android, recomendada pela Element para novos usuários. Em 6 de outubro de 2026, a versão pública mais recente do GitHub era o Element X Android 26.09.4, e as versões recentes incluem componentes UnifiedPush ativos. O UnifiedPush é um protocolo aberto que permite que um aplicativo Android receba mensagens push por meio de um distribuidor diferente do Firebase Cloud Messaging (FCM) do Google. As próprias diretrizes do projeto Element afirmam que a instalação de um distribuidor UnifiedPush permite que o Element X o detecte e o ofereça como um provedor de push. Consulte o repositório do Element X para Android , as versões do Element X para Android e a discussão da equipe do Element sobre notificações sem o Google Play Services .
Antes de alterar as configurações, defina o resultado que deseja alcançar. Uma configuração de notificações funciona corretamente quando todas as seguintes condições são verdadeiras:
Se as mensagens aparecerem somente após a abertura do Element, você tem sincronização, mas não entrega confiável em segundo plano. Se elas aparecerem imediatamente enquanto o aplicativo estiver aberto, mas com atraso quando ele for fechado, concentre-se no distribuidor de notificações push e nas restrições de segundo plano do Android, em vez das regras de notificação da sala.
A maioria dos aplicativos Android mais populares usa o FCM, o serviço de notificações push do Google, para ativar o aplicativo quando novos dados estão disponíveis. A documentação de notificações do Element explica que o FCM requer os Serviços do Google Play. Em um telefone sem os Serviços do Google, uma configuração somente com FCM não pode fornecer o caminho de ativação normal. O Android também limita o que os aplicativos comuns podem fazer em segundo plano, principalmente quando o dispositivo entra em estado ocioso.
O UnifiedPush substitui essa dependência por um distribuidor. Um distribuidor é o aplicativo Android que mantém a conexão push e repassa as notificações recebidas para os aplicativos registrados nele. O projeto UnifiedPush lista ntfy, Sunup, NextPush, gCompat-UP e outras opções. Consulte a lista oficial de distribuidores do UnifiedPush .
Comece pelo ponto de falha mais simples. No Android 13 e versões posteriores, os aplicativos precisam da POST_NOTIFICATIONSpermissão de tempo de execução para que as notificações normais sejam exibidas. Abra as Configurações do Android, encontre o Elemento X em Aplicativos e verifique se as notificações estão permitidas. Verifique também as categorias de notificação individuais, caso sua versão do Android ou fabricante as exponha.
A documentação oficial do Android confirma que aplicativos recém-instalados no Android 13 ou posterior não podem enviar notificações comuns até que o usuário conceda permissão. Consulte a documentação sobre permissões de notificação do Android .
Verificação de qualidade: se o Android mostrar notificações desativadas, corrija isso primeiro e teste novamente. Se as notificações já estiverem permitidas, mas nada chegar enquanto o Element estiver em segundo plano, continue com o provedor de notificações push.
Instale um distribuidor UnifiedPush de uma fonte apropriada para o seu dispositivo. O ntfy é uma escolha comum, pois pode usar seu servidor público ou um servidor próprio. O guia de início rápido do UnifiedPush para ntfy instrui os usuários a instalar o ntfy, conceder as permissões necessárias de notificação e bateria e, em seguida, selecionar o ntfy como distribuidor em aplicativos compatíveis. Consulte o guia de início rápido oficial do UnifiedPush para ntfy .
Abra o ntfy e verifique se o suporte ao UnifiedPush está ativado. Se você usa um servidor ntfy hospedado localmente, verifique se o aplicativo Android está conectado a esse servidor e se o servidor está acessível via HTTPS a partir da rede atual do telefone.
Verificação de qualidade: simplesmente ter o NTfy instalado não é suficiente. O distribuidor deve estar habilitado e acessível. Se o Element não conseguir detectar o distribuidor após a instalação, feche e abra o Element X completamente e verifique se há atualizações do aplicativo antes de alterar as configurações do Matrix no servidor.
Abra as configurações do Element X e acesse a área de notificações. Quando um distribuidor compatível for detectado, o Element X poderá exibir uma opção de provedor de notificações push. Selecione o distribuidor UnifiedPush instalado em vez do Firebase/FCM. Os mantenedores do projeto Element descreveram explicitamente esse fluxo para dispositivos sem os serviços do Google, e o código-fonte atual inclui um módulo de provedor de notificações push do UnifiedPush.
Se a sua instalação não exibir um seletor de provedor mesmo após a instalação de um distribuidor, não presuma que o servidor doméstico esteja com defeito. Primeiro, atualize o Element X para uma versão compatível atual e reinicie o Element X e o distribuidor. Os rótulos da interface do usuário mudaram entre as versões do Element X, portanto, o nome exato do menu pode ser diferente.
Verificação de qualidade: o sinal útil não é apenas a exibição do nome do provedor. Envie uma mensagem real de outra conta Matrix enquanto o Element estiver em segundo plano. Um provedor funcionando corretamente deve fazer com que o dispositivo ative o Element e exiba a notificação da mensagem sem que seja necessário abrir o aplicativo manualmente.
O UnifiedPush depende da disponibilidade do distribuidor. Se o Android colocar o ntfy ou outro distribuidor em um estado de bateria Restrita, a conexão push poderá ser suspensa. O Android documenta três modos gerais de bateria em segundo plano em muitos dispositivos: Irrestrito, Otimizado e Restrito. O modo Restrito pode impedir tarefas, alarmes e o comportamento de serviços em primeiro plano dos quais os aplicativos dependem.
Abra as Configurações do Android para o distribuidor e altere o uso da bateria de Restrito para Irrestrito caso as notificações estejam atrasadas ou desapareçam durante períodos de inatividade. Você também pode inspecionar o próprio Element X e verificar se ele não está explicitamente restrito. Versões específicas do Android do fabricante podem adicionar controles separados para inicialização automática, dados em segundo plano ou suspensão de aplicativos.
A documentação do Android do Google observa que um estado Restrito selecionado pelo usuário pode impedir completamente que um aplicativo seja executado em segundo plano em alguns dispositivos. Consulte as diretrizes de otimização de segundo plano do Android .
Teste de qualidade: bloqueie o telefone e deixe-o ocioso por 10 a 20 minutos. Em seguida, envie várias mensagens de outra conta. Se os alertas chegarem de forma rápida e consistente, o caminho em segundo plano está mais estável do que em um teste realizado imediatamente após a abertura do aplicativo.
| Resultado observado | Área mais provável | Próxima ação |
|---|---|---|
| Nenhuma notificação, mesmo com o Element aberto. | Regras da sala, configurações de notificação da conta ou permissão de notificação do Android | Verifique primeiro as configurações de notificação da sala/conta do Element e as permissões do Android. |
| As notificações aparecem somente quando o Elemento é aberto. | Conexão de fundo com o provedor ou distribuidor de push | Confirme se o Element está usando o UnifiedPush e remova as restrições de bateria do distribuidor. |
| Funciona por alguns minutos e depois para após ficar ocioso. | Doze, controles de bateria do fabricante, políticas de aplicativos de suspensão | Configure o distribuidor para Irrestrito e verifique os controles de fundo específicos do fabricante. |
| O Element mostra um distribuidor, mas nenhuma mensagem real chega. | Servidor de distribuição, gateway push Matrix ou limitação de taxa de endpoint | Faça testes com um distribuidor/servidor diferente antes de reinstalar o Element. |
| Apenas um quarto está em silêncio. | Regra de notificação específica para cada quarto | Verifique o nível de notificação daquela sala em vez de alterar as configurações globais de notificações push. |
Uma configuração pode estar tecnicamente correta e ainda assim ser inadequada. O rastreador da Element documenta casos em que alguns endpoints do UnifiedPush, incluindo a infraestrutura pública ntfy em certos cenários do Matrix, podem ter sua taxa de requisições limitada, o que significa que o registro pode parecer correto, mas as notificações ainda assim não chegam. Veja o problema relatado pela Element sobre a limitação de taxa nos endpoints do UnifiedPush .
Se as permissões, a seleção do provedor e as configurações de bateria estiverem corretas, mas a entrega continuar inconsistente, tente usar um distribuidor UnifiedPush diferente ou um servidor push auto-hospedado. O UnifiedPush documenta ambas as opções, hospedadas e auto-hospedadas. Essa geralmente é uma etapa de diagnóstico mais eficaz do que limpar repetidamente os dados do Elemento, pois altera a parte da cadeia de entrega com maior probabilidade de estar apresentando falhas.
A hospedagem própria pode proporcionar maior controle, mas aumenta a responsabilidade operacional. Para o ntfy, o gateway Matrix deve ser configurado corretamente para uma implantação com hospedagem própria. O guia oficial do UnifiedPush para ntfy menciona esse requisito. Não migre para a hospedagem própria apenas porque uma notificação de teste atrasou; faça a mudança quando as falhas forem repetíveis e você já tiver descartado restrições do Android.
A versão anterior do aplicativo Element para Android também implementava operação não-FCM e UnifiedPush. Sua documentação oficial descreve o polling em segundo plano do F-Droid e o suporte ao UnifiedPush. No entanto, o Element agora recomenda o Element X para novos usuários, portanto, o caminho atual do Element X é o melhor ponto de partida, a menos que você tenha um requisito específico de compatibilidade. Os detalhes da implementação legada ainda são úteis para entender por que o polling sozinho é menos confiável nos modos ociosos do Android. Consulte a documentação arquivada/atual do projeto para UnifiedPush no Element para Android .
Não existe uma configuração universal que garanta a entrega instantânea em todas as versões do Android. Os fabricantes de dispositivos podem impor restrições adicionais em segundo plano, as redes podem interferir em conexões persistentes e um endpoint de push pode estar temporariamente indisponível ou com taxa de requisições limitada. Portanto, o resultado mais importante é um comportamento repetível em diversos testes em segundo plano e em modo ocioso, e não uma única notificação bem-sucedida.
Diagnostique picos de uso da CPU no navegador do Jitsi Meet e reduza a carga do cliente verificando os mosaicos de vídeo, os efeitos da câmera, os gráficos do navegador e as configurações do host.
Monitore a integridade, a carga da conferência e o tráfego do Jitsi Videobridge com seu endpoint Prometheus integrado e, em seguida, explore e visualize os dados em gráficos no Grafana.
Configure um domínio personalizado para o Jitsi Meet Docker com DNS, URL pública, HTTPS, Let's Encrypt, portas de firewall, configurações de NAT e verificação de ponta a ponta.
Corrija os erros 404 do Console de Administração do Zimbra após a renovação do SSL, verificando o URL e a porta corretos, o roteamento do proxy, o status do serviço, os certificados implantados e os logs.
Aprenda a diagnosticar e corrigir o aviso de configuração do PHP OPcache do Nextcloud, verificando o PHP SAPI ativo, os limites de tamanho, os comentários e as configurações de revalidação.
Solucione problemas de falhas na migração do banco de dados Kopano após uma atualização do MySQL ou MariaDB, verificando backups, versões do servidor, modos SQL, conjunto de caracteres, estado do esquema e logs.
Conecte o Nextcloud ao LDAP ou Active Directory com transporte seguro, filtros de usuários e grupos, atributos de login e uma implementação testada.
Corrija as notificações do Element no Android em telefones sem serviços do Google configurando o UnifiedPush, as permissões do Android, as configurações de bateria e realizando testes de verificação confiáveis.
Remova o aviso de índices de banco de dados ausentes do Nextcloud com o comando oficial occ. Primeiro, faça um backup, visualize as alterações, execute o reparo e verifique o resultado.
Configure o SSO do Keycloak para o Element Web conectando o OIDC ao Synapse, definindo a URL de retorno de chamada exata, mapeando as declarações do usuário e testando o logout.
