Introduction

Docebo Connect est un module agissant comme un connecteur entre votre plateforme et des systèmes SaaS tiers. Vous pouvez ainsi intégrer votre plateforme avec plus de 400 systèmes externes tiers, tout cela en investissant moins d’effort.

Docebo Connect propose un vaste catalogue de connecteurs avec les systèmes SaaS les plus populaires, afin de gérer des workflows automatisés (appelés recettes) partagés dans le but d’échanger et de partager des données sur la base de déclencheurs.

Veuillez noter que Docebo Connect tire parti des API et de la logique métier déjà existantes dans les systèmes d’intégration et n’en crée pas de nouvelles. De plus, Docebo Connect ne gère pas les flux SSO avec les fournisseurs d’identité (tels que SAML, OpenID Connect, etc.), les intégrations JavaScript (telles que Google Analytics ou Google Tag Manager) ou les intégrations basées sur des iframe (telles que Docebo OEM ou Salesforce Canvas).

Pour en savoir plus sur la définition des termes et concepts utilisés dans cet article, veuillez consulter le glossaire des termes de Docebo Connect.

À noter: toutes les actions effectuées sur la plateforme Docebo via Docebo Connect sont soumises aux mêmes restrictions et latences que si l’interface de la plateforme était utilisée manuellement. Les actions des recettes Docebo Connect ne transformeront pas les actions asynchrones de la plateforme en actions synchrones, et ne peuvent pas "sauter la file d’attente" des autres tâches en attente d’exécution sur la plateforme.

Activation de Docebo Connect

Pour activer Docebo Connect sur votre plateforme ou votre sandbox, veuillez contacter votre responsable de compte Docebo. Veuillez noter qu’en fonction des exigences d’intégration, des coûts peuvent être encourus.

Avant de commencer

L’activation de Docebo Connect créera un nouvel utilisateur de niveau Superadmin sur votre système appelé service.connect. Cet utilisateur ne peut pas être modifié ou supprimé depuis le menu de Gestion des utilisateurs. Le processus d’activation créera également une nouvelle application OAuth2 dans la section API et SSO des paramètres avancés de votre plateforme.

Avertissement: cette application OAuth2 ne doit pas être supprimée sous peine de rendre Docebo Connect non fonctionnel.

Gestion de Docebo Connect

Une fois Docebo Connect activé sur votre plateforme, connectez-vous en tant que Superadmin, accédez à votre Menu admin depuis l’icône en forme d’engrenage, repérez la section Docebo Connect et sélectionnez Gérer.

Projet

En ouvrant pour la première fois Docebo Connect, vous vous retrouverez sur l’onglet Project (Projet). De là, il est possible de :

Créer, tester, modifier et supprimer vos propres recettes

Modifiez, démarrez, arrêtez et redémarrez l’exécution et, si nécessaire, déboguez les recettes.

Avertissement: lors du test de vos recettes, seule la recette/le workflow est en mode test, ce qui signifie que les appels d’API associés sont effectués pour de vrai. Par conséquent, l’action de création, de mise à jour ou de suppression invoquée par cette action affectera réellement la ressource sur Docebo ou la plateforme tierce.

Ajouter, supprimer, démarrer et arrêter des connecteurs préconstruits pour des applications

Les connecteurs sont une exigence de base pour chaque système que vous souhaitez intégrer à la plateforme Docebo, ils fournissent la connexion sur laquelle reposent les recettes. Pour en savoir plus sur les connecteurs, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).
 

Avertissement: Le connecteur Docebo Learn docebo_connector_connection_internalne doit pas être déplacé, renommé ou supprimé - il doit être laissé tel quel. Une fois cette connexion supprimée, vous devrez contacter notre service de support pour restaurer la fonctionnalité.

Utiliser le système de corbeille intégré

Le système dispose d’un système de corbeille intégré, ce qui signifie qu’en cas de suppression involontaire de recettes ou de connecteurs, ces éléments peuvent facilement être récupérés jusqu’à ce qu’ils soient définitivement supprimés manuellement du système.

