# 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](https://docs.polymorfa.com/pt-br/testing).

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
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
Get-FileHash .\Polymorfa-Inspector-x64.exe -Algorithm SHA256
```

**Linux**

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

```bash
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 e só abre o
navegador quando você pede. Escolha **Continuar no navegador**: o Inspector
copia o código para a área de transferência e depois abre a página de
dispositivo do Console. Se a cópia falhar, o Inspector avisa e abre a página
mesmo assim; digite o código manualmente. Depois que a página abre, o botão
passa a ser **Abrir o navegador novamente**, que reabre a página sem copiar de
novo. Acima dos botões, o Inspector mostra o endereço completo da página de
dispositivo. Selecione o endereço para abrir a página sem copiar o código,
escolha **Copiar link de entrada** para copiar o endereço ou digite-o em outro
aparelho. Copiar o endereço substitui o código na área de transferência, então o
Inspector pede que você copie o código de novo antes de aprovar. Se o navegador
não abrir, abra o endereço manualmente. O Inspector aguarda a aprovação de
qualquer forma até o código expirar.

Na página de dispositivo, faça estas verificações:

1. Confirme a conta conectada ou escolha **Usar outra conta**.
2. Escolha **Colar** para ler o código copiado da área de transferência ou
   digite o código mostrado pelo Inspector. 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. Confira se o código em **Código do Inspector** é o mesmo mostrado no
   Inspector e se você está aprovando com a conta certa.
4. Confira o app solicitante, a conta conectada, o horário e as informações
   de cidade e IP disponíveis nos detalhes da solicitação.
5. Selecione os projetos que o Inspector deve acessar. A caixa de uma equipe
   seleciona os projetos atuais dela. Para incluir todas as equipes e projetos
   aos quais você tem ou vier a ter acesso, escolha **Autorizar acesso a tudo**.
6. Escolha **Autorizar Inspector** ou **Recusar** se você não iniciou esta
   entrada.

Depois da aprovação, o navegador pede para abrir o Inspector. Se o Inspector
não abrir, escolha **Voltar ao Inspector** ou mude para ele manualmente. Se
você aprovou em outro dispositivo, como o celular, volte ao computador em que o
Inspector está aberto. O Inspector conclui a entrada sozinho mesmo quando o
navegador não consegue abri-lo. Depois de recusar, o Inspector não recebe
acesso e você pode fechar a aba.

Se o acesso solicitado mudar enquanto você tenta novamente uma aprovação ou
recusa não confirmada, o Console mostra a solicitação atualizada. Revise-a e
selecione o acesso novamente antes de autorizar o 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 os projetos selecionados sem expor a
sessão do navegador. A seleção não inclui projetos criados depois.
**Autorizar acesso a tudo** inclui equipes e projetos aos quais você tiver acesso
no futuro, sem criar associação nem elevar sua função. Você pode revisar, alterar
ou revogar esse acesso em
**Configurações da conta → Autenticação → Sessões ativas** no Console.

A seleção aceita até 1.000 projetos em 100 equipes. Para uma seleção maior,
remova projetos ou escolha **Autorizar acesso a tudo** explicitamente.

> **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

Se o Inspector informar que o acesso às equipes precisa ser renovado,
escolha **Entrar de novo**. Os números em cache ficam ocultos até uma verificação
confirmar o acesso. Uma falha de conexão posterior não restaura uma lista cujo
acesso foi negado. Uma falha temporária de conexão por si só mantém a última lista
carregada e oferece **Tentar agora** sem encerrar a sessão.

Se o Inspector não conseguir confirmar o acesso a todas as equipes, a tela
inicial mostra uma falha temporária de carregamento em vez de uma lista
incompleta de equipes ou números. Escolha **Tentar agora** quando o serviço
voltar. Uma falha temporária de carregamento não interrompe as conexões
existentes nem significa que o acesso às equipes foi removido. Mudanças
confirmadas de permissão continuam valendo.

Abrir outra aba ou o seletor de números fecha o painel de uma abertura que
falhou. Uma abertura concluída também fecha esse painel enquanto ainda for sua
seleção mais recente. Um resultado atrasado de uma abertura anterior não substitui
uma escolha mais nova.

Se outro número ainda estiver conectando, trocar de aba ou abrir o seletor mantém
a nova seleção. O outro número pode terminar a conexão em segundo plano.

Na primeira entrada, o Inspector mostra um caminho curto de configuração:
**Entrar**, **Escolher equipe**, **Abrir um número** e **Conectando**. A etapa de
equipe só aparece quando você autorizou mais de uma equipe. A última etapa fica em
**Conectando** até o WhatsApp informar que o número está pronto.

