Pourquoi le bloc Requête Web VTS change vos modules e‑learning

Pour un responsable formation, un concepteur pédagogique ou un responsable RH, deux enjeux reviennent souvent en digital learning : la fiabilité des données (suivi, conformité, pilotage) et l’adaptation des parcours (profils, droits, objectifs). Le bloc Requête Web VTS relie vos expériences à vos systèmes clés — LMS/LRS, SIRH, CRM, outils BI ou plateformes internes — et fait circuler l’information en temps réel : scores, progression, résultats de quiz, traces xAPI, déblocage de parcours, preuves d’apprentissage. Avec VTS Editor, vous créez des modules connectés, dynamiques et mesurables, sans compétences techniques.

Concrètement, ce connecteur API exécute des appels HTTP vers vos services : vous indiquez l’URL, les en-têtes d’authentification, la méthode (GET/POST/POST Raw), le délai maximum et si le scénario attend la réponse. La réponse est stockée dans une variable VTS Editor pour piloter votre graphe avec des Conditions, mettre à jour Score/Progression, déclencher des Badges ou afficher des Messages ciblés.

Dans cet article, vous allez apprendre à configurer pas à pas le bloc, à l’appliquer à cinq cas d’usage concrets, puis à sécuriser et fiabiliser vos intégrations grâce à des bonnes pratiques simples.

Configurer le bloc Requête Web VTS pas à pas

Définir l’endpoint et l’authentification

Commencez par l’URL de votre service : par exemple https://api.votre-domaine.com/v1/events ou https://.../users/{userId}/score. Les variables entre accolades sont remplacées à l’exécution par leurs valeurs VTS (userId, sessionId, langue, score…). Côté sécurité, la plupart des APIs demandent des en-têtes :

• Authorization: Bearer {token} (OAuth2/JWT)
• x-api-key: {apiKey} (clé d’API dédiée)
• Content-Type: application/json lorsque vous envoyez du JSON (POST Raw)
• En-têtes maison : locale, version, correlation-id (pour vos logs), etc.

Bon réflexe : stockez vos secrets (token, apiKey) dans des variables initialisées au début du module via une requête d’authentification plutôt que de les écrire en dur. Vous limitez les risques et facilitez la rotation des clés.

Choisir la bonne méthode d’envoi

• GET pour lire des données (profil, droits, contenu, configuration). Les paramètres passent dans l’URL : ?userId={userId}&lang={lang}.
• POST avec paramètres clé=valeur pour des envois simples (score, statut, durée) quand l’endpoint attend du form‑encoded.
• POST Raw pour envoyer un contenu structuré en JSON ou XML. Exemple JSON : {"userId":"{userId}","score":{score},"status":"completed","timestamp":"{isoNow}"}. Comme VTS Editor injecte des variables avec des { }, définissez des délimiteurs personnalisés si votre contenu contient beaucoup de caractères spéciaux pour éviter les collisions.

Insérer des variables et stocker la réponse

Vous pouvez insérer des variables partout : dans l’URL, les en-têtes, les paramètres ou le corps. Dans la configuration du bloc de requête HTTP VTS, choisissez une variable cible (par ex. result) pour stocker la réponse brute. Le scénario peut ensuite exploiter result dans des blocs Conditions, Message, Score, Progression, etc., et adapter le parcours instantanément.

Contrôler le flux : attente, délai et sorties

Le bloc propose deux sorties : succès (réponse reçue) et erreur (échec/délai dépassé). En activant « Attendre la fin de la requête », le graphe marque une pause jusqu’à la réponse ; en le désactivant, l’expérience continue pendant l’appel (asynchrone). Définissez un délai réaliste (5 à 10 s) pour ne pas bloquer inutilement l’apprenant. Prévoyez toujours une voie de repli : message pédagogique, bouton « Réessayer » (avec Compteur + Attendre), voire un mode hors ligne (ressources locales).

Lire et exploiter la réponse

• JSON : fromJson(result) transforme la réponse texte en dictionnaires/listes. Accédez ensuite à fromJson(result).data.score ou fromJson(result).status. Avant d’utiliser une clé, vérifiez qu’elle existe (via Conditions).
• Expressions régulières : regexMatch(result, "pattern") pour valider un format ; extractText(result, "pattern", 1) pour extraire une valeur d’une réponse non‑JSON.
• Numérique : toInteger(result) si l’API renvoie un nombre en clair, ou toInteger(extractText(...)) pour convertir une chaîne en entier.