Utiliser le système de versionnage des recettes

Il existe également un système de versionnage qui permet de restaurer n’importe quelle version précédente d’une recette.

Organiser vos projets

Organisez vos recettes dans des dossiers et sous-dossiers selon vos besoins organisationnels.

Cet onglet répertorie toutes les recettes et connexions déjà configurées sur votre plateforme. Les recettes sont des workflows automatisés qui permettent à plusieurs applications d’interagir. Chacune est composée d’un déclencheur, et d’une ou plusieurs actions qui sont exécutées lorsqu’un déclencheur se produit. Plus d’informations dans la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Si vous accédez à Docebo Connect pour la première fois, aucune recette ne sera configurée, à l’exception d’une recette appelée Examples (Exemples), qui est créée automatiquement à des fins d’intégration. Vous pouvez la conserver à titre d’exemple pour la création d’autres recettes, ou la renommer.

Avant d’utiliser les recettes contenues dans le dossier Examples, il est nécessaire de cloner les originales. Cela crée une copie de la recette qui est liée à la recette originale, celle-ci étant maintenue et mise à jour automatiquement par Docebo. Lorsqu’une recette est mise à jour, vous aurez la possibilité de mettre à jour également la recette clonée. Ce processus évite que vos recettes soient automatiquement écrasées par des mises à jour, ce qui risquerait potentiellement d’effacer toutes les personnalisations que vous avez pu effectuer et/ou de bloquer des recettes liées à des ajouts ou à une automatisation en production.

Conseil: pour plus d’informations sur la façon de cloner une recette, veuillez consulter notre article sur l’utilisation de Docebo Connect : copier des recettes.

De plus, il est possible de trouver une vaste collection d’exemples de recettes dans l’onglet Community library (Bibliothèque communautaire), qui est alimenté et maintenu par la communauté Workato.

Découvrez comment créer des recettes dans la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Tableau de bord

Dans l’onglet Dashboard (Tableau de bord), vous pouvez surveiller les tâches créées par vos recettes. Vous y trouverez les détails du flux d’exécution d’une tâche, c’est-à-dire quelles étapes ont été exécutées, et les données d’entrée et de sortie de chaque étape. Plus de détails sur la surveillance des tâches (s’ouvre dans un nouvel onglet).

Cette page est divisée en trois sections :

Dashboard (Tableau de bord)

Où il est possible de surveiller la progression des tâches (nombre d’exécutions, statut) pour une période de temps spécifique (par exemple, 7 jours) et de consulter un rapport détaillé sur une tâche spécifique. Pour en savoir plus, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Dependency graph (Graphique des dépendances)

Un outil qui illustre visuellement les relations entre chaque actif et ressource (par exemple, les recettes). Pour en savoir plus, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Activity audit (Journal d’audit des activités)

Une interface simple et puissante permettant aux administrateurs de suivre de manière exhaustive les changements apportés au compte, aux connexions, aux recettes, aux dossiers et aux packages. Pour en savoir plus, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

SDK de connecteur

Depuis l’onglet Connector SDK (SDK de connecteur), il est possible de créer, mettre à jour ou supprimer votre propre connecteur personnalisé et de gérer les connecteurs importés de la communauté.

Ces connecteurs sont privés par défaut, ce qui signifie qu’ils ne sont visibles et disponibles que pour leur propriétaire. Une fois le connecteur créé et publié, vous avez la possibilité de l’utiliser dans vos recettes.

Pour en savoir plus sur le SDK de connecteur dans la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Table de recherche

Astuce : les tables de recherche sont limitées à 10 colonnes et 100 000 entrées (lignes).

Depuis l’onglet Lookup table (Table de recherche), il est possible de gérer vos propres tables de recherche, qu’il s’agisse d’en définir une nouvelle, de créer, mettre à jour ou supprimer des entrées, ou d’importer massivement des données via CSV.

Pour en savoir plus sur les tables de recherche, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Propriétés

Dans l’onglet Properties (Propriétés), il est possible de créer, mettre à jour et supprimer les propriétés de votre propre compte.

