Saltearse al contenido

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.

CampoQué hace
Credential (obligatorio)La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key.
Organization IDLa 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.
ResourceCon qué trabajas: Members, Invitations, Paths o Analytics. Por defecto, Members.
OperationLo 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ónQué haceCampos
List MembersTrae 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 MemberTrae un miembro con sus rutas, su actividad reciente y sus certificados.Member ID
Change Member RoleHace 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 MemberSaca a la persona de la organización. Libera su plaza, pero su cuenta de AcademIA sigue existiendo.Member ID
Remind MemberEnví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ónQué haceCampos
List InvitationsTrae las invitaciones pendientes.
Invite MembersInvita 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 InvitationReenví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ónQué haceCampos
List Organization PathsTrae 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 PathAñade una ruta al catálogo de la organización.Path ID
Remove PathQuita una ruta de la organización. Solo funciona si no hay nadie matriculado.Path ID
Assign PathMatricula 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ónQué haceCampos
Organization StatsLos totales de la organización: miembros, activos, en riesgo, puntuación media y progreso.
LeaderboardLas personas con mejor puntuación, con su tendencia.Top: cuántas personas (por defecto, 10).
Skills GapEl nivel actual frente al nivel objetivo en cada dimensión de habilidad.
Generate ReportUn 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) o hr (Recursos Humanos).
  • Period puede ser 30d (por defecto), 7d, quarterly (trimestral) o yearly (anual).
  • Todos los informes salvo certificates incluyen 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.

  1. Crea una programación semanal del flujo en el Programador.
  2. Añade AcademIA Organization con el recurso Members, la operación List Members y risk en Filter. Deja vacío Organization ID.
  3. Conecta Data a otro AcademIA Organization con la operación Remind Member, activa Batch Mode y, en Member ID, toma el dato id de cada miembro.
  4. 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 Report con Report hr y Period 30d, 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_USER y CORPORATE_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 Member y Skills Gap necesitan el plan BUSINESS de AcademIA o uno superior. Un mismo miembro solo puede recibir un recordatorio cada 24 horas.
  • Invite Members falla 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