> ## 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.

# Instale o Polymorfa Inspector

> Instale o app de desktop para inspecionar sessões de WhatsApp reais e simuladas.

O Polymorfa Inspector abre as sessões de WhatsApp que a sua conta da Polymorfa
pode acessar. Use-o para inspecionar e interagir com números reais de produção
ou com [números de teste simulados do Sandbox](/pt-br/sandbox/introduction).

As sessões de produção são interativas: as ações no Inspector agem como o
número de WhatsApp real, incluindo o envio de mensagens. O Inspector pede que
você confirme esse escopo antes de abrir um número de produção pela primeira
vez.

Quando o armazenamento hospedado de mensagens está ativado para uma sessão de
produção, o Inspector carrega os chats, contatos e mensagens retidos antes de
continuar com as atualizações em tempo real. Uma indisponibilidade temporária
do histórico retido não interrompe a sessão em tempo real; em vez disso, o
Inspector indica que o histórico está indisponível. Sem o armazenamento
hospedado de mensagens, a sessão em tempo real abre normalmente e nenhum
histórico retido é exibido.

## Baixe o Nightly

O canal de desenvolvimento do Polymorfa Inspector se chama **Nightly**. Abra
[polymorfa.com/inspector/install](https://www.polymorfa.com/inspector/install)
para obter o patch semântico mais recente do Nightly. A página de instalação
canônica e todos os links de download levam a essa mesma versão.

Cada publicação do Nightly avança apenas o componente de patch da versão
semântica, por exemplo de `0.1.1` para `0.1.2`.

A página de instalação lê o manifesto de versões do Nightly e oferece apenas os
artefatos validados da versão mais recente. No macOS, ela usa as informações de
arquitetura do navegador, quando disponíveis, para mostrar o download
correspondente. Se o navegador não conseguir distinguir Apple Silicon de Intel,
a página apresenta as duas opções em vez de tentar adivinhar.

| Plataforma | Arquitetura | Artefato |
| - | - | - |
| macOS | Apple Silicon | `Polymorfa-Inspector-arm64.dmg` |
| macOS | Intel | `Polymorfa-Inspector-x64.dmg` |
| Windows | x64 | `Polymorfa-Inspector-x64.exe` |
| Linux | x64 | `Polymorfa-Inspector-x64.AppImage` |

Cada download tem um arquivo `SHA256SUMS` complementar. Se o manifesto não puder ser obtido ou validado, a página de instalação mostra os downloads como temporariamente indisponíveis em vez de adivinhar a URL de uma versão.

## Verifique e instale

**macOS**

Compare o digest SHA-256 do arquivo baixado com o arquivo complementar, abra o DMG e arraste o **Polymorfa Inspector** para Aplicativos.

```bash theme={null}
shasum -a 256 Polymorfa-Inspector-arm64.dmg
# On an Intel Mac:
shasum -a 256 Polymorfa-Inspector-x64.dmg
```

**Windows**

Compare o digest e depois execute o instalador.

```powershell theme={null}
Get-FileHash .\Polymorfa-Inspector-x64.exe -Algorithm SHA256
```

**Linux**

Compare o digest, torne o AppImage executável e abra-o.

```bash theme={null}
sha256sum Polymorfa-Inspector-x64.AppImage
chmod +x Polymorfa-Inspector-x64.AppImage
./Polymorfa-Inspector-x64.AppImage
```

Use a página de instalação do Inspector para baixar a versão atual. Verifique o
download com o checksum do manifesto da versão mais recente antes de abri-lo.

## Atualize o Nightly no macOS

O Inspector empacotado para macOS verifica automaticamente o feed do Nightly
específico da sua arquitetura. Instalações em Apple Silicon recebem apenas
atualizações para Apple Silicon, e instalações em Intel recebem apenas
atualizações para Intel. Quando uma atualização está disponível e verificada, o
Inspector a baixa e pede que você escolha **Relaunch** para instalá-la ou
**Later** para continuar trabalhando. Uma falha na verificação de atualizações
não bloqueia as sessões do Inspector.

Se o download automático ou a reinicialização não terminar, use o DMG do
Nightly mais recente desta página como caminho de recuperação. Verifique o
checksum, feche o Inspector e substitua o app existente em Aplicativos antes de
abri-lo de novo.

## Autorize o Inspector

O Inspector exibe um código de dispositivo de oito caracteres. Abra a página de
dispositivo no navegador e faça estas verificações:

1. Confirme a conta conectada ou escolha **Usar outra conta**.
2. Digite o código mostrado pelo Inspector ou escolha **Colar** para lê-lo da
   área de transferência. Se o acesso à área de transferência estiver bloqueado
   ou ela não tiver um código de dispositivo, digite o código manualmente.
3. Revise o app solicitante, o horário da solicitação e as informações de
   cidade e IP disponíveis.
4. Selecione todas as equipes que o Inspector deve acessar e revise os projetos
   incluídos em cada equipe.
5. Escolha **Autorizar Inspector**.

Os códigos são normalizados para letras maiúsculas e dígitos e não podem ser
reutilizados depois de expirarem ou depois de uma decisão concluída. A
aprovação cria uma sessão do Inspector para as equipes selecionadas sem expor a
sessão do navegador. Você pode revisar ou revogar esse acesso em
**Configurações da conta → Autenticação → Sessões ativas** no Console.

> [!WARNING]
>
> Aprove apenas quando o código for exatamente igual ao do Inspector. Um código
> de dispositivo é um material de autorização temporário; não o envie por chat
> nem para o suporte.

## Navegue por equipes e projetos

O seletor de equipes no topo da barra lateral do Inspector lista apenas as
equipes que você autorizou. Ele usa o nome de exibição e a imagem de perfil de
cada equipe na sua conta da Polymorfa. Equipes sem imagem de perfil recebem o
mesmo avatar Glass gerado que o Console usa.

Escolha uma equipe para mostrar os projetos e os números de WhatsApp dela. A
foto da sua conta aparece no menu da conta, no canto superior direito. O
Inspector gera o seu avatar Glass quando a sua conta não tem foto.

Os projetos aparecem como seções recolhíveis da barra lateral, com os números
reais e de teste listados abaixo. Selecione um número para abri-lo como uma aba
acima do WhatsApp. Redimensione a barra lateral arrastando a borda direita dela
ou oculte-a pela barra superior. Para proprietários e administradores do
projeto, o **+** ao lado de um projeto abre a configuração de números de teste
desse projeto no Console.

O painel inicial resume os projetos autorizados, os números de WhatsApp e as
abas abertas. Os números de telefone e os identificadores de sessão podem ser
copiados. Menus, configurações e caixas de diálogo de confirmação ficam acima
do WhatsApp enquanto estão abertos.

A conta que conclui primeiro o pareamento nativo passa a ser a responsável por
aquela sessão no Inspector. O Console e o Inspector mostram
**Responsável: *nome*** com a foto da conta do membro, quando disponível. Os
outros membros autorizados do projeto veem o responsável, mas não podem
assumir a sessão sem que ele perceba.

Fechar o Inspector, tentar novamente uma conexão que falhou, reiniciar o app ou
sair do dashboard mantém o dispositivo vinculado nativo. Ao abrir o número de
novo no mesmo computador, os chats são restaurados e a conexão é refeita sem um
novo pareamento. Remover o número ou transferir a responsabilidade por ele no
Inspector invalida o dispositivo retido.

## Tema e idioma

Estas instruções valem quando a versão instalada do Inspector mostra **Tema** e
**Idioma** no menu da conta. As versões anteriores têm um controle de aparência
na barra superior e mostram o Inspector em inglês. Baixar uma versão mais
antiga não adiciona essas opções.

Abra o menu da conta no canto superior direito do Inspector. O menu oferece as
mesmas opções com ou sem sessão iniciada, e a escolha é aplicada na hora.

Em **Tema**, escolha **Sistema**, **Claro** ou **Escuro**. O Inspector repassa a
preferência resolvida ao WhatsApp para que as duas superfícies usem a mesma
aparência. Com **Sistema** selecionado, as duas superfícies acompanham as
mudanças do sistema operacional.

Em **Idioma**, escolha uma destas opções:

| Opção | Idioma do Inspector |
| - | - |
| **Igual à conta** | O idioma salvo na sua conta da Polymorfa. Esta é a opção padrão. |
| **Automático** | O primeiro idioma compatível na lista de idiomas do seu sistema operacional, inglês ou português. Se nenhum dos dois aparecer, inglês. |
| **English** | Inglês. |
| **Português (Brasil)** | Português do Brasil. |

**Igual à conta** funciona como **Automático** quando você não está conectado,
quando o idioma da sua conta está definido como **Automático** ou quando o
Inspector não consegue ler a sua conta. O Inspector lê de novo o idioma da sua
conta quando você atualiza o Início. Ele nunca altera o idioma salvo na sua
conta; defina esse idioma no Console, em [Idioma](/pt-br/console/language).

Mudar o idioma não recarrega nem desconecta as abas de WhatsApp abertas. O
WhatsApp mantém o próprio idioma.

## Relatórios de erro de diagnóstico

Estas instruções valem quando a versão instalada do Inspector mostra
**Compartilhar relatórios de erro de diagnóstico**. A disponibilidade depende da
versão instalada; baixar uma versão mais antiga não adiciona a preferência.

Nas versões com **Tema** e **Idioma** no menu da conta, abra o menu da conta e
selecione **Relatórios de diagnóstico**. Nas versões anteriores, abra o controle
de aparência na barra superior.

O envio de relatórios começa desativado. Ative-o para compartilhar com a
Polymorfa as categorias de erro, as posições no código-fonte do aplicativo e a
versão do app. Desative-o para interromper novos relatórios. Esta é uma
preferência local, separada da permissão para abrir sessões de produção.

Os relatórios excluem o texto das mensagens, os dados da conta, as credenciais,
os corpos de requisição e os caminhos de arquivos locais. O envio de relatórios
fica pausado durante a entrada na conta e a autorização de dispositivo e não coleta erros
das páginas do WhatsApp incorporadas. O envio de relatórios de erro não ativa o
armazenamento hospedado de mensagens nem envia os seus chats.

Se o Inspector informar que o envio de relatórios não está configurado nesta
build, deixe-o desativado e siga [as instruções de suporte](/pt-br/desktop-app/troubleshooting#obter-ajuda).

## Próximos passos

> **[Início rápido do Sandbox](/pt-br/sandbox/quickstart)**
>
> Crie e gerencie um número de teste.

> **[Solução de problemas](/pt-br/desktop-app/troubleshooting)**
>
> Diagnostique problemas do Inspector e de conexão.


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