Saltearse al contenido

AcademIA Users

AcademIA Users gestiona las cuentas de la plataforma AcademIA: puedes buscarlas, crear cuentas nuevas con su rol y cambiar el rol, la organización o el acceso de una cuenta existente. Es la herramienta del administrador de la plataforma.

Es útil para las altas y bajas automáticas: crear la cuenta de cada empleado, alumno o profesor nuevo, y suspenderla cuando una persona deja la empresa.

Cuándo usarlo

  • Cuando entra una persona nueva en tu sistema de Recursos Humanos, quieres crear su cuenta de AcademIA con el rol corporativo.
  • Cuando alguien deja la empresa, quieres suspender su acceso a AcademIA.
  • Necesitas un listado de las cuentas con un rol concreto, con su organización, sus matrículas y sus certificados.
  • Un asistente de administración debe poder buscar una cuenta o crearla cuando se lo pidan.

Configuración

Necesitas una credencial AcademIA con dos datos: AcademIA API address, la dirección de la API de AcademIA (por ejemplo https://academia.nappai.es/api), y API key, una clave de API de AcademIA (empieza por nappai_int_sk_live_). NappAI no pide el correo ni la contraseña de ninguna cuenta de AcademIA. Consulta Credenciales.

La clave la crea un administrador de AcademIA con Nueva clave:

  • Un Super admin, en Plataforma › Claves de API. En Actúa como elige el rol con el que trabaja la clave (y su organización o su facultad, si el rol la pide). Para el evaluador por voz y el mentor del curso, marca además Sesiones de voz y mentor.
  • Un Admin corporativo, en Avanzado › Claves de API. Esa clave actúa como administrador de su empresa y solo ve su organización.

AcademIA muestra la clave una sola vez: cópiala al crearla y pégala en API key. Si alguien la revoca en AcademIA, el flujo deja de entrar al momento y hay que crear otra.

Para este componente, la clave de la credencial debe actuar como Super admin (SUPER_ADMIN), el administrador de la plataforma. Para gestionar solo los miembros de una empresa basta con una clave de Admin corporativo: usa AcademIA Organization.

CampoQué hace
Credential (obligatorio)La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key.
ResourceSiempre Users.
OperationList Users, Create User o Update User. Ver Recursos y operaciones.

Recursos y operaciones

Users (cuentas de la plataforma)

OperaciónQué haceCampos
List UsersTrae las cuentas con su rol, su organización, sus matrículas y sus certificados.Opcionales: Search (texto del nombre o del correo), Role (Any o un rol) y Limit (por defecto 500, como mucho 5.000).
Create UserCrea una cuenta con un rol, y con una organización si el rol es corporativo.Email, Full name. Opcionales: Role, Organization ID y Password.
Update UserCambia el rol, la organización o el acceso de una cuenta.User ID y al menos un cambio en Role, Access u Organization ID.

Los roles son FREE, STARTER, PRO, ELITE, CORPORATE_USER, CORPORATE_ADMIN, CONTENT_ADMIN, FACULTY_ADMIN y SUPER_ADMIN.

  • En Create User, Role es FREE por defecto. Los roles CORPORATE_USER y CORPORATE_ADMIN necesitan Organization ID.
  • Full name es el nombre y los apellidos, de al menos 2 caracteres.
  • Password es opcional y debe tener al menos 8 caracteres. Si lo dejas vacío, se pone una contraseña aleatoria y la persona elige la suya con la opción de recuperar la contraseña de AcademIA. La cuenta se crea con el correo ya verificado.
  • En Update User, Role en Keep deja el rol como está; Access puede ser Keep (sin cambios), Suspend (bloquea el inicio de sesión) o Reactivate (lo permite de nuevo).
  • User ID es el identificador de la cuenta. Lo devuelve List Users en su dato id.

Resultado

La salida Data devuelve la respuesta de AcademIA en datos: un elemento por cuenta en List Users, y la cuenta creada o modificada en las demás.

El componente admite Batch Mode y se puede conectar a un Agente como herramienta. Ver Herramientas.

Ejemplo

Una empresa quiere quitar el acceso a AcademIA a quien deja la plantilla.

  1. Tu sistema de RR. HH. avisa al flujo por un Webhook Input con el correo de la persona que se va.
  2. Añade AcademIA Users con la operación List Users y el correo en Search.
  3. Conecta Data a otro AcademIA Users con la operación Update User: en User ID el dato id de la cuenta encontrada y en Access, Suspend.

Buenas prácticas

  • Search y Role filtran entre las cuentas leídas. Si tienes muchas y no encuentras una, sube Limit.
  • Para dar de alta a muchas personas, deja vacío Password: cada una elegirá la suya.

Seguridad y limitaciones

  • No tomes el rol de lo que escribe una persona en un formulario público: decide tú el rol en el flujo. Si no, alguien podría darse SUPER_ADMIN o CONTENT_ADMIN.
  • No escribas una misma contraseña para muchas personas en el componente.
  • Una clave de Super admin puede hacer cualquier cosa en AcademIA: guárdala solo en los flujos que la necesiten.

Componentes relacionados