Pour en savoir plus sur les propriétés des comptes, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Bibliothèque communautaire

La Bibliothèque communautaire est un excellent endroit à explorer lors de votre première utilisation de Docebo Connect. Vous y trouverez de nombreux exemples de recettes, ainsi que des connecteurs développés, maintenus et optimisés par la communauté Workato.

Dans la section Recipes de l’onglet Bibliothèque communautaire, vous pouvez explorer une multitude d’exemples par catégorie (collaboration, RH, utilitaire, etc.) et/ou utiliser la fonction de recherche textuelle.

Une fois que vous avez identifié celle qui vous intéresse, cliquez sur Use this recipe (Utiliser cette recette) pour l’importer dans Docebo Connect :

De là, vous pouvez commencer à personnaliser selon vos besoins (à noter : Docebo Connect nécessite que vous utilisiez le connecteur Docebo Learn dans vos recettes) :

Dans la section Custom connectors (Connecteurs personnalisés), vous pouvez trouver une large collection de connecteurs développés et maintenus par la communauté Workato. Tout comme pour les recettes, il est possible de parcourir les connecteurs disponibles par catégorie (par exemple, collaboration, RH, utilitaire, etc.) et/ou d’utiliser la fonction de recherche textuelle.

Une fois que vous avez identifié le connecteur qui répond à vos besoins, vous pouvez l’importer dans votre compte Docebo Connect en cliquant sur le bouton Install connector (Installer le connecteur) :

Cliquez sur Accept and install (Accepter et installer) pour terminer la procédure d’installation :

Le connecteur devient alors disponible sous l’onglet Connector SDK :

Pour utiliser le connecteur importé dans vos recettes, vous devez le publier dans votre compte Docebo Connect en cliquant sur le bouton Release latest version (Publier la dernière version) :

Pour en savoir plus sur les connecteurs communautaires, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Plateforme API

Avec Docebo Connect, vous pouvez exposer des recettes en tant que points de terminaison d’API personnalisés. Cela vous permet de développer les fonctionnalités de la plateforme d’API Docebo existante pour répondre à vos besoins. Pour en savoir plus, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

L’onglet API Platform (Plateforme d’API) propose les onglets suivants :

Onglet Dashboard

En accédant pour la première fois à la plateforme d’API dans Docebo Connect, vous vous retrouverez sur l’onglet Dashboard (Tableau de bord). Dans cet onglet, vous avez un aperçu de votre utilisation de l’API Docebo Connect. Pour en savoir plus, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Onglet API collections

L’onglet API collections (Collections d’API) affiche des groupes de points de terminaison que vous pouvez créer. Veuillez noter que la collection Provisioning, si elle est présente, ne doit pas être supprimée. Pour découvrir comment créer des collections, veuillez consulter la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Onglet Policies

Les politiques (policies) permettent de contrôler l’utilisation de l’API. Par exemple, vous pouvez restreindre l’utilisation d’une API pour limiter le nombre de fois qu’elle est appelée, afin d’éviter une baisse de performance. La définition d’une politique est facultative ; cependant, l’absence de telles règles d’accès permet une utilisation sans restriction. Pour découvrir comment créer des politiques, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Onglet Clients

Les clients sont des groupes d’utilisateurs ayant accès aux collections d’API via leur profil. Les clients peuvent avoir plusieurs profils d’accès. Pour découvrir comment créer et gérer des clients, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Onglet Logs

Cet espace présente une liste détaillée de toutes les activités de connexion au sein de votre plateforme d’API.

Onglet Library

La bibliothèque (library) est une liste de collections d’API qui peuvent être découvertes par d’autres utilisateurs de votre organisation. Les utilisateurs peuvent y trouver la documentation, des exemples et les outils dont ils ont besoin pour utiliser votre API. Pour découvrir toutes les fonctionnalités offertes par votre bibliothèque de collections d’API, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Onglet Settings

Sur cet onglet, vous pouvez paramétrer le préfixe API et définir un domaine personnalisé.

