Skip to content

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.

FieldWhat it does
Credential (required)The AcademIA credential. It fills in AcademIA API address and AcademIA API key for you.
ResourceAlways Certificates.
OperationWhat you do with the certificates. See Resources and operations.

Resources and operations

Certificates

OperationWhat it doesFields
Verify CertificateChecks whether a certificate is valid. If it is, it returns the person, the course, the score and the dates.Certificate
List CertificatesReturns the certificates issued, with the person, the course, the score and the dates.Optional: Search and Limit (default 200, at most 1,000).
Export CertificatesReturns 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>). The Certificate Issued event of AcademIA Webhook carries that code in certificate_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: the valid value (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, with id, tipo, usuario, email, score, hash, emitido, expira, linkedin and organizacion) and, if you didn’t use Search, csv with 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.

  1. An agent reads the candidate’s email and extracts the certificate’s verification link.
  2. Add AcademIA Certificates with the Verify Certificate operation and, in Certificate, the extracted link.
  3. 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 Certificates and connect rows to 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.