Saltearse al contenido

AcademIA Certificates

AcademIA Certificates trabaja con los certificados que emite AcademIA cuando alguien completa una ruta de aprendizaje. Puedes comprobar si un certificado es auténtico, sacar el listado de los emitidos o exportarlos todos como filas para llevarlos a otra herramienta.

Cuándo usarlo

  • Un candidato te envía un certificado de AcademIA y quieres comprobar que es auténtico.
  • Cuando AcademIA emite un certificado, quieres verificarlo y enviar el diploma a la persona o a su responsable.
  • Recursos Humanos necesita el listado de certificados de la empresa en una hoja de cálculo o en su sistema.
  • Un asistente debe responder qué cursos ha completado una persona.

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 listar y exportar, la clave de la credencial debe actuar como Super admin (SUPER_ADMIN) o Admin de contenido (CONTENT_ADMIN). La comprobación de un certificado por su identificador funciona con cualquier rol.

CampoQué hace
Credential (obligatorio)La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key.
ResourceSiempre Certificates.
OperationLo que haces con los certificados. Ver Recursos y operaciones.

Recursos y operaciones

Certificates (certificados)

OperaciónQué haceCampos
Verify CertificateComprueba si un certificado es válido. Si lo es, devuelve la persona, el curso, la nota y las fechas.Certificate
List CertificatesTrae los certificados emitidos, con la persona, el curso, la nota y las fechas.Opcionales: Search y Limit (por defecto 200, como mucho 1.000).
Export CertificatesTrae todos los certificados como filas, listas para una hoja de cálculo.Opcional: Search.
  • Certificate admite el identificador del certificado, su código de verificación o el enlace de verificación completo (el que termina en /verify/<código>). El evento Certificate Issued de AcademIA Webhook trae ese código en certificate_hash.
  • Search es un texto que debe aparecer en la persona, el correo, el curso o la organización, por ejemplo un dominio de correo o el nombre de una empresa.

Resultado

La salida Data devuelve, según la operación:

  • Verify Certificate: el dato valid (si es válido) y, cuando lo es, los datos del certificado.
  • List Certificates: un elemento por certificado.
  • Export Certificates: count (cuántas filas), rows (las filas, con id, tipo, usuario, email, score, hash, emitido, expira, linkedin y organizacion) y, si no has usado Search, csv con el fichero completo en texto.

El componente admite Batch Mode y se puede conectar a un Agente como herramienta. Ver Herramientas.

Ejemplo

Un departamento de selección quiere comprobar los certificados que adjuntan los candidatos.

  1. Un agente lee el correo del candidato y extrae el enlace de verificación del certificado.
  2. Añade AcademIA Certificates con la operación Verify Certificate y, en Certificate, el enlace extraído.
  3. Conecta Data a un componente que responda al candidato o anote en la ficha si el certificado es válido, con el curso y la fecha.

Buenas prácticas

  • Search filtra entre los certificados leídos. Si tienes muchos y no encuentras uno, sube Limit.
  • Para llevar los certificados a una hoja de cálculo, usa Export Certificates y conecta rows a un componente de hoja de cálculo.

Seguridad y limitaciones

  • La comprobación pública de AcademIA solo reconoce el identificador del certificado. Para comprobar por el código de verificación o por el enlace, la clave de la credencial tiene que actuar como Super admin o Admin de contenido; con otro rol, un certificado auténtico puede salir como no válido.

Componentes relacionados