Instalar o webmail como PWA no iOS e Android

O webmail TrekMail tem um layout responsivo para celular e pode ser instalado como Progressive Web App (PWA) em navegadores compatíveis. A instalação cria um atalho na tela inicial ou na área de trabalho e uma janela independente, mas não transforma a caixa de correio em um cliente de e-mail offline.

Usar o webmail em um navegador móvel

Abra trekmail.net/webmail/ ou o URL personalizado do webmail do seu provedor e entre com o endereço e a senha da caixa de correio.

Em uma tela estreita:

• A barra lateral de pastas e caixas é recolhida para que a lista de mensagens use toda a largura.
• Abrir uma mensagem substitui a lista e oferece uma ação para voltar.
• O botão flutuante de composição abre o editor móvel.
• Settings abre primeiro uma lista de seções em tela cheia e depois mostra o painel selecionado.
• Cartões de identidade, assinaturas, opções de endereço From e controles de política de resposta ficam empilhados verticalmente, com áreas de toque adequadas ao celular.
• Os temas claro e escuro usam o mesmo layout responsivo.

Use as ações visíveis das mensagens e as caixas de seleção. Atualmente, o webmail não oferece gestos de deslizar configuráveis para arquivar ou marcar como lida, nem um menu de mensagem acionado por toque prolongado.

Instalar como PWA

A instalação da PWA exige HTTPS e um navegador compatível. Os nomes das opções podem variar conforme o sistema operacional e a versão do navegador.

iPhone ou iPad

1. Abra o URL do webmail no Safari.
2. Toque em Share.
3. Escolha Add to Home Screen.
4. Confira o nome e toque em Add.

Abra o novo ícone para executar o webmail em uma janela independente, sem a barra de endereços normal do Safari. Se Add to Home Screen não aparecer, confirme se a página está aberta no Safari e não em um navegador interno de outro aplicativo.

Android

1. Abra o webmail no Chrome ou em outro navegador que permita instalação.
2. Abra o menu do navegador.
3. Escolha Install app ou Add to Home screen.
4. Confirme a instalação.

Se a opção de instalação não aparecer, atualize o navegador, recarregue o webmail por HTTPS e tente novamente pelo menu. Alguns navegadores criam um marcador comum na tela inicial em vez de uma PWA independente.

Computador

Navegadores para computador baseados em Chromium podem mostrar uma ação de instalação na barra de endereços ou no menu de aplicativos. Em versões recentes do macOS, o Safari oferece File → Add to Dock. Se o navegador não permitir instalação, use um marcador comum.

O que muda com a instalação

O service worker intencionalmente não armazena em cache páginas autenticadas, conteúdo de mensagens, anexos, contatos ou respostas da API da caixa. Todas as operações ainda exigem conexão. Isso evita que dados privados sejam guardados em um cache geral da PWA.

A página offline segue o tema claro ou escuro lembrado, oferece os mesmos 13 idiomas do webmail, incluindo layouts RTL em árabe e hebraico, e tenta novamente quando o navegador informa que a rede voltou. Somente essa página pública e suas imagens de marca são armazenadas em cache.

O manifesto de instalação é um arquivo pequeno que informa ao celular ou navegador o nome, o ícone, a cor, a página inicial e o modo de exibição independente do aplicativo. Você não precisa baixá-lo nem configurá-lo: o webmail fornece automaticamente o manifesto correto para o domínio aberto.

Notificações

O webmail pode exibir notificações do navegador sobre novas mensagens e lembretes do calendário enquanto a página está aberta e consultando atualizações. Ative-as em Settings → Profile → Desktop notifications e conceda a permissão no navegador.

Isso não é push em segundo plano pelo service worker. Fechar o navegador ou a PWA, ou permitir que o sistema operacional a suspenda, interrompe as verificações. Não dependa da PWA instalada para alertas em segundo plano. Se sincronização e notificações em segundo plano forem essenciais, conecte a caixa a um cliente de e-mail nativo por IMAP/SMTP.

Comportamento White Label

Em um host White Label Lite ativo, o login, o webmail, a instalação, as notificações e a página offline usam a identidade visual configurada pelo provedor:

• O nome do aplicativo instalado usa a marca do provedor.
• Os ícones de instalação e notificação usam o favicon enviado. Se não houver um, o webmail cria um ícone neutro de e-mail na cor principal da marca.
• A página offline usa o nome, a cor principal e os logotipos claro e escuro do provedor. Se não houver logotipo escuro, usa o claro; se nenhum existir, usa o ícone neutro de e-mail na cor da marca.
• O layout offline continua seguindo o tema claro ou escuro selecionado, as áreas seguras do celular, o idioma atual e a direção RTL quando aplicável.
• O aplicativo independente abre o mesmo host personalizado e mantém sua sessão separada do host TrekMail ou de outro provedor.

Instale a partir do URL realmente usado para o webmail, para que o ícone abra a origem e a sessão corretas. Instalar tanto o URL TrekMail quanto o URL do provedor pode criar dois ícones e sessões de navegador separadas.

Quando o provedor altera sua identidade visual, a estrutura pública offline é atualizada após a próxima navegação bem-sucedida no webmail. O sistema do celular pode manter o nome ou ícone antigo na tela inicial de um aplicativo já instalado. Remova e reinstale o atalho se ele não for atualizado.

Limitações atuais da PWA

• Sem leitura, busca, composição ou envio em fila offline.
• Sem notificações push em segundo plano pelo service worker.
• Sem integração com o destino de compartilhamento do sistema operacional para enviar arquivos ou texto ao editor.
• Sem estrutura autenticada do aplicativo em cache; a navegação prioriza a rede por privacidade e atualização.

Solução de problemas

O ícone abre uma aba normal do navegador: remova o atalho e instale novamente usando a opção de instalação de PWA ou Add to Home Screen do navegador. Um marcador comum pode não abrir no modo independente.

O webmail mostra “Connection lost” enquanto outros sites funcionam: toque em Try again. Se continuar, desative temporariamente a VPN ou o bloqueador de conteúdo, teste o URL do webmail em uma aba normal e confirme que o host personalizado correto ainda responde.

O aplicativo trava após uma atualização: feche-o completamente e abra novamente. Se necessário, remova o aplicativo instalado, limpe os dados do site desse host, visite o webmail e reinstale.

As notificações não aparecem: mantenha o webmail aberto, confira Settings → Profile → Desktop notifications e verifique a permissão do navegador e do sistema operacional para esse host. Instalar a PWA não ativa notificações por si só.

Não consigo ler mensagens offline: esse comportamento é esperado. O webmail armazena em cache apenas a página pública de perda de conexão e as imagens da marca. Use um cliente IMAP nativo com sincronização offline própria quando precisar acessar e-mails sem conexão.

Aplicativos nativos de calendário, contatos e e-mail

Para sincronizar calendário e contatos com o sistema operacional, use CalDAV e CardDAV:

• Conectar iPhone e iPad
• Conectar Android com DAVx⁵

Para notificações nativas de e-mail e sincronização offline da caixa, consulte Configurar o TrekMail em aplicativos de e-mail para celular.