Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Intégration à Slack
Grâce au connecteur d'action Slack, vous pouvez accéder à la plateforme Slack directement dans Amazon Quick via le langage naturel. Vous pouvez envoyer des messages, gérer des chaînes, rechercher du contenu et interagir avec des utilisateurs et des groupes d'utilisateurs sans quitter Amazon Quick.
Amazon Quick prend en charge plusieurs méthodes d'authentification pour Slack. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.
-
Application OAuth par défaut — Utilise une application OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Vous vous authentifiez directement dans votre espace de travail Slack.
-
Application OAuth personnalisée : utilise une application Slack gérée par le client. Cette option donne à votre organisation le contrôle total de la configuration OAuth.
-
Jeton porteur — Utilise un jeton de bot Slack pour l'authentification. Cette méthode convient à l'accès à un espace de travail au niveau des robots.
Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.
Avant de commencer
Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
-
Un espace de travail Slack avec accès aux chaînes et aux données que vous souhaitez utiliser.
-
Pour l'application OAuth personnalisée : accès au tableau de bord de l'API Slack
sur le site Web de Slack pour créer une application. -
Pour Bearer Token : un jeton de bot (commençant par
xoxb-) provenant d'une application Slack. Pour plus d'informations, consultez les paramètres de l'application Quickstartsur le site Web de Slack. -
Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.
Configuration de Slack
Si vous utilisez l'authentification par défaut de l'application OAuth, ignorez cette section et passez à. Configuration du connecteur dans Amazon Quick
Pour l'authentification par application OAuth personnalisée ou par jeton porteur, suivez les étapes applicables dans Slack avant de configurer Amazon Quick.
Créez une application Slack pour une application OAuth personnalisée ou un jeton porteur
Créez une application Slack pour obtenir les informations d'identification du client ou le jeton de bot dont vous avez besoin pour Amazon Quick.
-
Accédez au tableau de bord de l'API Slack
sur le site Web de Slack et choisissez Create New App. -
Choisissez From scratch.
-
Entrez le nom de l'application et sélectionnez votre espace de travail Slack. Sélectionnez Create App (Créer une application).
-
Dans la barre latérale gauche, choisissez OAuth & Permissions.
-
Sous URL de redirection, choisissez Ajouter une nouvelle URL de redirection et entrez l'URL de rappel Amazon Quick :
https://{region}.quicksight.aws.amazon.com/sn/oauthcallbackChoisissez Ajouter, puis Enregistrer les URL.
-
Sous Scopes, ajoutez les Bot Token Scopes dont votre intégration a besoin. Pour les portées recommandées, voirÉscopes recommandés.
-
Dans la barre latérale gauche, sélectionnez Informations de base. Sous Informations d'identification de l'application, enregistrez les valeurs suivantes :
-
Identifiant du client
-
Secret client
-
-
Pour Bearer Token : installez l'application sur votre espace de travail depuis la page OAuth & Permissions. Après l'installation, copiez le jeton OAuth de l'utilisateur du bot (commence
xoxb-par).
Éscopes recommandés
Les champs d'application suivants sont demandés lorsque vous vous connectez à Slack. Lorsque vous créez une application Slack personnalisée, ajoutez ces étendues sur la page OAuth et autorisations. Pour l'application OAuth personnalisée, ajoutez-les en tant que User Token Scopes. Pour Bearer Token, ajoutez-les en tant que Bot Token Scopes.
| Scope | Description |
|---|---|
calls:read |
Lit les informations relatives aux appels. |
calls:write |
Crée et gère les appels. |
channels:history |
Lit l'historique des messages sur les chaînes publiques. |
channels:read |
Lit les informations relatives aux chaînes publiques. |
channels:write |
Gère les chaînes publiques. |
chat:write |
Envoie des messages aux chaînes et aux conversations. |
dnd:read |
Lit les paramètres « Ne pas déranger ». |
dnd:write |
Met à jour les paramètres « Ne pas déranger ». |
emoji:read |
Lit les emoji personnalisés. |
files:read |
Lit les fichiers partagés dans les chaînes. |
files:write |
Télécharge et gère des fichiers. |
groups:history |
Lit l'historique des messages sur les chaînes privées. |
groups:read |
Lit les informations relatives aux chaînes privées. |
groups:write |
Gère les chaînes privées. |
im:history |
Lit l'historique des messages dans les messages directs. |
im:read |
Lit les informations relatives aux messages directs. |
im:write |
Démarre les messages directs. |
links:read |
Lit les aperçus des liens. |
links:write |
Gère les aperçus des liens. |
mpim:history |
Lit l'historique des messages dans les messages directs de groupe. |
mpim:read |
Lit les informations relatives aux messages directs de groupe. |
mpim:write |
Démarre les messages directs de groupe. |
pins:read |
Lit les messages épinglés. |
pins:write |
Épingle et détache les messages. |
reactions:read |
Lit les réactions des emoji sur les messages. |
reactions:write |
Ajoute et supprime les réactions des emoji. |
reminders:read |
Lit les rappels. |
reminders:write |
Crée des rappels. |
remote_files:read |
Lit des fichiers distants. |
remote_files:share |
Partage des fichiers distants. |
search:read |
Recherche des messages et des fichiers. |
stars:read |
Lit les éléments marqués d'un astérisque |
stars:write |
Objets représentant des étoiles et des étoiles. |
team:read |
Lit les informations de l'espace de travail. |
usergroups:read |
Lit les informations relatives aux groupes d'utilisateurs. |
usergroups:write |
Gère les groupes d'utilisateurs. |
users:read |
Lit les informations de l'utilisateur. |
users:read.email |
Lit les adresses e-mail des utilisateurs. |
users:write |
Met à jour les informations utilisateur. |
users.profile:read |
Lit les informations du profil utilisateur. |
users.profile:write |
Met à jour les informations du profil utilisateur. |
Note
Toutes les étendues ne sont pas disponibles à la fois pour les portées de jetons utilisateur et les portées de jetons de bot. Certaines étendues, telles que search:read etstars:read, ne sont disponibles que sous forme de portées de jetons utilisateur. Lorsque vous configurez des étendues pour l'authentification par jeton porteur, vérifiez la disponibilité des étendues dans la référence des étendues de l'API Slack
Configuration du connecteur dans Amazon Quick
Se connecter depuis l'onglet Disponible
Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Dans l'onglet Disponible, recherchez Slack et choisissez Connect.
-
Terminez le processus de connexion à Slack et accordez les autorisations demandées.
Pour configurer un connecteur avec une application OAuth personnalisée ou un jeton Bearer à la place, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.
Créez à partir de l'onglet Créer pour votre équipe
Une fois que vous avez terminé toute configuration requise de Slack, créez le connecteur dans Amazon Quick.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Choisissez l'onglet Créer pour votre équipe.
-
Trouvez et choisissez Slack.
Note
Si un connecteur Slack existe déjà, une boîte de dialogue contenant vos connecteurs existants s'affiche. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez Non, créer un nouveau.
-
Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.
-
Pour Type de connexion, sélectionnez Réseau public.
-
Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.
-
Pour l'application OAuth par défaut :
Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.
-
Pour l'application OAuth personnalisée, configurez les champs suivants :
-
URL de base (facultatif) : URL de base de l'API Slack. Exemple :
https://slack.com/api -
ID client : identifiant client de votre application Slack.
-
Secret client : secret client de votre application Slack.
-
URL du jeton : point de terminaison du jeton. Exemple :
https://slack.com/api/oauth.v2.access -
URL d'autorisation : point de terminaison d'autorisation. Exemple :
https://slack.com/oauth/v2/authorize -
URL de redirection : Pre-filled avec l'URL de rappel Amazon Quick.
-
-
Pour Bearer Token, configurez les champs suivants :
-
URL de base (facultatif) : URL de base de l'API Slack. Exemple :
https://slack.com/api -
Jeton de bot : votre jeton de bot Slack (commence par
xoxb-).
-
-
-
Choisissez Suivant.
-
Si vous avez choisi l'application OAuth par défaut ou l'application OAuth personnalisée, une fenêtre d'autorisation Slack s'ouvre. Passez en revue les autorisations demandées, sélectionnez votre espace de travail, puis sélectionnez Autoriser.
-
Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.
-
Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.
-
Choisissez Publier.
Actions disponibles
Après avoir configuré le connecteur, les actions suivantes sont disponibles.
| Catégorie | Action | Description |
|---|---|---|
| Messages | Publier un message sur le chat | Publie un message sur une chaîne, un message direct ou un groupe privé. |
| Messages | Envoyez-moi un message | Envoie un message d'action à la troisième personne à une chaîne. |
| Messages | Obtenir un message Permalien | Récupère l'URL d'un permalien pour un message spécifique. |
| Canaux | Création de conversations | Crée une chaîne publique ou privée. |
| Canaux | Historique des conversations | Récupère l'historique des messages d'une chaîne. Renvoie uniquement les messages de la chronologie principale, et non les réponses par fil de discussion. |
| Canaux | Conversations et réponses | Récupère les réponses par fil à un message parent spécifique. |
| Canaux | Invitation aux conversations | Invite les utilisateurs à rejoindre une chaîne existante. |
| Canaux | Participez aux conversations | Rejoint une chaîne existante. |
| Canaux | Lancement des conversations | Supprime un utilisateur d'une chaîne. |
| Canaux | Conversations partent | Quitte un canal. |
| Canaux | Membres des conversations | Répertorie les identifiants des membres d'une chaîne. |
| Canaux | Conversations ouvertes | Ouvre ou reprend un message direct ou un message direct à plusieurs personnes. |
| Canaux | Conversations Définir le sujet | Définit ou met à jour le sujet d'une chaîne. |
| Canaux | Entamez une conversation | Récupère les métadonnées d'un canal par identifiant. |
| Canaux | Liste des chaînes | Répertorie les chaînes disponibles pour l'utilisateur. |
| Canaux | Répertorier les conversations pour l'utilisateur | Répertorie les chaînes et les messages directs accessibles à un utilisateur. |
| Réactions | Créer une réaction | Ajoute une réaction emoji à un message. |
| Réactions | Supprimer la réaction | Supprime une réaction emoji d'un message. |
| Réactions | Réactions de la liste | Répertorie les réactions à un message, à un fichier ou à un commentaire de fichier. |
| Fichiers | Télécharger ou créer un fichier | Télécharge des fichiers ou des médias vers des chaînes ou des fils de discussion. |
| Fichiers | Télécharger vers une URL externe | Ajoute une référence à un fichier externe à partager dans Slack. |
| Fichiers | Télécharger le fichier | Télécharge un fichier partagé dans Slack. |
| Fichiers | Informations sur les fichiers | Récupère les métadonnées et les commentaires d'un fichier. |
| Fichiers | Liste des fichiers | Répertorie les fichiers d'un espace de travail avec des filtres facultatifs. |
| Recherche | Tout rechercher | Recherche des messages et des fichiers dans l'espace de travail. |
| Recherche | Messages de recherche | Recherche les messages à l'aide de plages de dates et de filtres. |
| Recherche | Canaux de recherche | Recherche les chaînes par nom, sujet ou objectif. |
| Recherche | Rechercher des utilisateurs | Recherche les utilisateurs par e-mail, nom ou nom d'affichage. |
| Recherche | Contexte de recherche | Effectue des recherches dans les messages, les fichiers, les chaînes et les utilisateurs. Prend en charge la recherche sémantique dans les espaces de travail grâce à Slack AI. |
| Recherche | Obtenir la configuration de recherche | Vérifie si la recherche sémantique est disponible dans l'espace de travail. |
| Utilisateurs | Obtenir les informations utilisateur | Récupère les informations d'un utilisateur par identifiant. |
| Utilisateurs | Obtenir le profil de l'utilisateur | Récupère les informations de profil d'un utilisateur. |
| Utilisateurs | Ensemble de profils d'utilisateurs | Met à jour les champs du profil d'un utilisateur. |
| Utilisateurs | Liste des utilisateurs | Répertorie tous les utilisateurs de l'espace de travail. |
| Groupes d’utilisateurs | Création de groupes d'utilisateurs | Crée un nouveau groupe d'utilisateurs. |
| Groupes d’utilisateurs | Liste des groupes d'utilisateurs | Répertorie les groupes d'utilisateurs de l'espace de travail. |
| Groupes d’utilisateurs | Groupes d'utilisateurs | Mise à jour des utilisateurs | Remplace tous les membres d'un groupe d'utilisateurs. |
| Rappels | Rappels Ajouter | Crée un rappel avec le texte et l'heure spécifiés. |
| Espace de travail | Obtenir une équipe | Récupère les métadonnées relatives à l'espace de travail Slack. |
Note
Les actions que vous pouvez utiliser dépendent des étendues configurées pour votre application Slack et des canaux accessibles à l'utilisateur authentifié.
Gestion et résolution des problèmes
Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.
Problèmes d’authentification
-
Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée) : vérifiez que votre espace de travail Slack est actif et que vous pouvez vous connecter directement au site Web de Slack.
Pour l'application OAuth personnalisée, vérifiez que l'URL de redirection de votre application Slack correspond à l'URL de rappel Amazon Quick. -
Informations d'identification client non valides (application OAuth personnalisée) : vérifiez que l'ID client et le code secret du client correspondent aux valeurs indiquées dans la section Informations de base de votre application Slack.
-
Token porteur rejeté — Vérifiez que votre jeton de bot est actif et qu'il commence
xoxb-par. Les jetons peuvent être révoqués depuis le tableau de bord de l'API Slack. -
Autorisations insuffisantes : vérifiez que les étendues configurées pour votre application Slack incluent les autorisations requises pour les actions que vous souhaitez utiliser. Consultez Éscopes recommandés.
-
Chaîne introuvable ou absente de la chaîne : vérifiez que le bot a été ajouté à la chaîne. Invitez le bot à rejoindre la chaîne avant d'essayer de publier des messages ou de lire l'historique.
