Guías

Guías del panel

Tutoriales paso a paso para configurar el workspace, invitar al equipo y permisos.

Panel de Claix

Añadir miembros a un Workspace

Un workspace en Claix es el espacio compartido donde viven tus schemas, widgets, logs, claves API y la configuración de tu empresa. La persona que crea la cuenta y configura el workspace es el Owner (propietario). El resto del equipo entra como miembros invitados.

Esta guía explica todo el flujo desde la interfaz: cómo invitar desde el panel, cómo se registra un invitado y qué puede ver o hacer cada perfil. No hace falta tocar la API ni escribir código.

1. Owner y miembros: ¿quién es quién?

Cuando te registras en Claix y completas el onboarding, creas un workspace a tu nombre. Eres el Owner: tu correo es el de la cuenta principal y tú controlas la facturación, el token de invitación y los datos de empresa.

Un miembro es alguien a quien invitas. Cada miembro tiene su propio acceso (Google o email y contraseña), pero al iniciar sesión entra al mismo workspace que el Owner: ve los mismos schemas, widgets y logs del equipo, no una cuenta aislada.

En la lista de miembros (página Cuenta del panel) cada persona muestra un rol visible (por ejemplo «CTO», «Finanzas» o «Viewer»). Ese texto es una etiqueta para el equipo: ayuda a identificar la función de cada uno. Solo puede existir un Owner por workspace; ese rol está reservado para quien creó el espacio.