API path prefix

Cet onglet vertical vous permet de personnaliser le préfixe figurant dans l’URL pour tous vos points de terminaison. Pour découvrir comment le personnaliser, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Custom domain

Cet onglet vertical vous permet d’utiliser un domaine personnalisé pour les redirections vers vos points de terminaison d’API. Pour découvrir comment utiliser votre propre domaine personnalisé, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Modèles de message

Depuis l’onglet Message templates (Modèles de message), vous pouvez préparer des modèles statiques de messages fréquemment utilisés en vous appuyant sur le langage Mustache (s’ouvre dans un nouvel onglet). Ces modèles peuvent être utilisés pour générer des messages dans divers formats (XML, JSON, HTML, texte, etc.).

Les modèles de messages permettent au développeur de changer le format du message, en séparant le processus de génération de la logique de composition, sans apporter de modifications à la recette qui envoie le message.

Pour en savoir plus, consultez la base de connaissances de Workato (s’ouvre dans un nouvel onglet).

Actions de recette disponibles

Voici une liste des actions Docebo que vous pouvez utiliser dans les recettes comme étapes finales ou intermédiaires. Ces actions font office de lignes directrices générales. Chacune comprend un ensemble de paramètres (nom d’utilisateur, ID de cours, etc).

Ajouter un cours au plan de formation

Ajouter un cours à un plan de formation dans Docebo

Mettre à jour un événement RSVP par lot

Mettre à jour un événement RSVP par lot dans Docebo

Créer un cours

Créer un cours dans Docebo

Créer un événement

Créer un événement dans Docebo

Créer un plan de formation

Créer un plan de formation dans Docebo

Créer une session

Créer une session dans Docebo

Créer un utilisateur

Créer un utilisateur dans Docebo

Créer des utilisateurs par lot

Créer des utilisateurs par lot dans Docebo

Action personnalisée

Créer votre propre action Docebo avec une requête personnalisée

Action personnalisée (dépréciée)

Créer votre propre action Docebo avec une requête personnalisée (dépréciée)

AVERTISSEMENT : cette action de recette a été supprimée le 8 novembre 2023. Pour éviter des problèmes, veuillez remplacer cette action de recette par une Action personnalisée. Pour ce faire, vous devez d’abord supprimer cette action de votre recette et recréer le reste de la recette à partir de ce point, en utilisant l’action de recette Action personnalisée à la place.

Supprimer un cours

Supprimer un cours dans Docebo

Supprimer un événement

Supprimer un événement dans Docebo

Supprimer un plan de formation

Supprimer un plan de formation dans Docebo

Supprimer une session

Supprimer une session dans Docebo

Supprimer un utilisateur

Supprimer un utilisateur dans Docebo

Supprimer des utilisateurs

Supprimer des utilisateurs dans Docebo

Dupliquer une session

Dupliquer une session dans Docebo

Inscrire un utilisateur à un cours

Inscrire un utilisateur à un cours dans Docebo

Inscrire un utilisateur à une session

Inscrire un utilisateur à une session dans Docebo

Récupérer des ressources de certification

Récupérer des ressources de certification dans Docebo

Récupérer des certifications

Récupérer des certifications dans Docebo

Récupérer des prix de certification

Récupérer des prix de certification dans Docebo

Récupérer un cours par ID

Récupérer un cours par ID dans Docebo

Récupérer des cours

Récupérer tous les cours dans Docebo

Récupérer des inscriptions

Récupérer des inscriptions dans Docebo

Récupérer des inscriptions par ID de session

Récupérer des inscriptions par ID de session dans Docebo

Récupérer un événement par ID

Récupérer un événement par ID dans Docebo

Récupérer des événements par ID de session

Récupérer des événements par ID de session dans Docebo

Récupérer des sessions ILT

Récupérer des sessions ILT dans Docebo

Récupérer un plan de formation par ID

Récupérer un plan de formation par ID dans Docebo

Récupérer des plans de formation

Récupérer des plans de formation dans Docebo

