Mejores prácticas del módulo de aprendizaje externo
Este artículo enumera las mejores prácticas para hacer que su middleware interactúe con las APIs de Genesys.
Genesys Cloud puede sincronizar los sistemas externos de la plataforma Genesys Cloud con los módulos de aprendizaje de Genesys.
Descripción
Para crear un módulo de aprendizaje, el administrador puede utilizar el punto final POST /learning/modules
.
Instrucciones
El módulo externo debe ser una única URL que apunte al recurso de aprendizaje externo.
Ejemplo:
{
"Nombre": "Objetivos SMART",
"descripción": "Esta formación externa te enseña a crear objetivos SMART",
"completionTimeInDays": 14,
"informSteps": [
{
"tipo": "Url",
"Nombre": "Objetivos SMART",
"orden": 1,
"valor": "https://myLms.com/courses/1234"
}
],
"excluidoDeCatálogo": true,
"externalId": "1234",
"tipo": "Exterior"
}
Descripción
Para publicar un módulo de aprendizaje, el administrador puede utilizar el punto final POST /api/v2/learning/modules/{moduleId}/publish
.
Instrucciones
Si edita un módulo de aprendizaje después de publicarlo, deberá volver a publicarlo para que la versión actualizada del módulo se asigne a los usuarios. Puede ocultar los módulos del catálogo para evitar que aparezcan en la lista de módulos cuando el supervisor asigne los módulos de aprendizaje a través de las páginas de Desarrollo del espacio de trabajo.
Descripción
Para asignar un módulo de aprendizaje, el administrador puede utilizar el punto final POST /api/v2/learning/assignments
.
Instrucciones
Puede asignar una versión específica de un módulo de aprendizaje a un usuario. La versión del módulo de aprendizaje sólo se determina cuando el usuario inicia la tarea. Si un usuario no ha iniciado una asignación y se publica una versión más reciente del módulo, se le asignará automáticamente la última versión del módulo de aprendizaje.
Ejemplo:
{
"moduleId": “2169a726-31e1-4d69-b161-1b62ccb1c99e”,
"userId": “1e39d64f-68ff-41cc-8a2e-781cbce08409”,
"recommendedCompletionDate": “2024-02-01T15:00:00Z”,
"lengthInMinutes": "60"
}
Descripción
Puede iniciar el módulo de aprendizaje desde Genesys Cloud. Durante el lanzamiento de la tarea, se presenta una pantalla de portada con la descripción del módulo y la carátula.
Instrucciones
Cuando haga clic para iniciar la tarea, se le redirigirá a la URL del paso del módulo que apunta al recurso de aprendizaje externo.
Descripción
Para actualizar la asignación, el sistema externo debe enviar los resultados del recurso de aprendizaje a Genesys Cloud a través del endpoint PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
.
Instrucciones
Este endpoint PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments
está bloqueado tras el permiso learning:externalAssignment:edit que no está asignado a ningún rol por defecto. El punto final siempre actualiza la última asignación para ese usuario y el módulo de aprendizaje.
Ejemplo:
{
"estado": "Completado",
"percentageScore": 85,
"isPassed": true
}