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

Inspector: propriedade e dispositivos

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

Ver em Markdown

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