> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/pt-br/desktop-app/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](/pt-br/desktop-app/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 **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](/pt-br/desktop-app/install#relatórios-de-erro-de-diagnóstico)
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](mailto: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](/pt-br/desktop-app/install)**
>
> Baixe e verifique o artefato atual.

> **[Sandbox](/pt-br/sandbox/introduction)**
>
> Revise os dispositivos do Inspector e as sessões de teste.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.