AcademIA Certificates
AcademIA Certificates works with the certificates AcademIA issues when someone completes a learning path. You can check whether a certificate is genuine, get the list of those issued, or export them all as rows to take them to another tool.
When to use it
- A candidate sends you an AcademIA certificate and you want to check that it is genuine.
- When AcademIA issues a certificate, you want to verify it and send the diploma to the person or their manager.
- Human Resources needs the list of the company’s certificates in a spreadsheet or in its system.
- An assistant must answer which courses a person has completed.
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.
To list and export, the credential’s key must act as a Super admin (SUPER_ADMIN) or a Content admin (CONTENT_ADMIN). Checking a certificate by its ID works with any role.
| Field | What it does |
|---|---|
| Credential (required) | The AcademIA credential. It fills in AcademIA API address and AcademIA API key for you. |
| Resource | Always Certificates. |
| Operation | What you do with the certificates. See Resources and operations. |
Resources and operations
Certificates
| Operation | What it does | Fields |
|---|---|---|
Verify Certificate | Checks whether a certificate is valid. If it is, it returns the person, the course, the score and the dates. | Certificate |
List Certificates | Returns the certificates issued, with the person, the course, the score and the dates. | Optional: Search and Limit (default 200, at most 1,000). |
Export Certificates | Returns every certificate as rows, ready for a spreadsheet. | Optional: Search. |
- Certificate takes the certificate’s ID, its verification code or the full verification link (the one ending in
/verify/<code>). TheCertificate Issuedevent of AcademIA Webhook carries that code incertificate_hash. - Search is a text that must appear in the person, the email, the course or the organisation, for example an email domain or a company name.
Output
The Data output returns, depending on the operation:
Verify Certificate: thevalidvalue (whether it is valid) and, when it is, the certificate’s details.List Certificates: one item per certificate.Export Certificates:count(how many rows),rows(the rows, withid,tipo,usuario,email,score,hash,emitido,expira,linkedinandorganizacion) and, if you didn’t use Search,csvwith the whole file as text.
The component supports Batch Mode and it can be connected to an Agent as a tool. See Tools.
Example
A recruitment team wants to check the certificates candidates attach.
- An agent reads the candidate’s email and extracts the certificate’s verification link.
- Add AcademIA Certificates with the
Verify Certificateoperation and, in Certificate, the extracted link. - Connect Data to a component that replies to the candidate or notes in their record whether the certificate is valid, with the course and the date.
Good practices
- Search filters among the certificates read. If you have many and can’t find one, raise Limit.
- To take the certificates to a spreadsheet, use
Export Certificatesand connectrowsto a spreadsheet component.
Security and limitations
- AcademIA’s public check only recognises the certificate’s ID. To check by the verification code or by the link, the credential’s key must act as a Super admin or a Content admin; with another role, a genuine certificate may come out as not valid.
Related components
- AcademIA Webhook: starts the flow when a certificate is issued.
- AcademIA Organization: the organisation’s reports, including the certificates one.