Meilleures pratiques en matière de modules d'apprentissage externes

Cet article liste les meilleures pratiques pour faire interagir votre middleware avec les API de Genesys.

Genesys Cloud peut synchroniser les systèmes externes à la plateforme Genesys Cloud avec les modules d'apprentissage Genesys.

Description

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

Instruction

Le module externe doit être une URL unique qui pointe vers la ressource d'apprentissage externe.

Exemple: 

{
"nom" : "Objectifs SMART",
"description" : "Cette formation externe vous explique comment créer des objectifs SMART,
"completionTimeInDays" : 14,
"informSteps" : [
{
"type" : "Url",
"nom" : "Objectifs SMART",
"ordre" : 1,
"valeur" : "https://myLms.com/courses/1234"
}
],
"excludedFromCatalog" : vrai,
"externalId" : "1234",
"type" : "Externe"
}

Description

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

Instruction

Si vous modifiez un module de formation après l'avoir publié, vous devez republier le module pour que la version mise à jour du module soit attribuée aux utilisateurs. Vous pouvez masquer les modules du catalogue pour éviter qu'ils n'apparaissent dans la liste des modules lorsque le superviseur assigne les modules d'apprentissage via les pages de développement de l'espace de travail.

Description

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

Instruction

Vous pouvez attribuer une version spécifique d'un module de formation à un utilisateur. La version du module d'apprentissage n'est déterminée que lorsque l'utilisateur commence le travail. Si un utilisateur n'a pas commencé une affectation et qu'une version plus récente du module est publiée, la dernière version du module de formation est automatiquement attribuée à l'utilisateur.

Exemple: 

{
"moduleId" : “2169a726-31e1-4d69-b161-1b62ccb1c99e”,
"userId" : “1e39d64f-68ff-41cc-8a2e-781cbce08409”,
"recommendedCompletionDate" : “2024-02-01T15:00:00Z”,
"lengthInMinutes" : « 60»

}

Remarque :  La date d'achèvement recommandée (recommendedCompletionDate) et la durée en minutes (lengthInMinutes) sont des options facultatives. Si vous ne fournissez pas la date d'achèvement recommandée et la durée en minutes, leurs valeurs sont basées sur les valeurs du module.

Description

Vous pouvez lancer le module de formation à partir de Genesys Cloud. Lors du lancement de l'affectation, un écran de couverture contenant la description du module et la pochette est présenté. 

Instruction

Lorsque vous cliquez pour commencer le travail, vous êtes redirigé vers l'URL de l'étape du module qui pointe vers la ressource d'apprentissage externe.

Description

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. 

Instruction

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.

Exemple: 

{
"état" : "Complété",
"percentageScore" : 85,
"isPassed" : true
}

Remarque :  Si vous avez des questions sur la façon de créer votre middleware, Genesys vous recommande de contacter votre partenaire ou le service clientèle.