AcademIA Organization
AcademIA Organization conecta tu flujo con la organización de una empresa en AcademIA, la parte corporativa de la plataforma. Con un solo componente trabajas con cuatro cosas: los miembros (los empleados que se forman), las invitaciones para unirse, las rutas de aprendizaje asignadas a la empresa y las analíticas de su formación.
Es útil para Recursos Humanos y para quien se ocupa de la formación del equipo: altas, recordatorios a quien no avanza e informes periódicos, sin entrar a AcademIA cada vez.
Cuándo usarlo
- Cuando entra un empleado nuevo en tu sistema de RR. HH., quieres invitarlo a la organización y asignarle la ruta de acogida.
- Cada semana quieres enviar un recordatorio a quien lleva tiempo sin avanzar en su formación.
- Cada mes necesitas un informe de la formación del equipo por correo o en una hoja de cálculo.
- Un asistente de RR. HH. debe responder cómo va el equipo o matricular a alguien en una ruta.
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 debe actuar como Admin corporativo (CORPORATE_ADMIN) de la organización, o como Super admin (SUPER_ADMIN) de la plataforma. Lo más sencillo es que el Admin corporativo de la empresa cree la clave en Avanzado › Claves de API.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key. |
| Organization ID | La organización con la que trabajas. Déjalo vacío con una clave de Admin corporativo: se usa la organización de la clave. Con una clave de Super admin tienes que rellenarlo. |
| Resource | Con qué trabajas: Members, Invitations, Paths o Analytics. Por defecto, Members. |
| Operation | Lo que haces. La lista cambia según el Resource elegido. Ver Recursos y operaciones. |
Al elegir el recurso y la operación, el componente muestra solo los campos que esa operación necesita.
Recursos y operaciones
Members (miembros de la organización)
| Operación | Qué hace | Campos |
|---|---|---|
List Members | Trae los miembros con su puntuación, su progreso, su estado (new, active, risk o inactive) y sus rutas. | Opcionales: Filter (All, active o risk, que incluye a los que están en riesgo o inactivos) y Search (texto del nombre o del correo). |
Get Member | Trae un miembro con sus rutas, su actividad reciente y sus certificados. | Member ID |
Change Member Role | Hace a un miembro administrador de la organización o usuario normal. | Member ID, Role (CORPORATE_ADMIN gestiona la organización; CORPORATE_USER solo se forma). |
Remove Member | Saca a la persona de la organización. Libera su plaza, pero su cuenta de AcademIA sigue existiendo. | Member ID |
Remind Member | Envía a un miembro un recordatorio para que siga con su formación. | Member ID |
Member ID es el identificador de la persona en AcademIA. Lo devuelve List Members en su dato id.
Invitations (invitaciones para unirse a la organización)
| Operación | Qué hace | Campos |
|---|---|---|
List Invitations | Trae las invitaciones pendientes. | |
Invite Members | Invita por correo a unirse a la organización con un rol corporativo. | Emails (uno o varios, separados por comas o por líneas). Opcionales: Role (CORPORATE_USER, el de por defecto, o CORPORATE_ADMIN) y Department. |
Resend Invitation | Reenvía el correo de una invitación pendiente y la amplía 7 días. | Invitation ID (de List Invitations) |
Paths (rutas de aprendizaje de la organización)
| Operación | Qué hace | Campos |
|---|---|---|
List Organization Paths | Trae las rutas de la empresa, con cuántas personas las tienen asignadas, cuántas las han completado y cuántas están en riesgo. | |
Add Path | Añade una ruta al catálogo de la organización. | Path ID |
Remove Path | Quita una ruta de la organización. Solo funciona si no hay nadie matriculado. | Path ID |
Assign Path | Matricula en una ruta a varios miembros de la organización. | Path ID, Member IDs |
Member IDs admite identificadores o correos de miembros, separados por comas. Las personas que no son miembros de la organización se saltan y aparecen en el dato not_members del resultado. Si ninguna lo es, la operación falla.
Analytics (analíticas de la formación)
| Operación | Qué hace | Campos |
|---|---|---|
Organization Stats | Los totales de la organización: miembros, activos, en riesgo, puntuación media y progreso. | |
Leaderboard | Las personas con mejor puntuación, con su tendencia. | Top: cuántas personas (por defecto, 10). |
Skills Gap | El nivel actual frente al nivel objetivo en cada dimensión de habilidad. | |
Generate Report | Un informe de la formación de la organización para un periodo. | Report y Period |
- Report puede ser
executive-summary(resumen ejecutivo),skills-gap(brecha de habilidades),individual-progress(progreso individual),team-evolution(evolución del equipo),certificates(certificados) ohr(Recursos Humanos). - Period puede ser
30d(por defecto),7d,quarterly(trimestral) oyearly(anual). - Todos los informes salvo
certificatesincluyen un análisis hecho con IA y pueden tardar hasta 2 minutos.
Resultado
La salida Data devuelve la respuesta de AcademIA en datos: un elemento por miembro, invitación o ruta en las operaciones que listan, y el elemento con el que has trabajado en las demás.
El componente admite Batch Mode y se puede conectar a un Agente como herramienta. Ver Herramientas.
Ejemplo
Una empresa quiere animar cada lunes a quien se ha descolgado de su formación.
- Crea una programación semanal del flujo en el Programador.
- Añade AcademIA Organization con el recurso
Members, la operaciónList Membersyrisken Filter. Deja vacío Organization ID. - Conecta Data a otro AcademIA Organization con la operación
Remind Member, activa Batch Mode y, en Member ID, toma el datoidde cada miembro. - Si quieres, añade al final un correo al responsable de formación con la lista de personas avisadas.
Buenas prácticas
- Deja vacío Organization ID cuando la clave es de Admin corporativo. No escribas un valor inventado.
- Para el informe mensual, usa
Generate Reportcon Reporthry Period30d, y conecta el resultado a un correo o a una hoja de cálculo. - Si quieres invitar a alguien a una sola ruta sin hacerlo miembro de la empresa, usa AcademIA Enrollment.
Seguridad y limitaciones
- Por seguridad, el componente solo permite los dos roles corporativos (
CORPORATE_USERyCORPORATE_ADMIN) al cambiar un rol o al invitar, y solo matricula en una ruta a personas que ya son miembros. No se pueden dar roles de la plataforma desde aquí. Remind MemberySkills Gapnecesitan el plan BUSINESS de AcademIA o uno superior. Un mismo miembro solo puede recibir un recordatorio cada 24 horas.Invite Membersfalla si se superan las plazas del plan de la organización.- Una clave de Admin corporativo solo ve su propia organización. Si pones el Organization ID de otra, AcademIA rechaza la operación.
Componentes relacionados
- AcademIA Enrollment: invitaciones a una ruta y matrículas en programas.
- AcademIA Users: cuentas de la plataforma (para Super admin).
- AcademIA Webhook: pone en marcha el flujo con lo que pasa en AcademIA.