# 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](https://docs.polymorfa.com/pt-br/testing/inspector/install). 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](https://docs.polymorfa.com/pt-br/testing/inspector/install).
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](https://www.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.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](https://docs.polymorfa.com/pt-br/testing/inspector/install#relatorios-de-erro-de-diagnostico)
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

- **[Instalar](https://docs.polymorfa.com/pt-br/testing/inspector/install)**
Baixe e verifique o artefato atual.

- **[Sandbox](https://docs.polymorfa.com/pt-br/testing)**
Revise os dispositivos do Inspector e as sessões de teste.