Un gabarit de graphe robuste

Un schéma éprouvé consiste à enchaîner Requête Web → Conditions → Feedback/Actions :

• Sur succès : vérifiez la présence des champs attendus ; mettez à jour Score/Progression/Badges ; affichez un message de confirmation.
• Sur erreur : informez l’apprenant (« connexion instable » vs « service indisponible »), proposez un bouton « Réessayer » avec un Compteur pour limiter les tentatives, et prévoyez un parcours alternatif (Ressources locales, accès partiel).
• Option desktop : consignez une trace avec le bloc Récap (code d’erreur, horodatage) pour faciliter le support.

Astuce : regroupez votre « mini‑chaîne » d’appels (auth, envoi, lecture) dans un Groupe passé en mode Fonction, puis invoquez‑le avec Appel de Fonction depuis différentes scènes. Vous gagnez en lisibilité et en maintenance.

Cas d’usage à fort impact avec le bloc Requête Web VTS

Envoyer scores et progression vers votre LMS/LRS ou un service métier

Objectif : centraliser le suivi, déclencher des règles RH et nourrir la BI. À la fin d’un quiz ou d’une scène clé, envoyez un POST Raw JSON avec userId, scenarioId, score global, scores par compétence, statut (passed/failed), temps et horodatage ISO. En cas de succès, utilisez Progression (complété + réussi), attribuez un Badge et, si besoin, débloquez un contenu premium via Vérifier Score. En cas d’erreur, affichez un message et proposez un nouvel essai. Pour le déploiement et l’analytique, découvrez VTS Perform.

Récupérer du contenu à jour en temps réel

Objectif : maintenir vos contenus sans republier. Un GET du type /procedures?context={metier}&lang={lang} renvoie un JSON avec titres et étapes. Parsez‑le via fromJson(result) pour remplir des listes, puis injectez ces contenus dans un Message, un Diaporama ou des Zones cliquables. Idéal pour les procédures qui changent souvent (sécurité, conformité, offres) : vous réduisez le temps de mise à jour. Pour vos modules, voyez nos formats de modules e‑learning gamifiés.

Inscription, émargement et preuves d’apprentissage légères

Objectif : tracer simplement l’engagement. Configurez un webhook (Google Apps Script, Make, Zapier) et envoyez un POST avec nom, e‑mail, heure d’entrée/sortie, score, IP si votre DPO l’autorise. La réponse peut contenir un identifiant d’enregistrement : affichez‑le et, si vous générez un certificat, ouvrez le lien avec Ouvrir page web. Pour démarrer rapidement, demandez une démonstration de VTS Editor.

Déblocage conditionnel par vérification côté serveur

Objectif : contrôler l’accès à des parcours sensibles ou premium. L’apprenant saisit un code via un Pavé numérique ; vous validez côté serveur via le bloc Web Request VTS. En cas de succès : Flag acces_premium = Vrai, un Menu propose des chapitres bonus. En cas d’échec : message clair, incrément d’un Compteur de tentatives et chemin de remédiation. Ce cas d’usage aide à la monétisation, aux prérequis réglementaires ou aux accès restreints (ex. managers).

Classements et tirages centralisés pour créer du challenge

Objectif : stimuler l’émulation entre apprenants et garder une cohérence de tirage. Lisez une seed centrale pour alimenter l’aléatoire de vos variables et rendre des énigmes comparables. En fin de parcours, postez les scores, puis récupérez un leaderboard à afficher. Ce schéma fonctionne très bien pour challenges commerciaux, journées sécurité ou événements internes. Inspirez‑vous de nos cas clients pour trouver des idées.

Bonnes pratiques de sécurité et de performance pour le bloc Requête Web VTS

Sécuriser vos appels

• Toujours en HTTPS ; bannissez HTTP.
• N’exposez pas de secrets dans le module. Mieux : passez par un service intermédiaire (middleware) qui authentifie l’utilisateur (JWT, OAuth2), signe les requêtes vers vos services internes et filtre les données.
• Minimisez les données personnelles transmises (RGPD). Quand c’est possible, utilisez un identifiant anonyme (userHash) plutôt qu’un e‑mail nominatif.
• Gérez la rotation des clés/tokens et l’expiration des sessions.
• Documentez finalité, base légale et durée de conservation dans votre registre RGPD ; informez l’apprenant si des données partent vers un service externe. Voir notre politique de confidentialité.

