Solução de problemas do Inspector

​

O download não está disponível

A página de instalação valida o manifesto da versão Nightly. Ela esconde os instaladores de propósito quando não consegue buscar o manifesto, quando ele contém uma versão inválida, quando faltam ou sobram artefatos ou quando ele inclui um valor SHA-256 inválido. Tente novamente mais tarde ou fale com o suporte; não monte uma URL de download manualmente.

​

A verificação do instalador falha

Baixe de novo o artefato e o arquivo complementar SHA256SUMS dele e compare o digest com o comando da página Instalar. Uma divergência significa que o arquivo está incompleto ou foi alterado; exclua-o e não o execute.

​

Uma atualização automática no macOS não termina

Uma verificação de atualização que falha não interrompe a sua sessão do Inspector. Conclua o trabalho em andamento e depois feche e reabra o Inspector para permitir uma nova verificação. Se o download de uma atualização ou a reabertura do app ainda não terminar, use o caminho de recuperação manual:

1. Baixe o DMG Nightly mais recente em Instalar.
2. Verifique o DMG com o arquivo complementar SHA256SUMS dele.
3. Feche o Inspector, abra o DMG e substitua o Polymorfa Inspector em Aplicativos.
4. Abra o Inspector de novo.

Não monte uma URL de download manualmente. Se a página de instalação estiver indisponível, tente novamente mais tarde ou fale com o suporte.

​

A autorização do dispositivo não é concluída

O Inspector usa o fluxo de autorização de dispositivo pelo navegador. Confirme que:

• Você está conectado em polymorfa.com/console.
• A página do dispositivo mostra o mesmo código de usuário que o Inspector.
• Você selecionou pelo menos uma equipe da qual ainda participa ativamente.
• O app solicitante, os detalhes de localização, o horário da solicitação, as equipes e os projetos ativos correspondem ao que você espera.
• Você aprova a solicitação explicitamente antes de o código expirar.
• O seu navegador permite solicitações com credenciais para api.polymorfa.com.

Códigos expirados e concluídos não podem ser reutilizados; solicite um código novo no Inspector.

​

A conexão da sessão falha

• Se o Inspector mostrar Algo deu errado, selecione Tentar novamente. Tentar novamente mantém o dispositivo nativo guardado e reconecta a mesma sessão; isso não abre a tela de pareamento do WhatsApp nem cria outro dispositivo.
• Confirme que o número ainda pertence ao projeto ativo e que a sua conta da Polymorfa é dona dele pelo Inspector.
• Verifique se api.polymorfa.com, polymorfa.com e o endpoint do sandbox mostrado pelo app estão acessíveis por HTTPS/WSS.
• Use a visualização do Sandbox no Console para confirmar a sessão e o dono antes de reinstalar.

Se um número de teste voltar repetidamente para Conectando depois da primeira abertura, tente novamente uma vez. Se o ciclo continuar, fale com o suporte informando a versão do Inspector e a etapa que falha. Mantenha o número e o dispositivo guardado dele durante o diagnóstico; remover o número limpa o estado simulado dele de forma permanente.

​

Uma mensagem enviada não aparece no Inspector

Selecione o número remetente e abra a conversa do destinatário. Se o destinatário recebeu a mensagem, mas ela não aparece na conversa do número remetente, fale com o suporte informando a versão do Inspector e o ID da mensagem retornado pelo envio. Não envie a mensagem de novo só para atualizar a conversa: o destinatário já a recebeu. Mantenha o número e o dispositivo guardado dele enquanto o suporte investiga.

​

Mensagens de grupo não aparecem

Se a sua mensagem aparece na conversa do grupo, mas outro participante vê um aviso de que a mensagem não pôde ser descriptografada, mantenha o grupo e os dispositivos vinculados dele durante o diagnóstico. Fale com o suporte informando a versão do Inspector, o ID da mensagem e qual visualização de participante falhou. Não remova e recrie o grupo nem reenvie mensagens só para atualizar a outra visualização.

​

O histórico retido não está disponível

Uma sessão de produção pode continuar ativa quando o histórico retido está temporariamente indisponível. Continue com as mensagens em tempo real ou tente novamente a sessão mais tarde. Se a sessão informar que o histórico retido está desativado, ative o armazenamento hospedado de mensagens para esse número antes de esperar conversas, contatos ou mensagens anteriores. Números de teste não têm histórico de produção retido.

​

Inspecionar os logs da sessão

Abra Visualizar → Alternar DevTools (sessão ativa) e selecione Console. O Inspector registra nesse console as etapas de inicialização da sessão e as mensagens do runtime do WhatsApp, incluindo avisos e falhas na aplicação de patches. O mesmo comando fecha o DevTools quando você terminar. Antes de compartilhar a saída do console com o suporte, remova o conteúdo das mensagens, números de telefone, códigos de dispositivo e credenciais.

​

Obter ajuda

​

Preferências de relatórios de diagnóstico

Se a versão instalada incluir Compartilhar relatórios de erro de diagnóstico, revise o que essa preferência envia antes de ativá-la. Ela é separada da permissão para abrir um número de produção. Os relatórios não substituem uma solicitação de suporte nem anexam capturas de tela e logs do console. Se não for possível salvar uma mudança de preferência, verifique se o Inspector consegue gravar as configurações locais e tente de novo. Desativar os relatórios os interrompe no app em execução mesmo que a gravação falhe; confirme que a preferência está desativada depois de reiniciar o Inspector.

​

Falar com o suporte

Envie um e-mail para support@polymorfa.com com a versão do Inspector, o sistema operacional, a etapa que falha e capturas de tela ou logs sem dados sensíveis. Nunca inclua chaves de equipe, tokens de projeto, tokens de cliente, URLs de QuickLink nem códigos de dispositivo.

​

Próximos passos