Configuration

Introduction

Pour activer les activités Slack, vous devez saisir les détails d'authentification dans l'activité Étendue Slack ( Slack Scope ). Ces détails d'authentification donnent à un Robot la possibilité d'effectuer des Actions en votre nom et d'accéder à vos données autorisées.

Pour générer et accorder les détails d'authentification, et commencer à créer votre projet d'automatisation, procédez comme suit :

Créer une nouvelle application Slack (aucun codage requis)
Ajouter des autorisations d'application
Installez votre application sur votre espace de travail
Construisez votre projet

Après avoir créé votre application, Slack lui attribue un ID client unique, Client Secret (c'est-à-dire informations d'identification de l'application) et un jeton d'accès OAuth (pour l'automatisation Unattended) que vous saisirez dans les propriétés d'authentification de l'activité Slack Scope .

Étapes

Avant d'utiliser les activités Slack, suivez les étapes ci-dessous pour générer ou collecter les données d'entrée requises pour l'activité Étendue Slack .

1. Créer une application Slack

Pour utiliser les activités Slack, vous pouvez créer une application simple pour un espace de travail unique. Les étapes et l'exemple ci-dessous supposent que vous disposiez d'un espace de travail existant et que vous en soyez membre.

Connectez-vous à votre espace de travail Slack ou ouvrez l’application de bureau Slack.
- Si vous vous connectez à l'aide de l'URL ci-dessus, vous aurez besoin de l' URL Slack de votre espace de travail.
Accédez à Vos applications ( Your Apps ) et cliquez sur le bouton Créer une nouvelle application (Create New App ).
Saisissez votre nom d'application (App Name), sélectionnez l'espace de travail Development Slack (Development Slack) et cliquez sur le bouton Créer une application ( Create App ).

Après avoir créé votre application, vous êtes redirigé vers la page Informations de base ( Basic Information ). C’est ici que vous pouvez trouver l’ ID client et la clé secrète client dont vous aurez besoin pour l’authentification de l’automatisation assistée dans l’activité Étendue Slack .

Avant de les copier et de les coller dans votre activité, vous devez configurer les fonctionnalités OAuth et autorisations en suivant les étapes de la section suivante.

Remarque :

Bien que cela soit techniquement possible, cela n’est pas recommandé, car vous devrez partager votre clé secrète client avec eux.

Si vous souhaitez partager votre application avec les membres de l'équipe, vous pouvez utiliser le mode d'automatisation Unattended, car il repose sur un jeton d'accès OAuth partageable.

2. Ajouter des autorisations d'application

L'ajout d'autorisations à votre application se fait à l'aide d' étendues. Les étendues définissent les méthodes API que cette application peut appeler et les informations auxquelles elle peut accéder dans l'espace de travail sur lequel elle est installée. De nombreuses étendues sont limitées à des ressources spécifiques telles que les canaux ou les fichiers.

Remarque :

L'ajout d'étendues directement à votre application n'est pas nécessaire si vous prévoyez d'exécuter uniquement l'automatisation avec assistance. Si vous exécutez une automatisation assistée, vous sélectionnez vos étendues à l'aide de la propriété Étendues ( Scopes ) dans l'activité Étendue Slack .

Étant donné que la définition des étendues dans votre application permet l'automatisation Unattended et Attended, nous vous recommandons d'effectuer les étapes ci-dessous avant de commencer à utiliser le package d'activités ; cela vous permet de basculer librement entre les modes.

Dans la barre de navigation de gauche, cliquez sur le bouton OAuth et autorisations.
Dans la section URL de redirection , cliquez sur le bouton Ajouter une nouvelle URL de redirection et entrez votre URL.
- Si vous ne connaissez pas l'URL à saisir, vous pouvez la laisser vide pour le moment.
- Lorsque vous essayez de vous connecter à votre application avec l'activité Slack Scope pour la première fois (en utilisant l'automatisation Attended), l'activité ouvre une nouvelle page Web qui affiche une erreur OAuth. Cette erreur inclut l'URL de redirection (c'est-à-dire l'URI transmise) utilisée par votre espace de travail. Vous pouvez copier cette URL et la saisir comme URL de redirection .
Dans la section Étendues ( Scopes ), ajoutez les étendues d'autorisation que vous souhaitez attribuer à votre application et cliquez sur le bouton Enregistrer les modifications ( Save Changes ) (voir la liste complète des étendues à ajouter dans la section suivante).

Étendues à ajouter

Voici les étendues requises pour les différentes activités Slack. Le tableau comprend également le mappage de chaque étendue aux valeurs de propriété Étendues de l’activité Étendue Slack .

Portée	Activité	Propriété Étendues
channels:write ^{Modifier vos chaînes publiques}	Créer le canal Inviter sur le canal Rejoindre le canal Quitter le canal Supprimer du canal Envoyer message	PublicChannels
groupes:écriture ^{Modifier vos chaînes privées}	Inviter sur le canal Quitter le canal Supprimer du canal Envoyer message	PrivateChannels
im:écrire ^{Modifier les messages privés de l'utilisateur}	Inviter sur le canal Quitter le canal Supprimer du canal Envoyer message	DirectMessages
mpim:write ^{Apporter des modifications aux messages de groupe de l'utilisateur}	Inviter sur le canal Quitter le canal Supprimer du canal Envoyer message	GroupMessages
fichiers:écriture:utilisateur ^{Charger et modifier des fichiers en tant qu'utilisateur}	Envoyer message	Fichiers
fichiers:lecture ^{Accéder aux fichiers, aux commentaires et aux informations associées de l'espace de travail}	Télécharger le fichier Envoyer message	Fichiers
channels:read ^{Accéder aux informations sur la chaîne publique de l'utilisateur}	Get Messages	PublicChannels
groupes:lecture ^{Accéder aux informations sur les canaux privés de l'utilisateur}	Get Messages	PrivateChannels
im:read ^{Accéder aux informations sur les messages privés de l'utilisateur}	Get Messages	DirectMessages
mpim:lecture ^{Accéder aux informations sur les messages de groupe de l'utilisateur}	Get Messages	GroupMessages
channels:history ^{Accéder aux chaînes publiques de l'utilisateur}	Obtenir les réponses	PublicChannels
groupes:historique ^{Accéder au contenu des canaux privés de l'utilisateur}	Obtenir les réponses	PrivateChannels
im:history ^{Accéder au contenu des messages privés de l'utilisateur}	Obtenir les réponses	DirectMessages
mpim:historique ^{Accéder aux messages de groupe de l'utilisateur}	Obtenir les réponses	GroupMessages
chat:écriture:utilisateur ^{Envoyer des messages en tant qu'utilisateur}	Répondre Envoyer message	Messagerie
recherche:lecture ^{Rechercher dans le contenu de votre espace de travail}	Rechercher	(inclus avec DirectMessages et/ou GroupMessages)
users.profile:write ^{Modifier le profil de l'utilisateur}	Mettre à jour le statut	Utilisateurs
utilisateurs:lecture.e-mail ^{Afficher les adresses e-mail des membres de l'espace de travail}	Inviter sur le canal Supprimer du canal	Utilisateurs
users:read ^{Afficher la liste des membres de l'espace de travail et leurs coordonnées}	Inviter sur le canal Supprimer du canal	Utilisateurs

Après avoir sélectionné vos étendues, vous êtes prêt à installer votre application sur votre espace de travail en suivant les étapes de la section suivante.

3. Installez votre application sur votre espace de travail

Selon la façon dont votre espace de travail est administré, vous devrez peut-être demander l’installation de l’application.

Dans la section Jetons OAuth et URL de redirection (OAuth), cliquez sur le bouton Installer l'application dans l'espace de travail ( Install App to Workspace ) ou sur le bouton Demander l'installation ( Request to Install ).
Une fois l'application installée, un jeton d'accès OAuth est généré.
- À l'instar de l' ID du client et de la clé secrètedu client , le jeton d'accès OAuth est utilisé à des fins d'authentification. Les différences entre les deux deviennent applicables lors de l'exécution de votre projet d'automatisation.
  - Si vous exécutez l’automatisation Attended, l’activité Étendue Slack a besoin de valeurs dans les propriétés ID de client ( Client ID), Clé secrète du client (Client Secret) et Étendues ( Scopes ).
  - Si vous exécutez une automatisation Unattended, l'activité Slack Scope n'a besoin que d'une valeur dans la propriété Jeton d'accès OAuth.

4. Construisez votre projet

Créez un nouveau projet d'automatisation.
1. Ouvrez UiPath Studio.
2. Sous Nouveau projet, cliquez sur Traiter (cela ouvre une fenêtre Nouveau processus vide ).
3. Saisissez un nomde projet , un emplacementet une description.
4. Cliquez sur Créer (Create).
Installez le package UiPath.Slack.Activities .
1. Dans le ruban Conception (Design), cliquez sur Gérer les packages ( Manage Packages ) (cela ouvre la fenêtre Gérer les packages ).
2. Sous Tous les packages, cliquez sur Go!
3. Dans la barre de recherche , saisissez Slack.
4. Cliquez sur, installez et acceptez la licence pour UiPath.Slack.Activities.
  - Pour plus d’informations sur les packages UiPath Studio, consultez la section Gestion des packages dans le guide de Studio.

Vous avez terminé !

Maintenant que vous avez terminé la configuration, vous pouvez commencer à ajouter les activités Slack à votre projet.

Prochaines étapes

Pour une expérience d'apprentissage pratique et pour commencer rapidement à utiliser les activités, consultez les guides de démarrage rapide . Ces guides fournissent des instructions étape par étape pour vous aider à créer des échantillons pratiques des différentes activités afin que vous puissiez vérifier la connexion à votre WorkSpace Slack et vous familiariser avec les propriétés d’entrée/de sortie.

Pour en savoir plus sur les activités Slack (y compris des exemples d'entrées/sorties de propriétés), consultez la page Activités (Activities) pour obtenir une liste complète des activités et des liens vers les pages de détails des activités.

À cette page