Connect action in the Slack package

S\'authentifier sur Slack en utilisant une connexion Control Room OAuth2 et créer une session Slack réutilisable pour des actions ultérieures dans l\'automatisation.

Prérequis :

Avant d\'utiliser l\'action Se connecter, vous devez d\'abord créer et configurer une application Slack, générer le jeton de robot requis, et configurer une connexion OAuth dans la Control Room en complétant la condition préalable suivante :

Créer une application Slack
  • Accédez au portail développeur Slack : https://api.slack.com/apps
  • Accédez à Vos applications > Créer une nouvelle application
  • Choisissez À partir de zéro.

    Créer une application

  • Renseignez les champs suivants :
    • Nom de l\'application : Par exemple, Intégration Slack AA
    • Sélectionnez un espace de travail dans lequel développer votre application : sélectionnez l\'espace de travail Slack où l\'application sera utilisée

    Choisir l\'espace de travail

  • Cliquez sur Créer une application.
Configurer OAuth et les autorisations
  • Après la création de l\'application, dans le panneau de gauche, accédez à OAuth et autorisations.
  • Accédez à la section URL de redirection. Dans le champ URL de redirection, saisissez l\'URL de rappel à partir des paramètres de connexion Control Room.
  • Accédez à la section Étendues.

Ajouter des autorisations Bot Token : Dans la section Étendues, ajoutez les autorisations requises en fonction de votre cas d\'utilisation. Pour ajouter, cliquez sur Ajouter une étendue OAuth.

Voici quelques exemples :
  • chat:write → Envoyer des messages en tant que @Intégration Slack AA
  • channels:read → Afficher les informations de base sur les canaux publics dans un espace de travail
  • channels:history → Afficher les messages et autres contenus dans les canaux publics auxquels Intégration Slack AA a été ajouté
  • groups:read → Afficher les informations de base sur les canaux privés auxquels Intégration Slack AA a été ajouté
  • im:read → Afficher les informations de base sur les messages directs auxquels Intégration Slack AA a été ajouté.
Remarque :
  • Assurez-vous de choisir vos autorisations avec soin, car des autorisations insuffisantes pourraient entraîner l\'échec de certaines actions par la suite.
  • Actuellement, seule l\'authentification par Bot Token est prise en charge.

Configurer la connexion OAuth 2.0 : Pour obtenir des informations sur la création d\'un fournisseur personnalisé, voir Configurer la connexion OAuth 2.0 dans Control Room.

Paramètres

  • Dans le champ Connexion OAuth, cliquez sur Choisir pour choisir parmi les identifiants OAuth2 gérés par la Control Room.
    Remarque : Assurez-vous que la connexion OAuth2 est valide et active dans la Control Room.
  • Cliquez sur le menu déroulant Type de fournisseur pour sélectionner un fournisseur disponible ou personnalisé.
  • Dans le champ Nom de la connexion, sélectionnez l\'Objet de connexion OAuth spécifique.

    Ce champ est désactivé jusqu\'à ce qu\'un Type de fournisseur soit sélectionné.

  • Dans le champ Type de jeton, sélectionnez l\'une des options suivantes en fonction du jeton qui sera utilisé au moment de l\'exécution.
    • Partagé : pour un jeton global.

      Un jeton d\'accès de type partagé est créé lorsqu\'une connexion est établie avec la Control Room. Ce jeton d\'accès est stocké sous forme d\'information d\'identification. Lorsque vous exécutez votre automatisation, le jeton d\'accès est référencé dans l\'automatisation à l\'aide du type de fournisseur d\'application d\'entreprise défini dans la Control Room.

    • Spécifique à l\'utilisateur : pour un jeton spécifique à un utilisateur.
  • Dans le champ Session Slack, utilisez l\'un des onglets suivants pour créer une session :
    • Session locale : pour spécifier un nom de session qui ne peut être utilisé que dans le robot en cours.
    • Session globale : pour spécifier un nom de session qui peut être utilisé sur plusieurs robots, tels que des robots parents, des robots enfants et tous les autres robots enfants du robot parent.

      Recommandation : Les robots parents et enfants doivent avoir la même version de package.

    • Variable : pour spécifier une variable de session Slack.

      Cliquez sur l\'icône à droite pour créer une variable, puis choisissez Session Slack comme Type de session dans la fenêtre qui s\'affiche. Voir Création d\'une variable.