Authentification pour Slack

Connectez UiPath à Slack à l’aide du code d’autorisation OAuth 2.0, d’une application OAuth 2.0 personnalisée ou d’un jeton d’accès par clé API.

Prérequis

Selon le type d'authentification que vous sélectionnez, vous avez besoin de l'une des informations d'identification suivantes :

• Code d'autorisation OAuth 2.0 : étendues de l'utilisateur, étendues du bot, et vos informations d'identification Slack.
• Apportez votre propre application OAuth 2.0 : ID client, clé secrète du client, étendues d'utilisateurs, étendues de bot.
• Clé API : jeton d’accès (par exemple jeton de bot, jeton d’utilisateur, etc.). Pour plus de détails, consultez la documentation Slack .

Pour créer une application privée OAuth2, suivez les étapes décrites dans la documentation Slack .

Remarque :

Lors de l'enregistrement de votre application OAuth dans Slack, assurez-vous de définir l' URL de rappel sur la valeur affichée sur la page de création de connexion, par exemple https://cloud.uipath.com/provisioning_/callback pour Automation Cloud.

Pour créer une connexion, vous devez être membre ou invité d'un espace de travail Slack.

Remarque :

Si vous créez une connexion à l'aide de l'application Apporter votre propre OAuth 2.0, vous devez suivre quelques étapes supplémentaires lors de l'utilisation de l'événement Bouton cliqué . Reportez-vous à Utiliser le bouton cliqué avec l'authentification Apporter votre propre OAuth 2.0 pour plus de détails.

Ajouter la connexion pour Slack

Pour créer une connexion à votre instance Slack, procédez comme suit :

1. Sélectionnez Integration Service dans la barre de gauche.

2. Dans la liste Connecteurs , sélectionnez Slack. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.

3. Sélectionnez le bouton Se connecter à Slack .

4. Saisissez les informations d’identification requises pour votre méthode d’authentification favorite. Vous pouvez choisir entre trois types d'authentification : Code d'autorisation OAuth 2.0, Apporter votre propre application OAuth 2.0 ou Clé API.

   1. Si vous sélectionnez la méthode d’application Apporter votre propre OAuth 2.0, saisissez les informations d’identification requises et sélectionnez Se connecter.

   Lorsque cette option est disponible, sélectionnez le menu à côté d'un champ et choisissez Utiliser la ressource d'informations d’identification ou Utiliser la ressource Orchestrator pour référencer une ressource Orchestrator au lieu d'entrer directement la valeur.

   Pour plus d'informations, consultez Utiliser des ressources d'informations d'identification pour les connexions.

   2. Si vous sélectionnez la méthode de clé API, saisissez la clé API et sélectionnez Connect.

      Lorsque cette option est disponible, sélectionnez le menu à côté d'un champ et choisissez Utiliser la ressource d'informations d’identification ou Utiliser la ressource Orchestrator pour référencer une ressource Orchestrator au lieu d'entrer directement la valeur.

      Pour plus d'informations, consultez Utiliser des ressources d'informations d'identification pour les connexions.

   3. Si vous sélectionnez la méthode de code d'autorisation OAuth 2.0 par défaut, passez à l'étape 4.

5. Examinez ou modifiez les étendues du bot et/ou les étendues de l’utilisateur en fonction de vos exigences ou de votre cas d’utilisation. L’étendue du bot chat:write est obligatoire et ne peut pas être supprimée; sa suppression entraîne l’échec de la création de la connexion. Toutes les autres étendues sont facultatives.

6. Select Connect.

7. Sélectionnez l'espace de travail approprié dans le coin supérieur droit de l'écran. La connexion effectue des actions uniquement pour cet espace de travail sélectionné et ses canaux respectifs.

   

8. Select Allow. With access to your Slack account, UiPath can do the following:

   • Affichez le contenu et les informations vous concernant.
   • Affichez le contenu et les informations sur les canaux et les conversations.
   • Consultez le contenu et les informations de votre espace de travail.
   • Effectuez des actions à mesure de vous.
   • Effectuez des actions dans les canaux et les conversations.
   • Effectuez des actions dans votre espace de travail.

9. Votre connexion a été ajoutée.

Étendues et autorisations

