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"

}

Nota: La recommendedCompletionDate y la lengthInMinutes son valores opcionales. Si no proporciona la fecha recomendada de finalización (recommendedCompletionDate) y la duración en minutos (lengthInMinutes), sus valores se basarán en los valores del módulo.

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 punto final PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments

Instrucciones

Este PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments endpoint está bloqueado detrás del learning:externalAssignment:edit permiso 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
}

Nota: Si tiene preguntas sobre cómo crear su middleware, Genesys le recomienda que se ponga en contacto con su socio o con Atención al Cliente.