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).
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key. |
| Resource | Con qué trabajas: Path Invitations (invitaciones a una ruta) o Program Enrollments (matrículas en un programa). Por defecto, Path Invitations. |
| 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
Path Invitations (invitaciones a una ruta de aprendizaje)
| Operación | Qué hace | Campos |
|---|---|---|
List Path Invitations | Trae 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 Path | Invita por correo a una o varias personas a una ruta. | Path ID, Emails. Opcionales: Message y Expires at. |
Revoke Path Invitation | Anula una invitación pendiente. | Invitation ID |
Resend Path Invitation | Vuelve 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-31o2026-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ón | Qué hace | Campos |
|---|---|---|
List Program Enrollments | Trae 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 Program | Matricula 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 Enrollment | Cambia el estado de una matrícula. | Enrollment ID, New status |
- Si el correo de
Enroll in Programno 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) oDROPPED(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.
- El formulario llega al flujo por un Webhook Input con el nombre y el correo de la persona.
- Añade AcademIA Enrollment con el recurso
Program Enrollmentsy la operaciónEnroll in Program. - 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.
- 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 Invitationsolo vuelve a avisar, dentro de la aplicación, a quien ya tiene cuenta. Tampoco envía correo.DROPPEDno 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
- AcademIA Organization: miembros de una empresa, sus plazas y sus rutas asignadas.
- AcademIA Content: crear, publicar y traducir rutas.
- AcademIA Webhook: pone en marcha el flujo con lo que pasa en AcademIA.