# Inspector: propriedade e dispositivos

> Abra uma sessão exata do WhatsApp como um dispositivo vinculado nativo e persistente.

A conta da Polymorfa que conclui o pareamento nativo passa a ser dona de uma
sessão exata, real ou de teste, pelo Inspector. Ser dono não adiciona permissões
de equipe, projeto ou controle de sessão. Essas permissões continuam vindo da
participação atual da conta na equipe e da função dela no projeto.

## Abrir um número

1. Instale e autorize o [Polymorfa Inspector](https://docs.polymorfa.com/pt-br/testing/inspector/install).
2. Escolha **Abrir um número** na barra de título, ou pressione ⌘T no macOS ou
   Ctrl+T no Windows e no Linux.
3. Selecione a equipe dona do projeto.
4. Encontre o número no projeto, ou digite o nome, o telefone, o projeto ou o
   cliente no campo de busca.
5. Escolha **Abrir**. Se o número já estiver aberto neste computador, escolha
   **Ir para a aba**.

O Inspector abre o número como um dispositivo vinculado nativo em uma nova aba.
Um número real precisa ter uma conexão de Dispositivos vinculados ativa antes
que o Inspector possa abri-lo. Uma conexão da API oficial sozinha não dá acesso
como dispositivo nativo. Se os Dispositivos vinculados precisarem de um novo
pareamento, conclua essa etapa antes de reabrir o Inspector.

### Tipo de conta

As linhas mostram **WhatsApp**, **WhatsApp Business**, **API oficial** ou
**WhatsApp Business + API** separadamente de Teste ou Produção.
**Desconhecido** significa que o Inspector não identificou o tipo de conta;
isso não confirma acesso nem uma conexão.

**Abrir** fica desativado para um número que usa somente a API oficial, pois
essa conexão não abre o WhatsApp Web. A linha continua visível com **Não abre
o WhatsApp Web**. Uma aba existente mantém **Ir para a aba** e as verificações
normais de acesso. Números de app e de coexistência ainda precisam de uma
conexão elegível de Dispositivos vinculados e das suas permissões atuais.

### Abrir um número real

Antes de um número real abrir pela primeira vez, o Inspector pergunta **Abrir um
número de produção?** e mostra o número, o telefone, o projeto e a equipe. As
mensagens enviadas por ele chegam a contatos reais do WhatsApp. **Cancelar** vem
selecionado; Esc também cancela. Escolha **Abrir número de produção** para
continuar. O Inspector lembra a escolha só para esse número, e nada abre antes da
sua resposta.

### Se um número não abrir

O Inspector mantém o número na tela com o motivo, em vez de voltar à lista.
Escolha **Tentar novamente** ou **Voltar aos números**. Quando o acesso mudou ou
a sua sessão expirou, o Inspector oferece **Atualizar acesso** ou **Entrar de
novo**.

Fechar a janela do Inspector, reiniciar o app, tentar novamente uma conexão que
falhou ou sair do painel mantém o dispositivo vinculado nativo. Reabrir o número
no mesmo computador reconecta com a identidade nativa mantida, sem outra etapa
de pareamento.

O ponto de status da aba do número fica verde quando o WhatsApp termina de
carregar. O Console mostra o nome e a foto da conta de quem tem o claim, quando
disponível. O Inspector mostra o avatar desse membro e **Em uso por _nome_**
quando outro membro usa o número. Os identificadores brutos de dispositivo não
são exibidos. Outros membros autorizados do projeto podem ver quem tem o claim,
mas não podem substituí-lo sem aviso.

## Encontrar os números de um cliente

O Inspector mostra o cliente atribuído na linha de cada número. Digite o nome do
cliente no campo de busca de **Abrir um número** para listar só os números
atribuídos a ele. O cliente, o aviso **Em uso por** e o avatar de quem tem o claim
são informações separadas. O cliente indica a pessoa ou empresa a quem o número
pertence. Quem tem o claim é o usuário do Inspector que controla o dispositivo
vinculado nativo.

O Inspector só aceita uma atribuição de cliente quando ela pertence ao projeto e
à sessão selecionados. Se essa combinação mudar enquanto uma sessão abre, o
Inspector para em vez de associar os metadados do cliente errado. Uma
atribuição válida é mantida quando o app se reconecta ou restaura uma sessão
mantida.

## Desfazer o claim de um número

Desfaça o claim antes que outra pessoa da equipe pareie o número no Inspector.
Você pode desfazer seu próprio claim. Um proprietário ou administrador da equipe
pode desfazer o claim de outro membro. Não há transferência direta de um claim.

No Console, abra **Números**. A coluna **Com claim de** mostra quem tem o claim
de cada número. Quando você pode desfazer o claim, **Desfazer claim** aparece
abaixo do nome dessa pessoa e no menu de ações do número, que também fica
disponível em telas estreitas. Selecione e confirme. Desfazer seu próprio claim
remove seu dispositivo do Inspector desse número. Desfazer o claim de outro
membro remove o dispositivo do Inspector dessa pessoa e encerra a sessão dela
nesse número.

Para usar a API, consulte [Desfazer o claim no Inspector](https://docs.polymorfa.com/api/numbers/release-inspector-claim).
Um número de teste exige `sandbox:write`; um número real exige `sessions:manage`.
Um token de projeto fica limitado ao próprio projeto. Uma credencial restrita a
um número não pode desfazer um claim.

Leia `inspector.claim.claimedAt` do número e envie esse valor como
`expectedClaimedAt`. Se o claim mudou, a resposta é `409`. Leia o número de novo
antes de decidir se deve tentar novamente. Se não for possível confirmar a
remoção do dispositivo, a resposta é `503` com `Retry-After`. Aguarde esse
intervalo e repita com o mesmo horário esperado. Um número já sem claim retorna
`released: false`.

O claim é liberado depois que os dispositivos do Inspector de quem fez o claim
são revogados. A próxima pessoa precisa parear de novo. Em um número real,
apenas o dispositivo do Inspector é removido. O telefone e o dispositivo
vinculado da Polymorfa continuam conectados. Desfazer o claim de outro membro
envia uma notificação a ele no Console.

Remover um número de teste fecha as conexões do Inspector com ele, invalida os
dispositivos mantidos e limpa o estado simulado. Fechar o app, tentar novamente e
sair do painel mantêm o dispositivo vinculado.

## Remover ou transferir uma sessão

Remover um número de teste fecha as conexões ativas do Inspector com ele,
invalida os dispositivos mantidos e limpa o estado simulado. Uma transferência
de propriedade autorizada invalida os dispositivos do Inspector do dono anterior
antes que o novo dono possa parear. Fechar o app normalmente, tentar novamente e
sair do painel não desvinculam o dispositivo.

## Solução de problemas

- Escolha **Verificar de novo** em um projeto vazio, ou atualize a barra
  lateral, quando um número de teste recém-criado não aparecer.
- Confirme que a equipe selecionada ainda é dona do projeto.
- Confirme que o número não mostra **Em uso por** outro membro.
- Se **Abrir** falhar, tente novamente uma vez e depois siga a [solução de
  problemas do Inspector](https://docs.polymorfa.com/pt-br/testing/inspector/troubleshooting).

- **[Pool de números](https://docs.polymorfa.com/pt-br/testing/test-numbers)**
Liste e gerencie números de teste.

- **[Instalar o Inspector](https://docs.polymorfa.com/pt-br/testing/inspector/install)**
Baixe e autorize o app de testes para desktop.