2. Cómo invita el Owner (paso a paso)

  1. Inicia sesión en Claix y abre el panel en /dashboard.
  2. En la barra lateral, entra en Cuenta (icono de usuario).
  3. En la columna de datos verás la tarjeta destacada Workspace Token. Ahí está el código secreto que identifica tu workspace. Por defecto aparece enmascarado; pulsa Mostrar para verlo completo y Copiar cuando lo necesites.
  4. En la misma columna de Datos, dentro de una subtarjeta naranja, completa los datos de facturación: razón social, NIF de facturación y dirección fiscal. Son obligatorios para emitir facturas correctamente y solo los ve el Owner; los miembros no tienen acceso a estos campos.
  5. Si el token pudo haberse filtrado o quieres invalidar invitaciones antiguas, usa el botón Regenerar (a la derecha del título de la tarjeta). Se generará un token nuevo; el anterior dejará de servir para registrarse.
  6. Comparte con tu compañero dos cosas: el token y el enlace de registro de workspace: /workspace-login (en tu dominio, por ejemplo https://www.claix.dev/workspace-login).
  7. Opcional: en la columna derecha de Cuenta, pulsa el botón + junto a «Miembros». Se abre un recordatorio con el mismo enlace y las instrucciones para invitar.

Importante: /workspace-login es solo para unirse al workspace por primera vez (registro). No es la pantalla de inicio de sesión habitual. Una vez registrado, el miembro entrará siempre por /inicio-sesion, igual que tú.

3. Cómo se registra el miembro invitado

  1. Abre /workspace-login en el navegador.
  2. Pega el Workspace Token que te pasó el Owner y valida. Si el token es correcto, verás el nombre del workspace y el formulario de registro.
  3. Completa la columna izquierda:
    • Nombre: cómo quieres aparecer en la lista del equipo.
    • Rol: una etiqueta libre (ej. «Operaciones», «Desarrollo»). No puedes usar la palabra «Owner»; ese rol está reservado.
    • Acepta las condiciones legales.
  4. Cuando nombre, rol y condiciones estén listos, se habilita la columna derecha Crea tu acceso: regístrate con Google o con email y contraseña, igual que en un registro normal de Claix.
  5. Tras el registro, cierra sesión o abre una pestaña nueva y entra por /inicio-sesion. Ya formas parte del workspace del Owner.

Si el token no funciona, pide al Owner uno actualizado (puede haberlo regenerado). Si ya tienes cuenta de Claix con ese email en otro workspace, el flujo puede variar; en ese caso contacta con soporte o con el Owner.

4. Qué ven ambos al entrar al panel

Tanto Owner como miembros comparten la misma barra lateral y las mismas secciones de trabajo:

  • Schemas, Widgets, Logs, API Keys y la documentación API.
  • Arriba a la izquierda: logo de Claix y el texto Workspace de (o Workspace of en inglés) seguido del nombre de empresa del workspace.
  • En Cuenta, la lista de Miembros con nombre, rol y email de cada persona.

Todo lo que creáis (schemas, widgets, llamadas registradas en logs) pertenece al workspace compartido, no a una cuenta personal aislada.

5. Permisos: qué puede hacer cada uno

La tabla resume las diferencias desde la interfaz del panel. Si una acción no aparece o el botón está deshabilitado, es porque tu perfil no tiene permiso para ello.

Área del panelOwnerMiembro
Nombre de empresa, teléfono y paísPuede editar y guardar en CuentaNo aparece; solo ve su email e idioma
Datos de facturación (razón social, NIF, dirección fiscal)Subtarjeta naranja en Datos; obligatorios para facturasNo aparece; solo el Owner los ve y edita
Idioma del panelPuede cambiarloPuede cambiarlo (solo afecta a su sesión)
Workspace Token (mostrar, copiar, regenerar)Sí, en la tarjeta de CuentaNo ve la tarjeta
Lista de miembrosVe la lista; icono de lápiz para editar nombre y rolVe la misma lista en solo lectura
Añadir miembros (+)Sí; muestra instrucciones con /workspace-loginNo ve el botón
Schemas, Widgets, Logs, API KeysAcceso completo de lectura y ediciónIgual que el Owner
Precios y facturación (menú lateral)Acceso completo: método de pago, deuda, zona sensibleAcceso a la página; ve precios a la derecha y estado del Modo Persistente
Pagar deuda o gestionar tarjetaNo; no ve formulario de tarjeta ni botones de pago de deuda
Modo PersistentePuede activar, pagar y desactivarPuede abrir la página informativa y ver el estado; el botón de pago está deshabilitado
Ayuda y cerrar sesión

6. Consejos para el Owner

  • Trata el Workspace Token como una contraseña de invitación: no lo publiques en canales abiertos.
  • Si alguien deja el equipo, regenera el token para que enlaces antiguos dejen de funcionar. Puedes editar el nombre o rol del miembro desde el lápiz en la lista (no elimina su acceso de login; eso requiere gestión de cuenta aparte).
  • El nombre de empresa tiene un límite de caracteres para que quepa en la barra lateral; si lo cambias, todo el equipo verá el nuevo nombre al recargar.
  • Solo el Owner debe encargarse de facturación y del Modo Persistente de pago; los miembros pueden consultar precios y estado, pero no cargar cobros al workspace.
  • Antes de emitir facturas, revisa que la subtarjeta de datos de facturación en Cuenta esté completa (razón social, NIF y dirección fiscal). Si falta alguno, verás un aviso bajo el campo correspondiente.

7. Consejos para el miembro

  • Guarda /inicio-sesion como entrada habitual; /workspace-login solo la necesitas el día que te unes.
  • Tu rol en la lista es informativo para el equipo; no cambia automáticamente qué menús ves (los permisos los marca ser Owner o miembro, como en la tabla anterior).
  • Si necesitas cambiar método de pago, activar Modo Persistente o regenerar el token, pide al Owner que lo haga desde su Cuenta.
  • Puedes trabajar con normalidad en schemas, widgets y API keys del workspace; los cambios son visibles para todo el equipo.

8. Preguntas frecuentes

¿Puedo tener dos Owners? No. Solo quien creó el workspace conserva el rol Owner. No puedes asignar «Owner» a otro miembro desde el registro ni desde la edición de miembros.

¿El miembro tiene su propia API key? En el panel verá la sección API Keys del workspace. Las claves que gestionéis pertenecen al espacio compartido; coordina con el Owner quién crea o rota claves en producción.

¿Qué pasa si regenero el token? Los miembros ya registrados siguen entrando por /inicio-sesion. Solo fallarán los intentos de registro nuevos que usen el token antiguo.

¿Dónde cambio el idioma del panel? En Cuenta → Idioma del panel. El texto «Workspace de» / «Workspace of» en la barra lateral sigue el idioma que elijas.