Acceso y autenticación

Objetivo

Explicar como entrar al portal: iniciar sesión, crear un workspace, entrar con Google, verificar tu email, aceptar invitaciones de equipo y recuperar tu contraseña.

Acceso

Las páginas de autenticación son públicas (no requieren sesión). Rutas:

• /login — iniciar sesión
• /signup?plan={plan} — crear un workspace (se llega desde /pricing)
• /auth/complete?plan={plan} — terminar un registro con Google
• /auth/verified — email confirmado
• /auth/verify-failed?reason={reason} — enlace de verificación expirado o inválido
• /forgot-password — solicitar un enlace de reinicio
• /reset-password — definir una nueva contraseña
• /invite/{token} — aceptar una invitación de equipo

Tras un inicio de sesión correcto llegas al dashboard de tu workspace en /app/{tenant}/dashboard.

Roles

• El registro por cuenta propia crea al owner del workspace.
• Las invitaciones de equipo asignan un rol: admin, agent o viewer (lo elige quien te invita).
• owner y admin pueden administrar el workspace; agent y viewer tienen acceso limitado.

Iniciar sesión

Ve a /login y elige una opción:

• Continue with Google — entra con tu cuenta de Google. El selector de cuentas de Google siempre aparece para que elijas la cuenta de forma deliberada.
• Email + Password — completa los campos y pulsa Sign in.

Campos:

Notas:

• Usa Forgot password? para iniciar un reinicio.
• Create account te lleva a /pricing para elegir un plan primero.
• Los intentos de inicio de sesión tienen límite (hasta 10 por 15 minutos). Si lo alcanzas, espera unos minutos e inténtalo de nuevo.

Ya iniciaste sesión

Si abres /login cuando todavía tienes una sesión activa, la página no la reutiliza en silencio. Muestra You are already signed in con tu email y dos opciones:

• Continue as {name} — mantener la sesión actual e ir a tu dashboard.
• Use another account — cerrar sesión en este navegador y mostrar el formulario de inicio de sesión.

Crear cuenta (registro)

El registro siempre parte de un plan seleccionado. Si abres /signup sin un plan, verás Choose a plan to continue y un botón View plans que te envía a /pricing.

Pasos:

1. Ve a /pricing y elige un plan.
2. Se te lleva a /signup?plan={plan}.
3. Pulsa Continue with Google (termina en /auth/complete) o completa el formulario y pulsa Create account.

Campos:

Reglas de la Workspace URL:

• Solo minúsculas, números y guiones.
• Entre 3 y 63 caracteres; no puede empezar ni terminar con guion.
• Algunos nombres están reservados (por ejemplo www, api, admin, support) y no se pueden usar.
• La disponibilidad se comprueba mientras escribes; verás available, already taken o checking.

Después de enviar:

• Plan Free: tu workspace abre de inmediato en /app/{tenant}/dashboard.
• Plan de pago: continúas a un checkout seguro de Stripe con 14 días de prueba gratis.
• Los workspaces Free usan tu propia clave de OpenAI (BYOK); los créditos de IA gestionados son un beneficio de pago.
• Se envía un email de confirmación para que verifiques tu dirección (ver Verificación de email).
• Los planes Enterprise se contratan con asistencia de ventas y no se crean aquí.

Completar cuenta (Google)

Si entras con Google y aún no tienes un workspace, se te envía a /auth/complete para terminar la configuración. Debe haber un plan seleccionado; de lo contrario se te redirige a /pricing.

Campos:

Pulsa Finish setup. Los planes Free abren el dashboard; los de pago continúan al checkout. Las cuentas creadas con Google quedan verificadas automáticamente.

Verificación de email

Las cuentas nuevas de email/contraseña reciben un email de confirmación de Helios Vision AI. El enlace es válido durante 72 horas.

1. Abre el email de confirmación.
2. Haz click en Confirm Account.
3. Llegas a /auth/verified. Si tienes sesión iniciada, continúa a tu dashboard; si no, inicia sesión.

Notas:

• Algunas acciones quedan restringidas hasta que verifiques (por ejemplo, invitar miembros del equipo).
• Los registros con Google ya están verificados y se saltan este paso.
• Si el enlace expiró o es inválido, se te envía a /auth/verify-failed, donde puedes ingresar tu email para recibir uno nuevo. Por tu privacidad, se muestra la misma confirmación exista o no una cuenta, y no se puede pedir un nuevo enlace más de una vez por minuto.

Invitaciones de equipo

Las invitaciones las crea un owner o admin del workspace y son válidas por 7 días.

1. Abre el enlace de invitación /invite/{token}.
2. Revisa el nombre del workspace, el rol que recibirás y tu email invitado (que es fijo).
3. Completa el formulario y pulsa Accept Invitation and Create Account.
4. Tu cuenta se crea con el rol asignado y se abre el dashboard del workspace.

Campos:

Nota: si la invitación expiró, la página muestra Invitation expired. Pide una nueva al administrador del workspace.

Recuperar contraseña

1. Ve a /forgot-password.
2. Ingresa tu Email y pulsa Send reset link.
3. Por tu privacidad, la página confirma que se envió un enlace si existe una cuenta.
4. Abre el email y sigue el enlace a /reset-password.
5. Define la nueva contraseña y pulsa Update password. Vuelves a /login.

Campos de reinicio:

Cerrar sesión

Usa el menú de usuario en el sidebar y elige Sign out. Vuelves a /login.

Buenas prácticas

• Elige una Workspace URL corta y fácil de recordar — es la dirección de tu workspace y no puede coincidir con otra.
• Usa una contraseña fuerte: al menos 8 caracteres, mezclando mayúsculas, minúsculas y números.
• Verifica tu email pronto después de registrarte para desbloquear todas las acciones.
• En una computadora compartida, usa Use another account o Sign out para no dejar la sesión abierta.

Errores comunes