Solução de problemas do Inspector
Diagnostique problemas de download, autorização e conexão com o sandbox no Polymorfa 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:
- Baixe o DMG Nightly mais recente em Instalar.
- Verifique o DMG com o arquivo complementar
SHA256SUMSdele. - Feche o Inspector, abra o DMG e substitua o Polymorfa Inspector em Aplicativos.
- 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 Esta sessão parou, leia a causa abaixo do título. Quando nenhuma causa aparece, o Inspector ainda não tem uma causa específica. Selecione Tentar novamente: isso mantém o dispositivo nativo guardado e reconecta o mesmo número; não abre a tela de pareamento do WhatsApp nem cria outro dispositivo. Enquanto ele reconecta, o ponto na aba mostra o status; passe o cursor sobre a aba ou coloque o foco nela para ler. Se parar de novo, o Inspector mostra A nova tentativa não funcionou.
- Se o número nunca foi pareado neste computador e ninguém é dono dele, Tentar novamente ou Abrir inicia o pareamento de novo. A tela da sessão parada avisa isso e o botão mostra Iniciando pareamento até a tela de pareamento do WhatsApp abrir. Isso também vale depois de fechar a aba ou sair da conta antes de o pareamento terminar.
- Se a sua conta ainda é dona de um número que este computador pareou antes, Tentar novamente reconecta esse dispositivo.
- Se o número já foi pareado aqui mas não está mais vinculado à sua conta, se outra conta passou a usá-lo ou se ele não está mais disponível para você, a tela explica o motivo e oferece Verificar de novo em vez de Tentar novamente. Se o seu acesso ao Inspector mudou, ela oferece Atualizar acesso. O Inspector não inicia um pareamento novo para um dispositivo que já vinculou.
- Esta sessão está pausada significa que o Inspector parou a sessão, por exemplo, depois que outra conta assumiu o número. Selecione Retomar para reconectar o dispositivo vinculado quando o número voltar a estar disponível.
- Uma aba marcada como Não confirmado ainda não foi verificada na sua conta, então o Inspector ainda não sabe se o número é de teste ou de produção. O Inspector confirma quando a lista de números carrega ou a aba reconecta.
- Se o Inspector não conseguir acessar a Polymorfa, você continua conectado e os números abertos continuam funcionando. A barra de título mostra Não foi possível acessar a Polymorfa. Tentando novamente… e Tentar agora; numa janela estreita, mostra só um ícone e Tentar agora. A lista de números mantém o último estado carregado com Atualizado às. O Inspector tenta de novo sozinho. Se o Inspector abrir enquanto a Polymorfa estiver inacessível, as abas abertas mostram Aguardando a Polymorfa; cada uma inicia sozinha quando a Polymorfa responder, se o número ainda estiver vinculado a este computador. Caso contrário, a aba mostra Esta sessão está pausada com o motivo, como descrito acima. Se ainda não puder iniciar, ela mostra Esta sessão parou com Tentar novamente, e o Inspector tenta de novo sozinho. Abrir um número novo falha até a Polymorfa voltar; selecione Tentar novamente nesse momento. O Inspector só desconecta você quando o login é recusado ou quando você escolhe Sair.
- Se a causa for O acesso mudou, escolha Entrar de novo ou Atualizar acesso. Tentar novamente não recupera um acesso removido.
- Fechar aba fecha a aba e mantém o dispositivo vinculado.
- 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.come 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.