Vincular el cliente de escritorio con tu cuenta

Descripción general

Para que el cliente de Whisperer para macOS funcione con tus sesiones, suscripción y base de conocimientos, necesitas vincularlo con tu cuenta una sola vez. Instalar la aplicación por sí solo no otorga acceso — el dispositivo debe ser autorizado (autenticación de dispositivo).

La vinculación se basa en un flujo seguro de código de un solo uso: la aplicación inicia el inicio de sesión, te autenticas en el navegador, recibes un código de un solo uso y el navegador te devuelve a la aplicación. El código es de un solo uso y tiene una vigencia de 30 minutos.

Cuándo usar esto

Justo después de instalar el cliente y completar el asistente de permisos.
Al iniciar sesión en un ordenador nuevo o reinstalado.
Cuando la aplicación deja de ver tu cuenta (cerraste sesión en todos los dispositivos, cambiaste la contraseña, etc.) y necesita vincularse de nuevo.

Paso a paso

Inicia el inicio de sesión en la aplicación. Abre Whisperer en tu Mac e inicia el proceso de inicio de sesión/vinculación. La aplicación solicita un código de un solo uso al servidor (POST /v1/auth/desktop/code) y abre la página web de vinculación en tu navegador — /app/connect.
Inicia sesión en tu cuenta en el navegador. En la página /app/connect, inicia sesión con tu correo electrónico y contraseña. Si aún no tienes cuenta — regístrate y confirma tu correo electrónico (consulta Registro e inicio de sesión). El inicio de sesión es imposible hasta que tu correo esté confirmado.
Confirma la vinculación del dispositivo. Tras iniciar sesión, el panel web vincula el código de un solo uso con tu cuenta.
Regresa a la aplicación. El navegador te redirige automáticamente de vuelta a Whisperer mediante el esquema whisperer://auth?code=...&state=.... Si aparece una solicitud del sistema "¿Abrir en Whisperer?" — confírmala.
Espera el intercambio código-tokens. La aplicación intercambia el código de un solo uso por tokens de acceso y los almacena en almacenamiento seguro (cifrado). Después de eso, el cliente queda vinculado con tu cuenta.
Verifica. Asegúrate de que la aplicación muestre tu cuenta y plan. Ahora puedes iniciar sesiones.

Capturas de pantalla

📸 [Captura de pantalla: pantalla de inicio del proceso de inicio de sesión en el cliente de macOS]

📸 [Captura de pantalla: página web /app/connect con el formulario de inicio de sesión]

📸 [Captura de pantalla: solicitud del sistema macOS "¿Abrir en Whisperer?" (el esquema whisperer://)]

Errores comunes

El código expiró. El código de un solo uso tiene una vigencia de 30 minutos. Si tardaste demasiado o te interrumpieron, la vinculación no se completará. Solución: vuelve a la aplicación e inicia el proceso de inicio de sesión de nuevo — se emitirá un nuevo código.
El navegador no regresó a la aplicación. Si la redirección del esquema whisperer:// no se activó automáticamente, asegúrate de que Whisperer esté instalado en la carpeta "Aplicaciones" y repite el inicio de sesión. Cuando aparezca la solicitud del sistema para abrir la aplicación — confírmala.
El inicio de sesión falla — correo no confirmado. No puedes iniciar sesión hasta que tu correo esté confirmado con el código de 6 dígitos. Confirma tu correo e inténtalo de nuevo.
Múltiples pestañas de /app/connect. Abrir varias páginas de vinculación a la vez interrumpe el flujo. Cierra las adicionales y ejecuta la vinculación de nuevo desde la aplicación.
Cuenta congelada o bloqueada. Si el estado de la cuenta es frozen/banned, la vinculación no se completará — contacta con el soporte.

Buenas prácticas

Realiza la vinculación justo después de la instalación, sin demora — así tendrás holgura dentro del TTL de 30 minutos del código.
Mantén la página /app/connect abierta en una sola pestaña.
Si cambiaste la contraseña o cerraste sesión en todos los dispositivos, vincula el cliente de nuevo — los tokens antiguos quedan invalidados (token_version).
No pases el código de un solo uso manualmente ni compartas el enlace whisperer://auth?... — es un secreto para tu dispositivo.