Micro-apps

Intégrer Slack

Déployez l’intégration Slack pour fournir des fonctionnalités de surveillance supplémentaires pour les canaux critiques qui ne sollicitent pas forcément un trafic intensif mais requièrent l’attention de ses membres. Afin de personnaliser les canaux disponibles pour un groupe ou un service spécifique, utilisez plusieurs intégrations.

Remarque :

Votre avis nous intéresse ! Veuillez fournir vos commentaires pour ce modèle d’intégration au fur et à mesure que vous l’utilisez. Pour tout problème, notre équipe surveille également notre forum dédié quotidiennement.

Pour plus de détails sur la micro-app prête à l’emploi pour Slack, consultez la section Utiliser Slack.

Vérifier les conditions préalables

Les valeurs que vous entrez dans les micro-apps Citrix Workspace sont les suivantes :

  • URL de base : https://slack.com/api
  • URL d’autorisation : https://slack.com/oauth/authorize
  • URL du jeton : https://slack.com/api/oauth.access
  • ID de canal : vous obtenez cette valeur lorsque vous créez un nouveau canal favori dans Slack. Vous en avez besoin pour modifier les points de terminaison et les actions de service. Consultez Créer un canal favori et obtenir l’ID de canal.
  • Jeton d’accès OAuth : vous saisissez cette valeur en tant que valeur de jeton lors de la configuration du modèle d’intégration. Vous obtenez l’ID client et la clé secrète client lors du processus Créer un bot.
  • ID du client : l’ID du client est la chaîne représentant les informations d’inscription client uniques sur le serveur d’autorisation.
  • Clé secrète client : la clé secrète client représente la chaîne unique générée lors de la configuration de l’intégration de l’application cible.

Remarque :

Il est recommandé de toujours utiliser OAuth 2.0 comme méthode d’authentification de service lorsque cette méthode est disponible. OAuth 2.0 garantit que votre intégration respecte la conformité maximale en matière de sécurité avec votre micro-app configurée.

Créer un compte de service

L’intégration nécessite l’accès régulier à votre instance Slack. Nous vous recommandons de créer un compte utilisateur dédié avec des privilèges d’administrateur complets. Inscrivez-vous ici : https://slack.com/get-started#/create.

Activer les API

Le nombre de requêtes d’API pouvant être exécutées sur des ressources spécifiques est limité. Nous recommandons donc ce qui suit :

Créer le bot

Les bots sont des applications Slack qui interagissent avec les utilisateurs et permettent de publier, de recevoir et de répondre aux messages des utilisateurs. Créez l’application Slack et sélectionnez des étendues à ajouter à l’application.

  1. Accédez à l’interface utilisateur Slack Management et créez une application si vous n’en avez pas encore créé : https://api.slack.com/apps
  2. Renseignez le champ App Name, puis sélectionnez Development Slack Workspace où l’application sera installée.
  3. Sélectionnez Create App.
  4. Sous Basic Information, copiez les informations d’identification de l’application (App Credentials) suivantes :
    • ID client
    • Clé secrète client
  5. Accédez à OAuth & Permissions sous Features dans la barre latérale gauche.
  6. Sous Scopes/Bot Token Scopes, sélectionnez Add an OAuth Scope sous la section Scopes. Assurez-vous d’ajouter des étendues au jeton Bot Token, et non à votre jeton utilisateur User Token. Ajoutez les étendues suivantes : channels:history channels:join channels:read groups:history groups:read mpim:history mpim:read team:read users.profile:read users:read users:read.email
  7. Sous Redirect URLs, pour chacun des rappels suivants, sélectionnez Add New Redirect URL, entrez la valeur et sélectionnez Save URLs lorsque vous avez terminé.
    • https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext
    • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Installer l’application Slack

Installez l’application dans votre espace de travail Slack pour tester votre application et générer les jetons nécessaires pour interagir avec l’API Slack.

  1. Accédez à Install App sous Settings dans la barre latérale gauche.
  2. Sélectionnez Install App to Workspace, vérifiez que l’application est autorisée à effectuer des actions dans les canaux et les conversations (option Perform actions in channels & conversations), puis sélectionnez Allow.
  3. Copiez le jeton d’accès Bot User OAuth Access Token.

Créer un canal favori et obtenir l’ID de canal

