Pareando o cliente desktop com sua conta

Visão geral

Para que o cliente Whisperer para macOS funcione com suas sessões, assinatura e base de conhecimento, você precisa pareá-lo com sua conta uma vez. Apenas instalar o aplicativo não concede acesso — o dispositivo precisa ser autorizado (autenticação de dispositivo).

O pareamento é baseado em um fluxo seguro de código de uso único: o aplicativo inicia o login, você se autentica no navegador, recebe um código de uso único e o navegador o retorna ao aplicativo. O código é de uso único e tem validade de 30 minutos.

Quando usar

  • Logo após instalar o cliente e passar pelo assistente de permissões.
  • Ao fazer login em um computador novo ou reinstalado.
  • Quando o aplicativo deixa de reconhecer sua conta (você saiu de todos os dispositivos, alterou sua senha etc.) e ele precisa ser pareado novamente.

Passo a passo

  1. Inicie o login no aplicativo. Abra o Whisperer no seu Mac e comece o login/pareamento. O aplicativo solicita um código de uso único ao servidor (POST /v1/auth/desktop/code) e abre a página web de pareamento no seu navegador — /app/connect.
  2. Faça login na sua conta no navegador. Na página /app/connect, faça login com seu e-mail e senha. Se você ainda não tem uma conta — registre-se e confirme seu e-mail (veja Registro e login). O login é impossível enquanto seu e-mail não for confirmado.
  3. Confirme o pareamento do dispositivo. Após o login, o painel web associa o código de uso único à sua conta.
  4. Retorne ao aplicativo. O navegador o redireciona automaticamente de volta ao Whisperer através do esquema whisperer://auth?code=...&state=.... Se aparecer um aviso do sistema "Abrir no Whisperer?" — confirme.
  5. Aguarde a troca do código por tokens. O aplicativo troca o código de uso único por tokens de acesso e os armazena em armazenamento seguro (criptografado). Depois disso, o cliente está pareado com sua conta.
  6. Verifique. Certifique-se de que o aplicativo exibe sua conta e plano. Agora você pode iniciar sessões.

Capturas de tela

📸 [Captura de tela: tela de início de login no cliente macOS]

📸 [Captura de tela: página web /app/connect com o formulário de login]

📸 [Captura de tela: aviso do sistema macOS "Abrir no Whisperer?" (o esquema whisperer://)]

Erros comuns

  • Código expirado. O código de uso único tem validade de 30 minutos. Se você demorou mais do que isso ou foi interrompido, o pareamento não será concluído. Solução: retorne ao aplicativo e inicie o login novamente — um novo código será emitido.
  • O navegador não retornou ao aplicativo. Se o redirecionamento do esquema whisperer:// não disparou automaticamente, certifique-se de que o Whisperer está instalado na pasta "Aplicativos" e repita o login. Quando aparecer um aviso do sistema para abrir o aplicativo — confirme.
  • Falha no login — e-mail não confirmado. Você não pode fazer login enquanto seu e-mail não for confirmado com o código de 6 dígitos. Confirme seu e-mail e tente novamente.
  • Várias abas /app/connect. Abrir várias páginas de pareamento ao mesmo tempo quebra o fluxo. Feche as extras e execute o pareamento novamente a partir do aplicativo.
  • Conta congelada ou banida. Se o status da conta for frozen/banned, o pareamento não será concluído — entre em contato com o suporte.

Boas práticas

  • Execute o pareamento logo após a instalação, sem demora — assim você ficará confortavelmente dentro da validade de 30 minutos do código.
  • Mantenha a página /app/connect aberta em apenas uma aba.
  • Se você alterou sua senha ou saiu de todos os dispositivos, pareie o cliente novamente — os tokens antigos são invalidados (token_version).
  • Não passe o código de uso único manualmente e não compartilhe o link whisperer://auth?... — ele é um segredo para o seu dispositivo.

Artigos relacionados