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.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key. |
| Resource | Siempre Users. |
| Operation | List Users, Create User o Update User. Ver Recursos y operaciones. |
Recursos y operaciones
Users (cuentas de la plataforma)
| Operación | Qué hace | Campos |
|---|---|---|
List Users | Trae 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 User | Crea 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 User | Cambia 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 esFREEpor defecto. Los rolesCORPORATE_USERyCORPORATE_ADMINnecesitan 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 enKeepdeja el rol como está; Access puede serKeep(sin cambios),Suspend(bloquea el inicio de sesión) oReactivate(lo permite de nuevo). - User ID es el identificador de la cuenta. Lo devuelve
List Usersen su datoid.
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.
- Tu sistema de RR. HH. avisa al flujo por un Webhook Input con el correo de la persona que se va.
- Añade AcademIA Users con la operación
List Usersy el correo en Search. - Conecta Data a otro AcademIA Users con la operación
Update User: en User ID el datoidde 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_ADMINoCONTENT_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
- AcademIA Organization: miembros, invitaciones y rutas de una empresa.
- AcademIA Enrollment: invitaciones a rutas y matrículas en programas.