Créez un canal pour le suivi des favoris. Vous devez obtenir l’ID de canal à partir de l’URL de ce canal pour modifier l’intégration.

Remarque :

Si vous utilisez plusieurs intégrations Slack, utilisez un canal favori séparé ou dédié pour chaque intégration.

  1. Créez un nouveau canal dans Slack nommé Favorites.
  2. Sélectionnez Add all members of {SlackWorkspaceName}.
  3. Copiez le lien du canal. Enregistrez l’ID à la fin de l’URL. Il s’agit de votre ID de canal dont vous avez besoin pour modifier les points de terminaison et les actions de service. Consultez Modifier les points de terminaison et les actions de service.

Ajouter le bot aux canaux prioritaires et aux canaux favoris

Ajoutez maintenant le bot (application Slack) à tous les canaux que vous souhaitez exposer à l’équipe qui s’abonne à l’application et au canal favori créé ci-dessus. Tenez compte des considérations suivantes :

  • N’ajoutez pas de bot à un canal bruyant. Les bots doivent être ajoutés aux canaux utilisés pour des communications peu fréquentes mais urgentes au sein d’un groupe sélectionné, comme les problèmes de vente urgents pour le groupe chargé des ventes ou la sécurité informatique pour les employés généraux.
  • Plusieurs intégrations peuvent pointer vers la même application Slack.
  • Gardez la liste des canaux ciblée sur un groupe spécifique.
  • Nous vous recommandons d’ajouter le bot à un canal public uniquement. L’ajout de bots à un canal privé peut permettre à d’autres utilisateurs d’afficher l’appartenance au canal privé.

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration Slack aux micro-apps Citrix Workspace pour vous connecter à votre application. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Procédez comme suit :

  1. Sur la page Intégrations de micro-apps, sélectionnez Ajouter nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  2. Choisissez la vignette Slack.
  3. Donnez un nom d’intégration à l’intégration.
  4. Renseignez la section Paramètres du connecteur.
    • Entrez l’URL de base de l’instance : https://slack.com/api.
    • Sélectionnez une icône pour l’intégration dans la bibliothèque d’icônes ou gardez l’icône par défaut.

    Paramètres de connexion

  5. Sous Authentification du service, sélectionnez Jeton du porteur dans le menu Méthode d’authentification et complétez les détails d’authentification. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus.
  6. Entrez le jeton. Cette valeur est le jeton d’accès Bot User OAuth Access Token que vous avez obtenu lorsque vous avez créé le bot. Consultez Créer le bot.

    Authentification

  7. Sous Authentification des actions de service, activez Utiliser authentification utilisateur distincte dans Actions. Cela permet l’authentification au niveau de l’action du service. Les options d’authentification sont présélectionnées. Assurez-vous que ces options sont sélectionnées lorsque vous effectuez le processus.

    1. Sélectionnez OAuth 2.0 dans le menu Méthode d’authentification et complétez les détails d’authentification.
    2. Sélectionnez Code d’autorisation dans le menu Flux de type d’autorisation.
    3. Entrez authorization_code dans le champ Valeur du type d’autorisation.L’ URL de rappel est pré-remplie.
    4. Sélectionnez Corps de la requête dans le menu Autorisation de jeton.
    5. Sélectionnez URL du formulaire codée dans le menu Type de contenu du jeton. L’URL d’autorisation est pré-remplie : https://slack.com/oauth/authorize L’URL du jeton est pré-remplie : https://slack.com/api/oauth.access
    6. Assurez-vous que les éléments suivants sont saisis sous Étendue : channels:history channels:join channels:read groups:history groups:read mpim:history mpim:read team:read users.profile:read users:read users:read.email
    7. Entrez l’ID client que vous avez obtenu dans la section Créer le bot.
    8. Entrez la clé secrète client que vous avez obtenue dans la section Créer le bot.

    Action du service

  8. Activez l’option Limitation du taux de demandes et entrez 1 pour Nombre de demandes par seconde.
  9. Entrez 120 dans le champ Délais d’expiration des demandes.
  10. (Facultatif) Activez la fonction Journalisation pour conserver 24 heures de journalisation à des fins de support.
  11. Sélectionnez Enregistrer.

    Taux de demandes

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. Modifiez maintenant l’intégration en ajoutant la valeur channel comme décrit dans la procédure suivante.

Modifier les points de terminaison et les actions de service