O seletor de equipes 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. Ele fica no topo da tela **Abrir um número** e no topo da barra lateral.

**Abrir um número** lista todos os números da equipe selecionada, agrupados por
projeto. Equipes com mais de 10 números também veem antes os seus números
recentes. Cada linha mostra o nome e o telefone do número. A linha acrescenta
**Produção** para um número real, um status só quando ele pede atenção (por
exemplo, **Conectando**, **Pausado**, **Parado** ou **Não está em execução**) e
**Em uso por _nome_** quando outro membro o usa. Números de teste não têm
rótulo. Digite no campo de
busca para encontrar um número pelo nome, telefone, projeto ou cliente. Use as
setas para mover entre as linhas e Enter para abrir a selecionada. Um número já
aberto mostra **Ir para a aba**. Um número em uso por outro membro mostra **Em
uso por _nome_** e não pode ser aberto. Um número com claim mostra o avatar de
quem fez o claim antes da ação; passe o mouse para ver **Com claim feito por você** ou
**Com claim feito por _nome_**. Um número sem claim não mostra avatar.

Abra a tela a qualquer momento com **Abrir um número** na barra de título, ou com
⌘T no macOS e Ctrl+T no Windows e no Linux. O atalho funciona com o foco no
WhatsApp; ⌘K e Ctrl+K continuam com o WhatsApp. Pressione Esc para limpar a busca e devolver o foco ao campo de busca.
Com a busca vazia, Esc volta à aba anterior se houver uma disponível.

Cada projeto tem um botão **Chave de teste**. Proprietários e administradores do
projeto também veem **Adicionar número de teste**, que abre a configuração de
números de teste do projeto no Console. Se uma equipe não tiver projetos, **Abrir
o Console** leva você a criar um; **Verificar de novo** recarrega a lista.

Os números abertos aparecem como abas. Cada aba mostra o nome do número, o
projeto e **Produção** para números reais, então dois números com o mesmo nome
continuam distintos. O ponto de status só fica verde depois que o WhatsApp
informa que o número está pronto. Passe o mouse ou foque uma aba para ver o
nome, o telefone, o projeto e o status. Na lista,
**Não está em execução** significa que o número não está rodando na Polymorfa
agora. Use as setas para mover entre as abas, Enter
para trocar e Delete para fechar a aba em foco. As abas que não cabem vão para um
menu **+_n_**.

Um número de produção mantém uma faixa fina acima do WhatsApp com **Produção**,
o telefone e o projeto. Números de teste não têm faixa, então o WhatsApp usa
toda a altura. Para copiar o telefone ou o ID de um número, clique com o botão
direito na aba ou na linha da barra lateral, ou foque-a e pressione Shift+F10,
e escolha **Copiar número de telefone** ou **Copiar UID**. As abas também mostram um botão de ações (três pontos)
ao passar o mouse ou focar. A barra de título confirma a cópia.

Com um número aberto, a barra lateral lista os projetos e números da equipe com
os mesmos rótulos de **Produção** e de status. Redimensione-a
arrastando a borda direita, ou oculte-a pela barra de título ou com ⌘S no macOS e
Ctrl+S no Windows e no Linux. A barra lateral fica oculta enquanto **Abrir um
número** está na tela e volta como você a deixou. Menus, configurações e caixas
de diálogo ficam acima do WhatsApp enquanto estão abertos.

A conta que conclui primeiro o pareamento nativo fica com o claim daquele número
no Inspector. O Console mostra o nome e a foto da conta desse membro, quando
disponível. O Inspector mostra o avatar de quem tem o claim; passe o cursor sobre
ele para ver quem é. Quando outro membro usa o número, aparece **Em uso por
_nome_**. Os outros membros autorizados do projeto podem ver quem tem o claim,
mas não podem assumir o número sem que essa pessoa 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. Com o tema do Inspector em **Sistema**, o Inspector
acompanha as mudanças do sistema operacional. Mudar o tema não recarrega os números abertos.

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 recarrega seus números. Ele nunca altera o idioma salvo na sua
conta; defina esse idioma no Console, em [Idioma](https://docs.polymorfa.com/pt-br/teams/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](https://docs.polymorfa.com/pt-br/testing/inspector/troubleshooting#obter-ajuda).

## Próximos passos

- **[Início rápido do Sandbox](https://docs.polymorfa.com/pt-br/testing/quickstart)**
Crie e gerencie um número de teste.

- **[Solução de problemas](https://docs.polymorfa.com/pt-br/testing/inspector/troubleshooting)**
Diagnostique problemas do Inspector e de conexão.
