Saltar al contenido principal

Integrar POK con Moodle mediante LTI

Para integrar POK Proof of Knowledge con Moodle mediante LTI, registra la integración en tu panel de POK, configura una herramienta externa en Moodle y luego agrega una actividad de credencial a tus cursos. Una vez conectado, POK puede emitir credenciales a tus estudiantes de forma automática, por ejemplo cuando aprueban una evaluación. Los pasos exactos en Moodle dependen de tu versión: 3.9 o anterior, o 3.10 y posteriores.

Esta guía cubre la integración por URL LTI. POK también ofrece una integración basada en API a través del plugin de POK para Moodle.

Iniciar la integración desde POK​

  1. Ingresa a la sección Integraciones dentro de tu panel de POK.
  2. En el listado de plataformas disponibles, selecciona Moodle.
  3. Asigna un nombre que identifique la integración (por ejemplo, "Moodle Licenciatura 2025").
  4. Selecciona el tipo de integración. Para esta guía, elige Integración por URL LTI.
  5. En la siguiente pantalla, indica la versión de Moodle que usas, ya que los pasos varían según la versión:
    • Tengo Moodle 3.9 o una versión anterior
    • Tengo Moodle 3.10 o una versión más reciente
tip

¿No sabes qué versión tienes? Consulta cómo verificar tu versión de Moodle.

Si tienes Moodle 3.9 o una versión anterior​

Para esta versión, POK te pide tres valores de Moodle: el Platform ID, el Client ID y un Web Service Token. Las secciones siguientes muestran dónde obtener cada uno.

Obtener el Platform ID y el Client ID​

  1. En Moodle, ve a Site administration > Plugins > Activity modules > Manage tools.

  2. Haz clic en Configure a tool manually.

  3. Completa el formulario con los siguientes valores:

    • Tool name: un nombre que identifique la herramienta.
    • Tool URL: https://lti.pok.tech/lti/launch
    • LTI version: 1.3
    • Public key type: Keyset URL
    • Public keyset: https://lti.pok.tech/.well-known/lti-jwks.json
    • Initiate login URL: https://lti.pok.tech/lti/login
    • Redirection URI(s): https://lti.pok.tech/lti/launch
    • Custom parameters:
    course_id=$Context.id
    person_timezone=$Person.address.timezone
    course_section_label=$CourseSection.label
    person_locality=$Person.address.locality
    user_name=$User.username
    person_full_name=$Person.name.full
    course_title=$Context.title
    person_family_name=$Person.name.family
    course_offering_label=$CourseOffering.label
    person_postal_code=$Person.address.postcode
    course_offering_title=$CourseOffering.title
    person_state_region=$Person.address.statepr
    person_name_prefix=$Person.name.prefix
    person_given_name=$Person.name.given
    course_label=$Context.label
    user_timezone=$Person.address.timezone
    person_middle_name=$Person.name.middle
    course_section_title=$CourseSection.title
    person_country=$Person.address.country
    user_id=$User.id
    source_course_id=$Course.id
    person_name_suffix=$Person.name.suffix

  4. Haz clic en Save changes.

  5. En el listado de herramientas creadas, haz clic en el menú de 3 puntos y luego en Tool configuration details.

  6. Copia el Platform ID y el Client ID que se muestran allí.

Generar el Web Service Token​

Para obtener el token, primero habilita los web services en Moodle:

  1. Ve a Site administration > Advanced features y marca Enable web services.
  2. Ve a Site administration > Plugins > Web services > Manage protocols y verifica que el protocolo REST esté habilitado (el ícono del ojo está visible).
  3. Ve a Web services > External services y crea un nuevo servicio:
    • Asígnale un nombre (por ejemplo, "POK External Service").
    • Marca Enable.
    • Haz clic en Add service.
  4. Haz clic en Add functions y agrega estas dos funciones:
    • core_course_get_contents
    • gradereport_user_get_grade_items
  5. Guarda las funciones.
  6. Ve a Web services > Manage tokens y haz clic en Add:
    • Selecciona un usuario administrador.
    • Elige el servicio que acabas de crear.
    • Haz clic en Save changes y copia el token generado.

Completar la integración en POK​

  1. Vuelve a POK.
  2. Pega el Platform ID, el Client ID y el Web Service Token.
  3. Haz clic en Confirmar para finalizar la instalación.

Si tienes Moodle 3.10 o una versión más reciente​