Pour terminer cette configuration, vous devez ajouter la valeur channel avec votre ID de canal obtenu dans la section Créer un canal favori et obtenir l’ID de canal. Modifiez le point de terminaison Canaux favoris et les actions de service Canal favori et Retirer des favoris.

Remplacer le point de terminaison de chargement des données

Ajoutez manuellement la valeur channel dans le point de terminaison Canaux favoris avec votre ID de canal.

  1. Sur la page Intégrations de micro-apps, sélectionnez le menu en regard de l’intégration Slack, puis Modifier. L’écran Chargement des données s’ouvre. Si vous êtes sur l’écran de configuration, sélectionnez Chargement des données dans la colonne de navigation gauche.
  2. Sélectionnez le menu en regard du point de terminaison Canaux favoris, puis Modifier ou sélectionnez le nom du point de terminaison : Canaux favoris.

    Canaux favoris

  3. Sur l’écran Modifier le point de terminaison de données, sous Synchronisations complètes, entrez l’ID du canal dans le champ de valeur associé à Canal.
  4. Sélectionnez Appliquer en bas de l’écran et confirmez vos sélections.

    Valeur du canal

Remplacer les variables Action de service

Pour les actions de service Canal favori et Retirer des favoris, vous devez ajouter manuellement la valeur channel avec votre ID de canal à deux reprises pour les deux actions de service : une fois sous Exécution de l’action et une fois sous Mise à jour des données après l’action (facultatif).

  1. Lors de la modification de la configuration de l’intégration, sélectionnez Actions de service dans la colonne de navigation gauche.
  2. Sélectionnez le menu situé en regard de l’une des actions de service que vous souhaitez modifier, puis sélectionnez Modifier, ou sélectionnez le nom de l’action de service que vous souhaitez modifier. Commençons par l’action de service Canal favori.

    Canaux

  3. Sur l’écran Modifier l’action de service, sous Séquence d’action, puis sous Exécution de l’action, sélectionnez Corps.
  4. Entrez l’ID de canal dans le champ de valeur associé à Canal.
  5. Sous Mise à jour des données après l’action (facultatif), entrez à nouveau l’ID du canal dans le champ de valeur associé au canal.

    Valeur du canal

  6. Sélectionnez Enregistrer pour terminer le processus
  7. Répétez maintenant ces étapes pour l’autre action de service : Retirer des favoris. Ajoutez la valeur channel avec votre ID de canal à deux reprises : une fois sous Exécution de l’action et une fois sous Mise à jour des données après l’action (facultatif).

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Slack.

Utiliser les micro-apps Slack

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Mes canaux favoris : permet de recevoir des notifications d’activité dans les canaux favoris.

Notification ou Page Workflows de cas d’utilisation
Page Liste des canaux Fournit une liste des canaux favoris, y compris une option Ajouter des canaux.
Page Détails du canal Affiche les détails d’un canal favori, y compris les publications antérieures. Inclut les boutons d’option Publier message et Retirer des favoris.
Page Détails du message Affiche les détails du message à partir d’un canal favori, ainsi que les détails de l’expéditeur. Inclut les boutons d’option J’aime et Afficher les réponses dans Slack.
Page Publier un message Fournit un formulaire permettant de composer un message et un bouton Publier pour publier un message sur un canal favori.
Page Ajouter les détails du canal Affiche les détails d’un canal, y compris les membres. Inclut un bouton d’option Ajouter aux favoris.
Page Ajouter la liste de canaux Fournit une liste consultable des canaux, ainsi qu’une option permettant d’afficher les détails sur la page Détail du canal.

Publier sur Slack : permet de publier un message sur le canal prioritaire sélectionné dans Slack.

Notification ou Page Workflows de cas d’utilisation
Page Publier un nouveau message Fournit un formulaire permettant de composer et de publier un message.

Définir mon état Slack : permet de définir votre état Slack, de créer des rappels et d’activer l’option Ne pas déranger pendant une durée définie.

Notification ou Page Workflows de cas d’utilisation
Page Créer un rappel Fournit un formulaire permettant de définir un rappel.
Page Suspendre les notifications Fournit un formulaire permettant de suspendre les notifications pendant une durée définie.
Page Définir mon état Slack Fournit un formulaire permettant de définir un état via les options Définir un rappel et Ne pas déranger.