Récupérer une session par ID

Récupérer une session par ID dans Docebo

Récupérer des sessions par ID de cours

Récupérer des sessions par ID de cours dans Docebo

Récupérer un utilisateur par ID

Récupérer un utilisateur par ID dans Docebo

Récupérer des utilisateurs

Récupérer des utilisateurs dans Docebo

Retirer un cours du plan de formation

Retirer un cours d’un plan de formation dans Docebo

Partager un fichier

Partager un fichier dans Docebo

Partager un lien

Partager un lien dans Docebo

Désinscrire un utilisateur d’un cours

Désinscrire un utilisateur d’un cours dans Docebo

Désinscrire un utilisateur d’un plan de formation

Désinscrire un utilisateur d’un plan de formation dans Docebo

Désinscrire un utilisateur d’une session

Désinscrire un utilisateur d’une session dans Docebo

Mettre à jour un cours

Mettre à jour un cours dans Docebo

Mettre à jour un événement

Mettre à jour un événement dans Docebo

Mettre à jour un plan de formation

Mettre à jour un plan de formation dans Docebo

Mettre à jour une session

Mettre à jour une session dans Docebo

Mettre à jour un utilisateur

Mettre à jour un utilisateur dans Docebo

Migration de l’URL des Webhooks

Ce chapitre s’adresse aux individus qui utilisent des recettes nécessitant des Webhooks. Veuillez noter que depuis le 31 décembre 2023, Workato a désactivé tous les webhooks dont l’URL commence par www.workato.com pour passer à une URL commençant par webhooks.workato.com ou webhooks.eu.workato.com. Afin d’éviter tout problème avec vos recettes, veuillez suivre les étapes décrites dans ce chapitre.

Pour déterminer l’URL correcte à utiliser, accédez au Menu admin. Ensuite, dans le menu Paramètres, appuyez sur Paramètres avancés.

Ensuite, sélectionnez l’onglet vertical Informations de la plateforme et notez la région d’hébergement (Lieu service hébergement). Si celle-ci est en Europe, l’URL correcte à utiliser pour les webhooks est webhooks.eu.workato.com. Sinon, utilisez webhooks.workato.com.

Depuis le Menu admin, localisez la section Webhooks et cliquez sur Gérer.

Ensuite, localisez les webhooks associés à vos recettes Docebo Connect. Tout webhook commençant par l’URL https://www.workato.com devra être changé. Notez les recettes concernées et passez à Docebo Connect pour récupérer l’URL correcte.

Depuis le Menu admin, localisez la section Docebo Connect et cliquez sur Gérer.

Dans votre dossier Projects, localisez la recette affectée par le changement d’URL de Webhook et cliquez sur les points de suspension. Ensuite, dans le menu déroulant sélectionnez Edit recipe (Modifier la recette).

Dans l’éditeur de recette , cliquez sur l’entrée Trigger (Déclencheur) et dans la fenêtre qui s’ouvre, cliquez sur le bouton Copy (Copier) à côté de l’adresse du webhook Workato. Ensuite, cliquez sur le bouton Exit (Quitter).

Ensuite, retournez au menu de gestion des Webhooks et localisez celui que vous souhaitez mettre à jour. Appuyez sur les points de suspension à la fin de la ligne correspondante et, dans le menu déroulant, sélectionnez Modifier.

Sur l’onglet vertical Informations sur l’endpoint, collez l’URL copiée dans le champ URL charge utile. Ensuite, cliquez sur Enregistrer les modifications.

Après avoir enregistré vos modifications, votre webhook sera mis à jour mais désactivé. Cliquez sur les points de suspension sur la ligne correspondante, et sélectionnez Activer. Vous verrez alors la mention Actif sur fond vert dans la colonne Statut.

Répétez ce processus pour chaque webhook nécessitant une nouvelle URL de charge utile.

À noter : si vous utilisez des intégrations Docebo Connect nécessitant la configuration d’un webhook fournisseur tiers, veuillez vous assurer de mettre également à jour l’URL Workato de votre webhook.