Introduction
Si vous utilisez l’application de messagerie Slack pour la communication interne, Docebo peut s’y intégrer, afin que vous puissiez configurer l’envoi des notifications du système via Slack.
Comme toute notification de plateforme, les notifications Slack peuvent être programmées et attribuées à des groupes, des branches, des cours et des plans de formation spécifiques, et peuvent être envoyées à votre équipe par messages directs (depuis le bot Docebo dans le message privé du Slackbot) ou via des chaînes publiques.
À noter :
- L’ancien moteur de notifications n’est pas pris en charge par Docebo for Slack version 2
- Si vous migrez depuis Docebo for Slack version 1, consultez Migrer de Docebo for Slack version 1 vers la version 2.
- Slack impose une limite de débit d’un message par seconde par utilisateur ou par chaîne. L’intégration de Docebo avec Slack ne peut pas dépasser cette limite. Si votre plateforme génère des notifications à une fréquence plus élevée, certains messages peuvent être mis en file d’attente ou retardés.
- Docebo for Slack version 2 ne prend pas en charge Slack Enterprise Grid, qui permet de fusionner plusieurs espaces de travail Slack et leurs chaînes. Si votre organisation Slack utilise Enterprise Grid et que deux espaces de travail fusionnés contiennent des chaînes portant le même nom, Docebo ne peut afficher qu’une seule des chaînes correspondantes lorsque vous recherchez une chaîne, et ne peut pas garantir à quel espace de travail fusionné elle appartient.
Migrer de Docebo pour Slack version 1 vers la version 2
Avant de commencer
Docebo for Slack version 1 utilise l’ancien moteur de notifications de Docebo. Docebo for Slack version 2, en revanche, utilise le nouveau moteur de notifications. C’est pourquoi, lors de la sortie du nouveau moteur de notifications, tous les utilisateurs de Docebo for Slack version 1 ont été exclus de la migration depuis l’ancien moteur de notifications.
En pratique, la migration de Slack version 1 vers la version 2 implique deux migrations : l’une correspond à un changement d’intégration, l’autre, effectuée pour vous par Docebo, à la migration vers le nouveau moteur de notifications.
Pour migrer de Slack version 1 vers la version 2 sans subir d’interruption, les étapes doivent être effectuées dans l’ordre suivant :
-
L’intégration Docebo for Slack version 2 doit être configurée.
Cette étape doit être effectuée en premier, car elle permet la migration vers le nouveau moteur de notifications. Elle garantit également que, lorsque votre plateforme de formation sera migrée vers le nouveau moteur de notifications, vous continuerez à recevoir les notifications via Slack sans interruption. -
Votre moteur de notifications doit être migré de l’ancien au nouveau moteur.
Une fois cette étape terminée, Docebo for Slack version 2 prendra en charge la gestion des notifications sans interruption. -
Docebo for Slack version 1 peut être réinitialisé.
Cette étape supprime les anciennes connexions existantes à votre compte Slack de l’intégration version 1, qui n’offre désormais plus aucune fonctionnalité.
Détails de la migration
Pour migrer de Docebo for Slack version 1 vers la version 2, configurez d’abord l’intégration Docebo for Slack version 2 en suivant les chapitres ci-dessous, à commencer par Activer l’application Slack version 2 sur la plateforme, et assurez-vous d’enregistrer votre configuration.
Contactez ensuite votre Customer Success Manager ou un agent du support pour activer le nouveau moteur de notifications de la plateforme. Vous recevrez une confirmation de la prise en compte de votre demande, puis une notification lorsque le moteur de notifications aura été activé. Veuillez noter qu’il ne s’agit pas d’une étape automatique et qu’elle peut prendre plusieurs jours. Vos notifications existantes seront migrées vers la nouvelle infrastructure de notifications.
Avertissement : si vous activez le nouveau moteur de notifications de la plateforme avant de configurer Docebo for Slack version 2, vous ne recevrez plus de notifications. Il est important de respecter l’ordre des instructions de ce chapitre.
Une fois le nouveau moteur de notifications activé, désactivez Docebo for Slack version 1 comme décrit dans le chapitre Réinitialiser votre configuration de l’article Docebo for Slack.
Astuce : bien que l’intégration version 2 fonctionne immédiatement, comme décrit dans cet article, vous ne recevrez pas de notifications de la plateforme via Slack version 2 tant que le nouveau moteur de notifications n’aura pas été activé dans Docebo. Les notifications seront en effet gérées par l’intégration Slack version 1.
Pour continuer à les recevoir, laissez la version 1 de l’intégration active en parallèle, afin qu’une fois votre moteur de notifications migré, la nouvelle intégration prenne le relais de ces services sans interruption.
Activer l’application Slack version 2 sur la plateforme
Activez l’application Slack V2 comme décrit dans l’article Gérer les applications et les fonctionnalités de la base de connaissances. L’application est répertoriée dans l’onglet Intégrations tierces.
Configurer Slack dans Docebo
Pour configurer Slack sur la plateforme, assurez-vous d’abord d’avoir ouvert une session sur votre compte Slack avec un profil administrateur, puis accédez au menu de navigation, recherchez Modules et intégrations (icône du puzzle) et appuyez sur l’élément Slack V2.
Appuyez ensuite sur le bouton Configurer Slack pour continuer.
Si une session Slack est déjà ouverte dans le même navigateur, appuyez sur Autoriser dans l’écran suivant ; sinon, connectez-vous à Slack, puis suivez les instructions pour autoriser l’intégration à se connecter à votre espace de travail Slack.
À noter : pour pouvoir connecter Docebo for Slack V2 à votre espace de travail Slack, vous devez avoir ouvert une session Slack avec un profil administrateur ou un profil utilisateur disposant du rôle système d’administration des intégrations.
L’intégration Slack utilisera les autorisations suivantes dans Slack :
-
incoming-webhook- Créer des webhooks unidirectionnels pour publier des messages dans une chaîne spécifique -
commands- Ajouter des raccourcis et/ou des commandes slash utilisables par les personnes -
channels:read- Afficher les informations de base sur les chaînes publiques d’un espace de travail -
team:read- Afficher le nom, le domaine de messagerie et l’icône des espaces de travail auxquels Learning Hub est connecté -
users:read- Afficher les personnes d’un espace de travail -
users:read.email- Afficher les adresses e-mail des personnes d’un espace de travail -
users.profile:read- Afficher les détails du profil des personnes d’un espace de travail
Une fois la connexion établie, la page Propriétés de Slack V2 s’affichera.
Ensuite, sur la page Paramètres de l’utilisateur, vous devrez mapper l’identifiant utilisateur Slack avec l’identifiant utilisateur Docebo. Veuillez noter que, dans Docebo, seules les valeurs ID de l’utilisateur et Nom d’utilisateur sont uniques par défaut.
À noter : pour garantir l’exactitude du mapping et des mises à jour des utilisateurs, les identifiants utilisateur Slack et Docebo doivent être identiques. Si l’ID utilisateur Slack diffère, les utilisateurs ne seront pas mappés (avec la méthode de mapping) ou seront provisionnés en tant que nouveaux utilisateurs avec l’ID utilisateur Slack, sans être associés à un compte Docebo existant (avec la méthode de provisionnement).
Synchronisation des utilisateurs
Choisissez ensuite votre méthode de synchronisation. Vous pouvez utiliser soit la méthode de mapping des utilisateurs, qui associe un utilisateur Slack à un utilisateur Docebo, soit la méthode de provisionnement des utilisateurs. Le mapping des utilisateurs associe un utilisateur Slack à un utilisateur Docebo existant, sans provisionner de nouveaux utilisateurs de Slack vers Docebo. Le provisionnement des utilisateurs vous permet de créer de nouveaux utilisateurs dans Docebo, en faisant correspondre les champs que vous avez choisi de synchroniser.
Mapping des utilisateurs
La méthode de mapping des utilisateurs vous permet de synchroniser rapidement vos utilisateurs Docebo existants avec votre base d’utilisateurs Slack. Une fois l’identifiant utilisateur souhaité correctement mappé, assurez-vous que l’option Activer le mapping des utilisateurs est sélectionnée dans la section Méthode de synchronisation.
Appuyez ensuite sur Enregistrer les modifications pour activer la synchronisation.
À noter : lorsque vous sélectionnez un champ de profil personnalisé Slack comme champ de mapping, la valeur initiale de ce champ est correctement importée lors de la première synchronisation de l’utilisateur. Cependant, les modifications ultérieures apportées à ce champ de profil personnalisé dans Slack ne sont pas répercutées dans Docebo. Cela est dû à une limitation de Slack. Les champs de profil Slack standard, par exemple l’adresse e-mail, le nom, le titre et le numéro de téléphone, ne sont pas concernés et continuent de se synchroniser selon la configuration définie.
Provisionnement des utilisateurs
L’activation du provisionnement des utilisateurs synchronise vos utilisateurs Slack avec Docebo. Sélectionnez d’abord le bouton radio Activer le provisionnement des utilisateurs dans la section Méthode de synchronisation.
Sélectionnez ensuite la branche par défaut dans laquelle les nouveaux utilisateurs seront provisionnés en appuyant sur le bouton Sélectionner branche. Une fois la branche appropriée sélectionnée, appuyez sur le bouton Sélectionner.
À noter : si un utilisateur a déjà été provisionné dans Docebo avant la mise en place de cette intégration, il peut être déplacé dans la branche choisie dans l’intégration.
Ensuite, si vous souhaitez également mettre à jour les informations de tous les utilisateurs existants, appuyez sur le bouton Mettre à jour les informations pour les utilisateurs existants. Si vous souhaitez informer l’utilisateur par notification de la création de son compte Docebo, cochez la case Envoyer une notification Utilisateur créé (le cas échéant).
Choisissez ensuite les champs Docebo que vous souhaitez faire correspondre aux champs Slack. Les champs suivants sont obligatoires et ne peuvent pas être supprimés de la liste des champs correspondants :
- Nom d’utilisateur
- Adresse e-mail
- Prénom
- Nom
Pour modifier ou définir le mapping d’un champ, appuyez sur la liste déroulante dans la zone Champ Slack du champ à modifier et choisissez parmi la liste des champs disponibles dans Slack.
À noter : le champ choisi comme identifiant dans la section Identifiant utilisateur ne peut être ni modifié ni supprimé.
Si vous souhaitez mapper des champs supplémentaires dans Slack, appuyez sur le bouton Ajouter des champs et, dans la fenêtre coulissante, sélectionnez les champs à ajouter, puis appuyez sur Ajouter.
À noter : lorsqu’un champ de profil personnalisé Slack est inclus dans une association entre un champ Slack et un champ Docebo, la valeur de ce champ personnalisé est correctement importée lors de la première création ou de la première synchronisation de l’utilisateur dans Docebo. Les modifications ultérieures apportées à ce même champ de profil personnalisé dans Slack ne sont pas répercutées dans Docebo après l’importation initiale. Ce comportement est dû à une limitation de Slack. Les champs de profil Slack standard continuent de se synchroniser selon les paramètres de provisionnement configurés et ne sont pas concernés par cette limitation. Dans la mesure du possible, Docebo recommande d’utiliser des champs de profil Slack standard pour les champs susceptibles d’évoluer au fil du temps.
Vous pouvez ensuite mapper le ou les champs supplémentaires de la même manière que les champs obligatoires. Si vous souhaitez supprimer des champs ajoutés, appuyez sur l’icône de la corbeille à la fin de la ligne de chaque champ supplémentaire.
Une fois les étapes de configuration terminées, appuyez sur Enregistrer les modifications.
Paramètres de synchronisation
Dans l’onglet Synchronisation, l’option permettant de synchroniser les données utilisateur avec Slack chaque fois qu’un utilisateur est créé ou modifié dans Slack est activée par défaut. Elle permet de synchroniser automatiquement les données utilisateur lors de chaque mise à jour. Si vous choisissez de désactiver cette option, vous devrez appuyer sur le bouton Synchroniser dans la section Synchronisation manuelle chaque fois que vous souhaitez mettre à jour le provisionnement ou le mapping des utilisateurs.
Astuce : si vous avez besoin que Docebo reflète les valeurs mises à jour des champs de profil personnalisés Slack, vous pouvez lancer une synchronisation manuelle. Gardez à l’esprit que la synchronisation manuelle effectue une importation complète des données et peut prendre beaucoup de temps selon le nombre d’utilisateurs de votre espace de travail.
À noter : la synchronisation manuelle effectue une importation complète des données et écrasera les utilisateurs précédemment mappés avec de nouvelles informations. Elle doit être effectuée uniquement si vous avez commis une erreur dans vos options de configuration précédentes et avez déjà effectué une synchronisation. Selon le nombre d’utilisateurs à mapper, cette action peut prendre beaucoup de temps.
Gérer la connexion existante
L’onglet Connexion de l’intégration Slack v2 vous permet de trouver des informations sur le nom de l’espace de travail connecté et l’ID d’équipe. Ces informations se trouvent dans la section Détails de l’onglet Connexion.
Si vous souhaitez réinitialiser votre connexion avec Slack, appuyez sur le bouton Réinitialiser les données.
À noter : appuyer sur le bouton Réinitialiser les données supprimera de votre système toutes les données mappées et tous les identifiants utilisateur Slack, et supprimera également la connexion à Slack. Cela ne supprimera pas les utilisateurs provisionnés dans Docebo. Cette action est irréversible.
Dans la fenêtre de confirmation, appuyez ensuite sur Réinitialiser.