AcademIA Organization
AcademIA Organization connects your flow to a company’s organisation in AcademIA, the corporate side of the platform. With a single component you work with four things: the members (the employees who train), the invitations to join, the learning paths assigned to the company and the analytics of its training.
It is useful for Human Resources and for whoever looks after the team’s training: onboarding, reminders to those who don’t progress and regular reports, without going into AcademIA every time.
When to use it
- When a new employee joins your HR system, you want to invite them to the organisation and assign them the onboarding path.
- Every week you want to send a reminder to those who haven’t progressed in their training for a while.
- Every month you need a report of the team’s training by email or in a spreadsheet.
- An HR assistant must answer how the team is doing or enroll someone in a path.
Configuration
You need an AcademIA credential with two details: AcademIA API address, the AcademIA API address (for example https://academia.nappai.es/api), and API key, an AcademIA API key (it starts with nappai_int_sk_live_). NappAI doesn’t ask for the email or password of any AcademIA account. See Credentials.
An AcademIA administrator creates the key with New key:
- A Super admin, in Platform › API keys. In Acts as, choose the role the key works with (and its organisation or faculty, if the role needs one). For the voice evaluator and the course mentor, also tick Voice and mentor sessions.
- A Corporate admin, in Advanced › API keys. That key acts as their company’s administrator and only sees their organisation.
AcademIA shows the key only once: copy it when you create it and paste it into API key. If someone revokes it in AcademIA, the flow stops getting in straight away and you need to create another one.
For this component, the key must act as a Corporate admin (CORPORATE_ADMIN) of the organisation, or as a platform Super admin (SUPER_ADMIN). The simplest way is for the company’s Corporate admin to create the key in Advanced › API keys.
| Field | What it does |
|---|---|
| Credential (required) | The AcademIA credential. It fills in AcademIA API address and AcademIA API key for you. |
| Organization ID | The organisation you work with. Leave it empty with a Corporate admin key: the key’s organisation is used. With a Super admin key you have to fill it in. |
| Resource | What you work with: Members, Invitations, Paths or Analytics. Default: Members. |
| Operation | What you do. The list changes with the chosen Resource. See Resources and operations. |
When you choose the resource and the operation, the component shows only the fields that operation needs.
Resources and operations
Members (members of the organisation)
| Operation | What it does | Fields |
|---|---|---|
List Members | Returns the members with their score, progress, status (new, active, risk or inactive) and paths. | Optional: Filter (All, active or risk, which includes those at risk or inactive) and Search (text in the name or email). |
Get Member | Returns one member with their paths, recent activity and certificates. | Member ID |
Change Member Role | Makes a member an administrator of the organisation or a regular user. | Member ID, Role (CORPORATE_ADMIN manages the organisation; CORPORATE_USER only learns). |
Remove Member | Takes the person out of the organisation. It frees their seat, but their AcademIA account still exists. | Member ID |
Remind Member | Sends a member a reminder to keep up with their training. | Member ID |
Member ID is the person’s ID in AcademIA. List Members returns it in its id value.
Invitations (invitations to join the organisation)
| Operation | What it does | Fields |
|---|---|---|
List Invitations | Returns the pending invitations. | |
Invite Members | Invites people by email to join the organisation with a corporate role. | Emails (one or several, separated by commas or lines). Optional: Role (CORPORATE_USER, the default, or CORPORATE_ADMIN) and Department. |
Resend Invitation | Resends a pending invitation’s email and extends it by 7 days. | Invitation ID (from List Invitations) |
Paths (the organisation’s learning paths)
| Operation | What it does | Fields |
|---|---|---|
List Organization Paths | Returns the company’s paths, with how many people have them assigned, how many have completed them and how many are at risk. | |
Add Path | Adds a path to the organisation’s catalogue. | Path ID |
Remove Path | Removes a path from the organisation. It only works if nobody is enrolled. | Path ID |
Assign Path | Enrolls several members of the organisation in a path. | Path ID, Member IDs |
Member IDs takes member IDs or member emails, separated by commas. People who aren’t members of the organisation are skipped and listed in the result’s not_members value. If none of them is, the operation fails.
Analytics (training analytics)
| Operation | What it does | Fields |
|---|---|---|
Organization Stats | The organisation’s totals: members, active, at risk, average score and progress. | |
Leaderboard | The people with the best score, with their trend. | Top: how many people (default 10). |
Skills Gap | The current level against the target level in each skill dimension. | |
Generate Report | A report of the organisation’s training for a period. | Report and Period |
- Report can be
executive-summary,skills-gap,individual-progress,team-evolution,certificatesorhr(Human Resources). - Period can be
30d(default),7d,quarterlyoryearly. - Every report except
certificatesincludes an AI-made analysis and can take up to 2 minutes.
Output
The Data output returns AcademIA’s answer as data: one item per member, invitation or path for the operations that list, and the item you worked with for the others.
The component supports Batch Mode and it can be connected to an Agent as a tool. See Tools.
Example
A company wants to encourage, every Monday, those who have fallen behind in their training.
- Create a weekly schedule for the flow in the Scheduler.
- Add AcademIA Organization with the
Membersresource, theList Membersoperation andriskin Filter. Leave Organization ID empty. - Connect Data to another AcademIA Organization with the
Remind Memberoperation, turn on Batch Mode and, in Member ID, take each member’sidvalue. - If you want, add an email at the end to the training manager with the list of people reminded.
Good practices
- Leave Organization ID empty when the key is a Corporate admin key. Don’t type a made-up value.
- For the monthly report, use
Generate Reportwith Reporthrand Period30d, and connect the result to an email or a spreadsheet. - If you want to invite someone to a single path without making them a member of the company, use AcademIA Enrollment.
Security and limitations
- For safety, the component only allows the two corporate roles (
CORPORATE_USERandCORPORATE_ADMIN) when changing a role or inviting, and it only enrolls in a path people who are already members. Platform roles can’t be given from here. Remind MemberandSkills Gapneed AcademIA’s BUSINESS plan or higher. The same member can only receive one reminder every 24 hours.Invite Membersfails if the seats of the organisation’s plan are exceeded.- A Corporate admin key only sees its own organisation. If you enter the Organization ID of another one, AcademIA rejects the operation.
Related components
- AcademIA Enrollment: path invitations and program enrollments.
- AcademIA Users: platform accounts (for a Super admin).
- AcademIA Webhook: starts the flow with what happens in AcademIA.