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

To create a learning module, the administrator can use the POST /learning/modules  endpoint.

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

To publish a learning module, the administrator can use the POST /api/v2/learning/modules/{moduleId}/publish endpoint.

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

To assign a learning module, the administrator can use the POST /api/v2/learning/assignments endpoint.

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

To update the assignment, the external system must send the results of the learning resource to Genesys Cloud via the PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments endpoint. 

Instrucciones

This PATCH /api/v2/learning/modules/{moduleId}/users/{userId}/assignments endpoint is gated behind the learning:externalAssignment:edit permission that is not assigned to any roles by default. The endpoint always updates the latest assignment for that user and the learning module.

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.