Attention : pour ceux qui utilisent la branche 1.0x du noyau, veuillez noter que cette version n'est plus prise en charge depuis le 3 juin 2025 et entrera en fin de vie le 1er décembre 2025. Docebo recommande vivement de mettre à jour le noyau des modules de l’application de formation intégrée vers la dernière révision de la branche 1.1.x.

Introduction

L’application de formation intégrée Embedded learning vous permet de lancer une instance de votre plateforme Docebo sur n'importe quelle page web externe, tant que vous avez accès à son code HTML et JavaScript.

L'instance de la plateforme Docebo s'ouvre sous forme de widget au sein de la page. Elle affiche le contenu de formation que vous, en tant que Superadmin, avez sélectionné pour l'utilisateur en fonction de l'action qu'il effectue, afin de fournir la meilleure expérience d’apprentissage à la volée, en l'enrichissant grâce à des formations ad hoc.

L'application de formation intégrée de Docebo est disponible en tant qu'application web sur ordinateur et sur mobiles.

Les modules d'Embedded learning vous permettent de lancer des widgets uniques présentant le contenu de votre plateforme Docebo dans le cadre de la gestion de la disposition de n'importe quelle page web externe, tant que vous avez accès à son code HTML et JavaScript.

Ils ont l'avantage d'offrir une formation modulaire en utilisant des widgets qui peuvent être injectés de manière transparente dans votre code HTML via une approche low-code pour en dicter le comportement. À ceci s'ajoute la fourniture du contenu, qui s'effectue à travers de simples commandes JavaScript, ou grâce à un petit ensemble d'attributs de balises HTML, en suivant les règles génériques de politique de visibilité définies sur la plateforme. L'intégrateur créant la page web pourra créer la meilleure expérience d'apprentissage à la volée pour l'utilisateur en fonction des besoins de formation spécifiques, en personnalisant le comportement du widget sans passer par la page de configuration Flow de la plateforme Docebo.

L'utilisateur accédant à la page web externe doit être authentifié par la plateforme Docebo pour être en mesure de voir le moindre contenu sur la page. Une fois la connexion établie en autorisant la session de travail appropriée sur le navigateur, le contenu de formation est fourni automatiquement à l'utilisateur final afin que son flux d'apprentissage reste ininterrompu, pas même par des requêtes de connexion.

Activer Embedded learning

Pour activer l'application de formation intégrée de Docebo, contactez Docebo via le Centre d'assistance, ou rapprochez-vous de votre gestionnaire de compte (si votre plan inclut cette option).

Intégrer des modules à votre site web

Le processus d'intégration des modules implique de charger la source du noyau, d'insérer la balise HTML du widget dans la page et de lancer une commande JavaScript avec la valeur du domaine de la plateforme et un jeton d'accès valide.

Récupérer le tout dernier noyau

Pour obtenir l'URL du dernier SDK du noyau, effectuez un appel d'API comme suit :

GET /setup/v1/flow/settings

Pour en savoir plus sur l'obtention d'un jeton porteur, veuillez consulter l'article sur l'authentification auprès des API.

Voici un exemple montrant comment l'appeler en utilisant cURL via la ligne de commande :

curl -X GET https://<sousdomaine.docebosaas.com>/setup/v1/flow/settings \
-H 'Authorization: Bearer <votre jeton porteur obtenu précédemment>'

Voici un exemple de réponse au format JSON de cet appel d'API. L'URL du noyau des modules peut être trouvée dans la valeur de la clé sdk_kernel_url, représentée dans l'exemple qui suit par la valeur buildingblocks-kernel-url-value.

{
  "data":{
    "kernel_url":"n'utilisez-pas-cette-valeur",
    "sdk_kernel_url":"buildingblocks-kernel-url-value"
  },
  "version":"1.0.0",
  "_links":[]
}

À noter :

• Le numéro de version référencé dans l'exemple de réponse précédent fait référence à la version de l'API Docebo, pas à la version du noyau.
• N'utilisez que la valeur affectée à la clé sdk_kernel_url pour l'URL du noyau des modules, pas la valeur affectée à la kernel_url.

Pour plus d'informations sur les appels API, veuillez consulter Introduction aux API Docebo.

