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.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial AcademIA. Rellena por ti AcademIA API address y AcademIA API key. |
| Resource | Siempre Certificates. |
| Operation | Lo que haces con los certificados. Ver Recursos y operaciones. |
Recursos y operaciones
Certificates (certificados)
| Operación | Qué hace | Campos |
|---|---|---|
Verify Certificate | Comprueba si un certificado es válido. Si lo es, devuelve la persona, el curso, la nota y las fechas. | Certificate |
List Certificates | Trae 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 Certificates | Trae 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 eventoCertificate Issuedde AcademIA Webhook trae ese código encertificate_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 datovalid(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, conid,tipo,usuario,email,score,hash,emitido,expira,linkedinyorganizacion) y, si no has usado Search,csvcon 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.
- Un agente lee el correo del candidato y extrae el enlace de verificación del certificado.
- Añade AcademIA Certificates con la operación
Verify Certificatey, en Certificate, el enlace extraído. - 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 Certificatesy conectarowsa 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
- AcademIA Webhook: pone en marcha el flujo cuando se emite un certificado.
- AcademIA Organization: informes de la organización, incluido el de certificados.