Saltearse al contenido

AcademIA Enrollment

AcademIA Enrollment se ocupa de que las personas lleguen a tus cursos de AcademIA. Con un solo componente trabajas con dos cosas: las invitaciones a una ruta de aprendizaje (un curso) y las matrículas en la edición de un programa, por ejemplo un máster o un curso académico.

Es útil cuando las inscripciones llegan por otros canales, como un formulario web, una hoja de cálculo, tu CRM o un agente de IA, y quieres que entren en AcademIA sin hacerlo a mano.

Cuándo usarlo

  • Cada persona que se apunta en el formulario de tu web debe quedar matriculada en el programa.
  • Cuando se cierra una venta en tu CRM, quieres invitar al cliente a la ruta de bienvenida.
  • Tienes una lista de cientos de correos y quieres invitarlos a una ruta de una vez.
  • Quieres suspender, dar de baja o reactivar a un alumno de un programa.
  • Necesitas un listado de quién tiene la invitación pendiente para hacerle seguimiento.

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 de contenido (CONTENT_ADMIN), Admin de facultad (FACULTY_ADMIN) o Super admin (SUPER_ADMIN).

CampoQué hace
Credential (obligatorio)La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key.
ResourceCon qué trabajas: Path Invitations (invitaciones a una ruta) o Program Enrollments (matrículas en un programa). Por defecto, Path Invitations.
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

Path Invitations (invitaciones a una ruta de aprendizaje)

OperaciónQué haceCampos
List Path InvitationsTrae las invitaciones de una ruta, con su estado, la persona invitada y quién la invitó.Path ID. Opcionales: Status (Any, PENDING, ACCEPTED, EXPIRED o REVOKED), Page y Per page.
Invite to PathInvita por correo a una o varias personas a una ruta.Path ID, Emails. Opcionales: Message y Expires at.
Revoke Path InvitationAnula una invitación pendiente.Invitation ID
Resend Path InvitationVuelve a avisar de una invitación pendiente.Invitation ID
  • Emails admite un correo o varios separados por comas o por líneas, hasta 500 por ejecución.
  • Message es una nota que acompaña a la invitación, de hasta 500 caracteres.
  • Expires at es la fecha en que caduca la invitación, por ejemplo 2026-12-31 o 2026-12-31T23:59:00Z.
  • Invitation ID sale de List Path Invitations. Solo se pueden anular o reenviar las invitaciones pendientes.

Si la persona invitada ya tiene cuenta en AcademIA y la ruta tiene la matrícula automática, queda matriculada en el momento. Si todavía no tiene cuenta, la invitación la espera hasta que se registre.

Program Enrollments (matrículas en una edición de un programa)

OperaciónQué haceCampos
List Program EnrollmentsTrae los alumnos matriculados en una edición, con su estado y su progreso.Edition ID. Opcionales: Status (Any, ACTIVE, COMPLETED, DROPPED o SUSPENDED), Academic year, Page y Per page.
Enroll in ProgramMatricula a un alumno en una edición, por su correo o por su identificador de AcademIA.Edition ID y Student email o Student ID. Full name si la persona aún no tiene cuenta. Opcionales: Academic year y Path IDs.
Update Program EnrollmentCambia el estado de una matrícula.Enrollment ID, New status
  • Si el correo de Enroll in Program no tiene cuenta en AcademIA, se crea con el Full name indicado y AcademIA le envía un correo de activación.
  • Academic year se escribe como 2026-2027. Path IDs son las rutas del programa en las que se matricula, separadas por comas.
  • New status puede ser ACTIVE (reactiva la matrícula), SUSPENDED (la pausa) o DROPPED (la marca como baja).
  • Page y Per page están en los ajustes avanzados: por defecto se trae la página 1 con 20 resultados, y como mucho 100 por página.

Resultado

La salida Data devuelve la respuesta de AcademIA en datos: un elemento por invitación o por matrícula en las operaciones que listan, y el elemento creado o cambiado en las demás. Así el siguiente componente puede leer directamente cada dato, como el correo o el estado.

El componente admite Batch Mode, para matricular o invitar a cada persona de una lista, y se puede conectar a un Agente como herramienta. Ver Herramientas.

Ejemplo

Una escuela de negocios recibe las inscripciones a su máster por un formulario web.

  1. El formulario llega al flujo por un Webhook Input con el nombre y el correo de la persona.
  2. Añade AcademIA Enrollment con el recurso Program Enrollments y la operación Enroll in Program.
  3. En Edition ID pon el identificador de la edición de este año, en Student email el correo del formulario y en Full name su nombre, por si todavía no tiene cuenta.
  4. Conecta Data a un componente de correo que avise a secretaría de la nueva matrícula.

Buenas prácticas

  • Los identificadores son los de AcademIA: el de una ruta lo consigues con AcademIA Content, operación List Paths; el de una edición lo ves en el programa, dentro de AcademIA. No escribas valores inventados.
  • Como herramienta de un agente, fija tú Path ID o Edition ID en el componente y deja que el agente rellene los correos, los nombres y el mensaje.
  • Si AcademIA responde con un error 500, lo más habitual es que un identificador no exista o que un valor no sea válido. Revisa lo que has enviado.

Seguridad y limitaciones

  • AcademIA no envía ningún correo con las invitaciones a una ruta. Avisa tú a las personas, por ejemplo con un componente de correo después de Invite to Path.
  • Resend Path Invitation solo vuelve a avisar, dentro de la aplicación, a quien ya tiene cuenta. Tampoco envía correo.
  • DROPPED no quita el acceso a las rutas que el alumno ya había empezado.
  • Si pasas más de 500 correos en Emails, solo se invita a los 500 primeros. Para listas más largas, usa Batch Mode o divide la lista.
  • La dirección y la clave de API de AcademIA se guardan en la credencial; no las escribas en el componente.

Componentes relacionados