Chargement du noyau

Pour que les modules puissent se charger dans votre page, vous devrez ajouter le noyau. Pour cela, placez le script suivant n'importe où dans la section <HEAD></HEAD> de votre page web, en remplaçant buildingblocks-kernel-url-value par la valeur récupérée à l'étape Récupérer le tout dernier noyau.

<script type="text/javascript" src="buildingblocks-kernel-url-value">

Authentifier le noyau

Après le chargement du noyau, l'utilisateur doit être authentifié. Cela peut se fait à l’aide de simples commandes JavaScript qui initialiseront le noyau et peupleront le widget en fonction de l’activité de l’utilisateur dans les formations.

Placez le code ci-dessous dans votre page, en remplaçant l'URL https://maplateforme.com par celle de votre plateforme, n'importe où après le script chargeant le noyau.

<script type="text/javascript">
  function renewToken() {
    // obtenir le jeton depuis le backend
  }
  DSDK.kernel().setTokenProvider(renewToken);
  DSDK.kernel().start({ 
    domain: "https://maplateforme.com",
    language: "votre code de langue préféré"}
  );
</script>

La commande start() contient les éléments suivants :

domain (chaîne de caractères, requis)

Le domaine principal ou personnalisé de la plateforme Docebo.

language (chaîne de caractères, optionnel)

La langue d'affichage utilisée par les widgets des modules. Pour en savoir plus, veuillez consulter la colonne lang_browsercode du tableau dans l'article contenant la liste de toutes les langues prises en charge avec leurs codes navigateur et ISO. Si cette valeur n'est pas fournie, l'anglais (États-Unis) sera utilisé par défaut.

À noter : une version plus ancienne de cette commande, qui ne permet pas de définir le paramètre langue, peut également être utilisée pour démarrer le noyau.

Attention : cette commande arrivera en fin de vie le 3 décembre 2025. Docebo vous conseille vivement de mettre à jour votre code pour utiliser la nouvelle commande de démarrage du noyau.

Les instructions pour l'ancienne commande sont les suivantes :

start(domain)
Cette commande démarre le noyau. Elle utilise le paramètre suivant :

domain (chaîne de caractères, requis)

Le domaine de la plateforme Docebo (il peut également s’agir d’un domaine personnalisé)

Exemple :

<script type="text/javascript">
  function renewToken() {
    // obtenir le jeton depuis le backend
  }
  DSDK.kernel().setTokenProvider(renewToken);
  DSDK.kernel().start("maplateforme.com");
</script>

Configurer la politique de sécurité du contenu de votre site

Si vous utilisez des politiques de sécurité du contenu sur votre site d'hébergement, vous devrez ajouter des règles pour permettre l'intégration des modules. Pour en savoir plus, veuillez consulter l'article Configurer la politique de sécurité du contenu de votre site pour la formation intégrée.

Ajouter des widgets à votre page web

Ajouter des widgets à votre page web est aussi simple que d'ajouter une paire de balises HTML (balises d'ouverture et de fermeture). Le noyau des modules injectera ensuite le widget dans le code à l'emplacement souhaité.

Le code à injecter doit être au format suivant :

<dcbo-widget-name
    id="NOM ID"
    attribute1=”valeur”
    attribute2=”valeur”
    …
>
</dcbo-widget-name>

Chaque widget possède sa propre balise et des attributs spécifiques qui peuvent être définis. Veuillez noter que bien que l'attribut id soit techniquement optionnel, chaque widget devrait se voir attribuer un ID afin de pouvoir interagir avec lui à l’aide de commandes JavaScript.

Interagir avec les widgets sur votre page web

Les widgets étant affichés en utilisant JavaScript et des sections <div>, vous pouvez facilement interagir avec le widget comme vous le souhaitez, en utilisant n'importe quel événement pour envoyer des commandes au widget. Ces événements peuvent être un changement des dimensions de la fenêtre, l'appui sur un bouton, l'expiration d'un minuteur... il n'y a aucune limite quant à ce que vous pouvez utiliser pour déclencher une commande à envoyer au widget.

Les widgets suivants sont disponibles pour les modules de formation intégrée :