Vous pouvez utiliser la connexion pour activer les activités Slack dans UiPath Studio afin de créer des automatisations pour la gestion des utilisateurs et des canaux, la messagerie planifiée et d’autres façons de travailler en collaboration.

Étendues de bot obligatoires

L’étendue de bot suivante est obligatoire pour toutes les connexions Slack, quelle que soit la méthode d’authentification. Sa suppression empêche la création de la connexion de se terminer.

Portée	Objectif
chat:write	Obligatoire pour publier le message de confirmation de connexion dans votre espace de travail Slack après la création

Remarque :

La suppression de chat:write des étendues du bot entraîne l’échec de la création de la connexion.

Sélection du jeton d'activité de requête HTTP

L’activité Requête HTTP générique utilise le jeton de bot par défaut et revient au jeton d’utilisateur si aucun jeton de bot n’est présent sur la connexion. Cela signifie que l'activité fonctionne sur des connexions uniquement dédiées aux bots, de la même manière que les activités Slack sélectionnées.

Toutes les étendues

Utilisez la table suivante pour vérifier les différents cas d’utilisation basés sur des autorisations que vous pouvez réaliser à l’aide des activités Slack :

Table 1. Autorisations Slack requises pour chaque activité

Étendue/Autorisation	Use case	Activité
chat:write (à la fois utilisateur et jeton de bot)	Envoyer un message dans un canal en tant que bot ou utilisateur. Envoyer une réponse à un message dans le canal en tant que bot ou utilisateur. Lorsqu'un bouton est cliqué dans un canal, envoyez un message éphémère ou un message moi à l'utilisateur.	Envoyer un message au canal Envoyer une réponse
chat:write:customize (jeton de bot uniquement)	Envoyez un message dans un canal ou à un utilisateur à l'aide d'un nom et d'une icône de bot personnalisés.	Envoyer un message au canal Envoyer un message à l'utilisateur
chat:write:public (jeton de bot uniquement)	Envoyer des notifications/annonces aux canaux publics en tant que bot même si le bot n’est pas membre du canal.	Envoyer un message au canal
link:write (à la fois utilisateur et jeton de bot)	Envoyer des messages avec un aperçu de liens tels qu'un ticket Jira ou un problème GitHub, etc. en tant que bot ou utilisateur.	Envoyer un message au canal Envoyer un message à l'utilisateur
Channels:write (jeton d'utilisateur uniquement)	Créez des canaux publics pour différentes équipes et utilisateurs en fonction des besoins/sujets/objectifs en tant qu'utilisateur. Archivez ou désarchivez ou fermez dynamiquement le canal/la conversation temporaire en tant qu'utilisateur lorsque le ticket d'assistance est fermé ou rouvert.	Archiver le sujet du canal
channels:manage (jeton de bot uniquement)	Créez des canaux publics pour différentes équipes et utilisateurs en fonction du besoin/du sujet/de l’objectif en tant que bot. Archivez ou désarchivez ou fermez dynamiquement le canal/la conversation temporaire en tant qu'utilisateur lorsque le ticket d'assistance est fermé ou rouvert.	Créer une archive de canal - Définir le sujet du canal
channels:join (jeton de bot uniquement)	Téléchargez un fichier multimédia en tant que message Slack dans un canal en tant que bot en rejoignant d'abord le canal.	Rejoindre le canal
groups:write (à la fois utilisateur et jeton de bot)	Créez des canaux privés pour différentes équipes et utilisateurs en fonction des besoins/sujets/objectifs en tant que bot ou utilisateur.	Créer le canal
im:write (à la fois utilisateur et jeton de bot)	Envoyer un message individuel (IM) en tant que bot ou utilisateur.	Envoyer un message à l'utilisateur
mpim:write (à la fois utilisateur et jeton de bot)	Envoyer un message dans un groupe MPIM en tant que bot ou utilisateur. Envoyer une réponse à un message dans le groupe MPIM en tant que bot ou utilisateur. Ouvrez une conversation MPIM en ajoutant plusieurs utilisateurs pour envoyer un message en tant que bot ou utilisateur.	Envoyer un message au canal Envoyer une réponse
Channels:read (à la fois utilisateur et jeton de bot)	Récupérez la liste des canaux publics de l'espace de travail connecté afin d'envoyer des messages ou de gérer les utilisateurs en tant que bot ou utilisateur. Lisez les informations du canal public en tant que bot ou utilisateur pour envoyer des messages ou gérer les utilisateurs.	Envoyer un message au canal Envoyer un message à l'utilisateur Envoyer le fichier au canal Envoyer une réponse Inviter des utilisateurs au canal Supprimer l'utilisateur de la liste des canaux Tous les canaux Obtenir les informations du canal Répertorier tous les membres du canal
groups:read (à la fois utilisateur et jeton de bot)	Récupérez la liste des canaux privés de l'espace de travail connecté afin d'envoyer des messages ou de gérer les utilisateurs en tant que Bot ou Utilisateur. Lisez les informations sur le canal privé en tant que bot ou utilisateur pour envoyer des messages ou gérer les utilisateurs.	Envoyer un message au canal Envoyer un message à l'utilisateur Envoyer le fichier au canal Envoyer une réponse Inviter des utilisateurs au canal Supprimer l'utilisateur de la liste des canaux Tous les canaux Obtenir les informations du canal Répertorier tous les membres du canal
im:read (à la fois utilisateur et jeton de bot)	Récupérez la liste des conversations de messagerie instantanée de l'espace de travail connecté afin d'envoyer des messages en tant que bot ou utilisateur. Récupérer la liste des conversations de messagerie instantanée dont l'utilisateur fait partie.	Lister tous les canaux - Obtenir les informations sur le canal
mpim:read (à la fois utilisateur et jeton de bot)	Récupérez la liste des groupes MPIM de l’espace de travail connecté afin d’envoyer des messages en tant que bot ou utilisateur. Récupérer la liste des conversations MPIM dont l'utilisateur fait partie.	Lister tous les canaux - Obtenir les informations sur le canal
files:read (jeton de bot uniquement)	Récupérez les informations du fichier telles que l'URL publique et le téléchargement de fichiers importants tels que les résultats mensuels, à partir d'une URL via un message Slack en tant que bot ou utilisateur.	Obtenir des informations sur les fichiers
files:write (à la fois utilisateur et jeton de bot)	Avertit tous les utilisateurs d'un groupe d'utilisateurs d'une mise à jour importante. Par exemple, vous pouvez notifier en tant que bot ou utilisateur les résultats de vente trimestre à l'ensemble du groupe d'équipes Ventes/Marketing. Téléchargez un fichier multimédia sous forme de message Slack dans un canal en tant que bot ou utilisateur.	Envoyer fichier au canal
usergroups:read (jeton d'utilisateur uniquement)	Récupérez la liste des utilisateurs d'un groupe d'utilisateurs afin de mettre à jour ou d'ajouter des utilisateurs en tant que bot ou utilisateur.	Répertorier tous les groupes d'utilisateurs
usergroups:write (jeton d'utilisateur uniquement)	Créez un groupe d'utilisateurs pour plusieurs canaux en tant que bot ou utilisateur. Ajoutez des utilisateurs à un groupe d'utilisateurs existant en tant que bot ou utilisateur chaque fois qu'un nouvel utilisateur est ajouté à un canal. Activez ou désactivez dynamiquement le groupe d'utilisateurs pour le canal temporaire chaque fois que le canal temporaire est archivé/désarchivé.	Créer groupe d'utilisateurs Ajouter des utilisateurs au groupe d'utilisateurs
users:read (à la fois utilisateur et jeton de bot)	Récupérer la liste des utilisateurs de l'espace de travail connecté en tant que bot ou utilisateur afin d'envoyer des messages.	Répertorier tous les utilisateurs Inviter des utilisateurs à rejoindre le canal Supprimer l'utilisateur du canal Envoyer un message à l'utilisateur
users:read.email (à la fois utilisateur et jeton de bot)	Lisez les informations de l'utilisateur telles que le nom, l'e-mail, etc. en tant que bot ou utilisateur pour envoyer des notifications.	Obtenir utilisateur par adresse e-mail
réactions:read (jeton de bot uniquement)	Écoutez les événements de réaction aux messages dans les canaux auxquels l'application a accès. Requis lors de l'utilisation du déclencheur Réaction ajoutée avec l'authentification Apporter votre propre OAuth 2.0.	Réaction ajoutée