Para esta versión, POK te pide:

  • URL del sitio Moodle (por ejemplo, https://midominio.moodle.edu)
  • Web Service Token: genéralo siguiendo los pasos de Generar el Web Service Token.

Luego:

  1. Completa ambos campos en POK.
  2. Haz clic en Confirmar para avanzar a la siguiente pantalla.
  3. Copia la URL dinámica de LTI que muestra POK.

Agregar la herramienta LTI dinámica en Moodle​

  1. Ve a Site administration > Plugins > External tool > Manage tools.
  2. Pega la Tool URL que copiaste desde POK.
  3. Haz clic en Add LTI Advantage para completar el registro.

Si Moodle muestra Integration process failed (POST_REGISTRATION_ERROR) en este paso, consulta cómo solucionar el error POST_REGISTRATION_ERROR.

Listo. Ya puedes usar la integración con Moodle para emitir credenciales automáticas desde tus cursos.

Configurar la actividad POK Credential en un curso​

Una vez completada la integración, agrega la actividad POK Credential a tus cursos de Moodle para emitir credenciales a los estudiantes de forma automática o manual.

Agregar la actividad de herramienta externa​

  1. Desde tu cuenta de administrador, ve a Administración del sitio > Cursos > Gestionar cursos y categorías.
  2. Selecciona el curso y haz clic en View para editar su contenido.
  3. En la barra superior derecha, activa el modo de edición.
  4. Haz clic en Agregar una actividad o recurso.
  5. Selecciona la actividad External tool.
  6. En el campo Activity name, escribe un nombre que identifique la actividad.
  7. En Preconfigured tool, selecciona la herramienta de POK que configuraste durante la integración.
  8. En Launch container, te recomendamos seleccionar New window para una mejor experiencia visual.
  9. Haz clic en Save and return to course.

Configurar la emisión de la credencial​

Una vez guardada la actividad, haz clic sobre ella para abrir la configuración LTI y completa el formulario:

  • Selecciona el diseño de la credencial.
  • Vincula una página personalizada y una ruta de aprendizaje (opcional).
  • Define si la credencial tendrá fecha de expiración.
  • Mapea los atributos personalizados del diseño con los datos disponibles del estudiante.
  • Elige el tipo de credencial: básica o blockchain.
  • Define el idioma del correo que recibirá el estudiante.

Opción A: emitir automáticamente según una evaluación​

Si quieres que la credencial se emita automáticamente cuando el estudiante apruebe una evaluación:

  1. Selecciona la evaluación del curso que servirá como base.
  2. Ingresa la nota mínima que el estudiante debe alcanzar para activar la emisión.
  3. Elige la fecha de emisión: las credenciales se generan en esa fecha para todos los estudiantes que cumplan el requisito.

Opción B: sin condiciones de emisión​

Si prefieres no establecer requisitos previos, omite la opción A. En este caso, los estudiantes pueden abrir el ítem de la credencial dentro del curso y generarla manualmente.

Guardar la configuración​

  1. Haz clic en Save Credential Configuration.
  2. Revisa la vista previa que aparece con los datos cargados.
  3. Haz clic en Save para aplicar los cambios.

Tu credencial POK queda configurada y lista para emitirse automáticamente o bajo demanda, según lo que hayas seleccionado.

Ver el listado de credenciales​

Después de configurar una credencial en un curso de Moodle, puedes revisar su estado, enviarla manualmente a los estudiantes que cumplan los criterios y editar su configuración si lo necesitas.

Para abrir el listado, haz clic sobre el ítem de la credencial dentro del módulo del curso. Allí se muestra el estado de cada estudiante y desde ese lugar puedes ver y gestionar la emisión.

Qué significa cada estado​

  • Pendiente: la credencial aún no se generó ni se envió al estudiante.
  • Enviado: la credencial se generó y el estudiante recibió un correo con el enlace para aceptarla.
  • Aceptado: el estudiante aceptó la credencial desde el correo y ya fue emitida correctamente.

Enviar credenciales manualmente​

Puedes enviar credenciales en cualquier momento a los estudiantes que cumplan los criterios definidos:

  1. Haz clic en el botón Enviar.
  2. Las credenciales se envían solo a los estudiantes con estado Pendiente.
  3. Los estudiantes que ya están en estado Enviado o Aceptado no vuelven a recibir la credencial.

Editar una credencial​

Para modificar una credencial ya configurada, haz clic en Configurar emisión. Puedes actualizar:

  • Los datos visibles en la credencial.
  • Las condiciones de autoemisión (nota mínima, fecha de emisión, etc.).

Si tienes alguna duda, escríbenos a contact@pok.tech

Más información​

Para conocer cómo las integraciones LTI de POK se conectan con tu LMS y otros sistemas, visita la página de la funcionalidad de integraciones con LMS y CRM.