Intégrations personnalisées
Présentation
Les intégrations personnalisées sur Workplace sont des services qui étendent les fonctionnalités de Workplace à l’aide de l’API Graph et de l’API Gestionnaire de compte.
La création d’une application d’intégration personnalisée vous permet de synchroniser en continu les informations d’employé avec un service d’identité, d’automatiser les adhésions aux groupes, de sauvegarder les publications dans les groupes ou d’automatiser la publication destinée à des groupes spécifiques en fonction de l’activité d’un autre service.
Vous pouvez également utiliser les intégrations personnalisées pour créer des bots de groupe et de discussion qui peuvent communiquer dans les groupes sur Workplace et dans Workplace Chat.
Les intégrations personnalisées sont bien adaptées aux processus de développement internes de votre organisation (ou au développement conçu sur mesure pour l’utilisation exclusive d’un seul client Workplace). Si votre objectif diffère (par exemple, si vous souhaitez offrir une intégration SaaS (Software as a Service) ou PaaS (Platform as a Service) à plusieurs clients Workplace, utilisez plutôt des applications tierces.
Les tokens d’accès générés pour les intégrations personnalisées ne sont pas liés à l’utilisateur·ice qui les a générés. Par conséquent, les tokens n’expirent pas et ne font l’objet d’aucune rotation lorsque les utilisateur·ices sont supprimé·es ou désactivé·es. Les token d’accès restent valides jusqu’à leur rotation manuelle par un admin Workplace ou la désactivation de l’intégration personnalisée.
Création d’applications pour Workplace
L’API Graph et l’API Gestionnaire de compte pour Workplace sont des API ouvertes à tous et à toutes qui peuvent être appelées par tous les développeur·ses connaissant la procédure à suivre pour appeler des API REST. L’accès à ces API est contrôlé par les applications, avec des autorisations spécifiques et une protection par token d’accès.
Seul·es les administrateur·ices système d’une communauté Workplace peuvent créer des applications et générer des tokens d’accès dans cette communauté.
Applications et Pages
Lorsque vous créez une intégration personnalisée, deux objets sont créés :
- Une application, dotée d’autorisations spécifiques définies dans l’écran Modifier l’app.
- Une page, de type Bot, qui est uniquement visible par votre communauté Workplace. Le nom de la page reflète celui de votre intégration personnalisée, et sa photo de profil correspond à l’icône que vous avez choisie lors de la création de l’intégration.
Un token d’intégration personnalisée est généré et vous est présenté lorsque vous créez votre intégration. Il vous permet de lire et d’écrire des publications au nom de votre Page.
Création d’intégrations personnalisées
Pour créer une application pour Workplace, procédez comme suit :
- Dans le Panneau d’administration, ouvrez l’onglet Intégrations.
- Cliquez sur le bouton Créer une application.
- Choisissez un nom et une description appropriés pour l’application.
- Ajoutez une photo de profil pour l’application. Cette photo sera utilisée chaque fois que l’application sera représentée visuellement, par exemple si elle publie du contenu dans un groupe.
- Choisissez les autorisations requises pour l’application, en fonction des fonctionnalités d’intégration dont vous avez besoin.
- Copiez le token d’accès qui s’affiche et stockez-le en lieu sûr. Vous en aurez besoin pour effectuer des appels d’API.
En savoir plus
Pour en savoir plus sur la création d’applications pour Workplace, ou pour découvrir les cas d’utilisation des intégrations personnalisées, lisez les guides ci-dessous.