Pular para o conteúdo
Atalho: /, ⌘K ou Ctrl+K

Instale o Polymorfa Inspector

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

Ver em Markdown

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.

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

PlataformaArquiteturaArtefato
macOSApple SiliconPolymorfa-Inspector-arm64.dmg
macOSIntelPolymorfa-Inspector-x64.dmg
Windowsx64Polymorfa-Inspector-x64.exe
Linuxx64Polymorfa-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#

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

Shell
shasum -a 256 Polymorfa-Inspector-arm64.dmg
# On an Intel Mac:
shasum -a 256 Polymorfa-Inspector-x64.dmg

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.

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çãoIdioma do Inspector
Igual à contaO idioma salvo na sua conta da Polymorfa. Esta é a opção padrão.
AutomáticoO primeiro idioma compatível na lista de idiomas do seu sistema operacional, inglês ou português. Se nenhum dos dois aparecer, inglês.
EnglishInglê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.

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.

Próximos passos#