Fiabiliser l’expérience

• Délai raisonnable (5–10 s) et sortie « erreur » toujours branchée.
• Politique de nouvel essai avec temporisation (ex. 1 s puis 5 s) et limite de tentatives via Compteur.
• Messages utiles : distinguez les erreurs réseau (« connexion instable, réessayez ») des indisponibilités serveur (« service momentanément indisponible »).
• Mode alternatif : activez Modifier Ressources pour afficher un PDF ou une procédure locale ; signalez‑le avec un Message.

Optimiser les performances

• Envoyez/recevez uniquement l’essentiel ; côté lecture, utilisez la pagination (page, limit).
• Mettez en cache en variables les réponses « stables » pendant la session (FAQ, listes de codes) pour éviter les appels rapprochés.
• Groupez les envois : postez en fin de section plutôt qu’après chaque micro‑action.
• Évitez d’appeler le connecteur API de VTS Editor dans des boucles ou sur des entrées de scène multiples ; centralisez au début/à la fin d’une séquence.

Respecter les contraintes du SI

• Si votre réseau impose un proxy/pare‑feu, alignez‑vous avec l’IT (liste blanche des domaines Serious Factory, configuration du proxy). Testez en environnement de recette avant la production.
• Sur iOS/Android/Web, anticipez les limites réseau et testez le comportement de vos délais.

Tester et diagnostiquer vite

• Prévisualisez (F5) et ouvrez la fenêtre État des variables : vous y verrez la réponse brute (result) et vos variables de parsing en temps réel.
• Validez vos JSON en amont. Dans le module, sécurisez l’accès aux champs après fromJson en vérifiant leur présence via Conditions.
• Pour une réponse non‑JSON, partez d’un échantillon et stabilisez vos motifs d’expressions régulières (regexMatch/extractText) avant généralisation.
• En desktop, utilisez le bloc Récap pour consigner les étapes et erreurs (code, message, horodatage) et accélérer le support.

Passez à l’action : connectez VTS Editor à vos APIs

Le bloc Requête Web VTS ouvre vos modules aux données réelles de l’entreprise. Associé aux blocs Score/Progression, Flags/Conditions, Badge, Message ou Menu, il permet de bâtir des expériences adaptatives, auditées et pilotées par vos systèmes. Pour les responsables formation, c’est un suivi robuste ; pour les concepteurs pédagogiques, des contenus vivants ; pour les RH, un socle automatisable. Essayez gratuitement la suite : essayer Virtual Training Suite.

Checklist de déploiement rapide

• Identifier les endpoints (auth, lecture, écriture) de l’API cible et clarifier les données minimales (RGPD).
• Sécuriser l’accès (HTTPS, tokens, service intermédiaire si besoin).
• Prototyper un premier GET de profil dans VTS Editor ; afficher le résultat dans un Message.
• Parser la réponse (fromJson, expressions régulières) et piloter un chemin avec Conditions.
• Gérer l’erreur (délai, nouvel essai, message clair, mode alternatif).
• Tester en bac à sable avec données de test ; mesurer temps de réponse et taux d’erreurs.
• Industrialiser : encapsuler les schémas réutilisables en Fonction ; suivre l’usage et itérer. Besoin d’aide ? Découvrez nos offres de formation & accompagnement.

Aller plus loin

• Centralisez distribution, authentification et analytics avec VTS Perform ; synchronisez automatiquement badges et statistiques.
• Utilisez les Variables comme cache local, pour personnaliser les appels (langue, contexte), partager des états entre scénarios, ou contrôler l’aléatoire via une seed serveur.
• Exportez en SCORM pour votre LMS et complétez le suivi avec des Requêtes Web ciblées (indicateurs métiers, émargement, validations).
• Découvrez nos solutions et cas inspirants : Serious Factory.

Références et ressources utiles

• Gamification et performance d’apprentissage : Hamari, J., Koivisto, J., & Sarsa, H. (2014). Does Gamification Work? A Literature Review. HICSS. Lire sur IEEE Xplore.
• Panorama des learning analytics : Society for Learning Analytics Research, Handbook of Learning Analytics (2e éd.). Accéder au Handbook.
• Suivi d’apprentissages avec xAPI : Advanced Distributed Learning Initiative. Présentation de l’Experience API.
• Exemples chiffrés d’engagement avec VTS : Manpower Academy. Cas client.