Guías paso a paso · Centro de Ayuda
Conecta tu LMS, la API y los webhooks
Para dejar de emitir a mano: que la credencial salga sola cuando alguien termina un curso.
Elige el camino que te toca
- Usas Moodle: el plugin oficial es el camino corto.
- Usas Canvas, Blackboard, Brightspace o Sakai: LTI 1.3.
- Tienes un sistema propio: la API REST.
- Quieres que tu sistema se entere de lo que pasa aquí: webhooks.
Moodle
A partir de ahí, cuando un alumno cumple los criterios de finalización, la credencial se emite y se envía sola. Cada emisión consume cupo igual que si la hubieras hecho a mano.
- Descarga el plugin desde Integraciones e instálalo en tu Moodle.
- Genera un token de API en el panel y pégalo en la configuración del plugin.
- En cada curso, elige qué insignia se emite al completarlo.
LTI 1.3
En Integraciones encuentras los cuatro datos que pide cualquier plataforma LTI: el Issuer, el Client ID, la URL de inicio y la de redirección, más el JWKS. Se configuran una vez del lado de tu LMS.
La API
Dos endpoints cubren lo esencial. Ambos autentican con un token secreto que generas en el panel y que solo se muestra una vez.
- GET /api/v1/estado — devuelve tu plan, tus credenciales disponibles y cuándo se renueva tu ciclo.
- POST /api/v1/emitir — recibe la insignia, el nombre y el correo, y devuelve la credencial firmada.
Ojo: Consulta el estado antes de una carga grande. Si vas a emitir 500 y te quedan 80, es mejor enterarte por la API que a la mitad del proceso.
Webhooks
Desde el plan Institución puedes recibir un aviso en tu sistema cada vez que pasa algo relevante: cuando una credencial se emite, se reclama, se revoca o se restaura.
- Registra tu URL en Integraciones.
- Guarda el secreto que te damos: cada envío va firmado con él.
- Comprueba la firma antes de confiar en el contenido. Es la diferencia entre un webhook y un formulario abierto al mundo.
Sub-emisores
Si tu institución tiene facultades, sedes o escuelas que quieren emitir con identidad propia, los sub-emisores hacen justo eso bajo tu paraguas: 3 en Institución, 25 en Red, ilimitados en Enterprise.