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 d'un bot Amazon Lex V2 à Slack
Cette rubrique fournit des instructions pour intégrer un bot Amazon Lex V2 à l'application de messagerie Slack. Procédez comme suit :
**Topics**
+ [Étape 1 : Inscrivez-vous à Slack et créez une équipe Slack](slack-step-1.md)
+ [Étape 2 : créer une application Slack](slack-step-2.md)
+ [Étape 3 : intégrer l'application Slack au bot Amazon Lex V2](slack-step-3.md)
+ [Étape 4 : Intégration complète de Slack à votre bot Lex V2](slack-step-4.md)
+ [Étape 5 : Testez l'intégration entre votre bot Lex V2 et Slack](slack-step-5.md)
# Étape 1 : Inscrivez-vous à Slack et créez une équipe Slack
Ouvrez un compte Slack et créez une équipe Slack. Pour obtenir des instructions, consultez [Using Slack](https://get.slack.help/hc/en-us/articles/212675257-Creating-a-Slack-account). Dans la section suivante, vous allez créer une application Slack que n'importe quelle équipe Slack peut installer.
## Étape suivante
[Étape 2 : créer une application Slack](slack-step-2.md)
# Étape 2 : créer une application Slack
Dans cette section, vous effectuez les opérations suivantes :
1. Créez une application Slack dans la console API Slack.
1. Configurez l'application pour ajouter une messagerie interactive à votre bot.
À la fin de cette section, vous obtenez les informations d'identification de l'application (ID client, secret client et jeton de vérification). À l'étape suivante, vous utiliserez ces informations pour intégrer le bot dans la console Amazon Lex V2.
**Pour créer une application Slack**
1. Connectez-vous à la console API Slack à [https://api.slack.com](https://api.slack.com)l'adresse.
1. Créez une application
Une fois que vous avez créé l'application, Slack affiche la page **Basic Information** pour l'application.
1. Configurez les fonctions de l'application comme suit :
1. Dans le menu de gauche, choisissez **Interactivité et raccourcis**.
+ Choisissez le bouton bascule pour activer les composants interactifs.
+ Dans la zone **Request URL**, indiquez une URL valide. Par exemple, vous pouvez utiliser **https://slack.com**.
**Note**
Pour le moment, saisissez n'importe quelle URL valide pour obtenir le jeton de vérification dont vous aurez besoin dans l'étape suivante. Vous mettrez à jour cette URL après avoir ajouté l'association du canal du bot dans la console Amazon Lex.
+ Choisissez **Save Changes (Enregistrer les modifications)**.
1. Dans la section **Paramètres** du menu de gauche, sélectionnez **Basic Information**. Enregistrez les identifiants d'application suivants :
+ ID de client
+ Clé secrète du client
+ Jeton de vérification
## Étape suivante
[Étape 3 : intégrer l'application Slack au bot Amazon Lex V2](slack-step-3.md)
# Étape 3 : intégrer l'application Slack au bot Amazon Lex V2
Dans cette section, intégrez l'application Slack que vous avez créée au bot Amazon Lex V2 que vous avez créé à l'aide des intégrations de canaux.
1. Connectez-vous à la console de gestion AWS et ouvrez la console Amazon Lex à l'adresse [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Dans la liste des robots, choisissez le bot Amazon Lex V2 que vous avez créé.
1. Dans le menu de gauche, choisissez **Intégrations de chaînes**, puis choisissez **Ajouter une chaîne**.
1. Dans **Créer un canal**, procédez comme suit :
1. Pour **Platform**, choisissez **Slack.**
1. Pour les **politiques d'identité**, choisissez la AWS KMS clé pour protéger les informations de la chaîne. La clé par défaut est fournie par Amazon Lex V2.
1. Pour la **configuration de l'intégration**, donnez un nom au canal et une description facultative. Choisissez l'alias qui pointe vers la version du bot à utiliser, puis choisissez la langue prise en charge par le canal.
**Note**
Si votre bot est disponible en plusieurs langues, vous devez créer une chaîne différente et une application différente pour chaque langue.
1. Pour **Configuration supplémentaire**, entrez ce qui suit :
+ **ID client** : saisissez l'identifiant du client depuis Slack.
+ **Secret du client** : entrez le secret du client dans Slack.
+ **Jeton de vérification** : saisissez le jeton de vérification fourni par Slack.
+ **URL de la page de réussite** : URL de la page que Slack doit ouvrir lorsque l'utilisateur est authentifié. Généralement, vous laissez ce champ vide.
1. Choisissez **Create** pour créer la chaîne.
1. Amazon Lex V2 affiche la liste des chaînes pour votre bot. Dans la liste, choisissez la chaîne que vous venez de créer.
1. À partir de **l'URL de rappel**, enregistrez le point de terminaison et le point de OAuth terminaison.
## Étape suivante
[Étape 4 : Intégration complète de Slack à votre bot Lex V2](slack-step-4.md)
# Étape 4 : Intégration complète de Slack à votre bot Lex V2
Dans cette section, utilisez la console API Slack pour terminer l'intégration avec l'application Slack.
1. Connectez-vous à la console de l'API Slack à [https://api.slack.com](https://api.slack.com)l'adresse. Choisissez l'application que vous avez créée dans [Étape 2 : créer une application Slack](slack-step-2.md).
1. Mettez à jour la fonctionnalité **OAuth & Permissions** comme suit :
1. Dans le menu de gauche, choisissez **OAuth & Permissions**.
1. Dans la URLs section **Redirection**, ajoutez le OAuth point de terminaison fourni par Amazon Lex à l'étape précédente. Sélectionnez **Add**, puis **Save URLs**.
1. Dans la section **Bot Token Scopes**, ajoutez deux autorisations à l'aide du bouton **Ajouter une OAuth portée**. Filtrez la liste avec le texte suivant :
+ **chat:write**
+ **team:read**
1. Mettez à jour la fonctionnalité **Interactivité et raccourcis** en mettant à jour la valeur de **l'URL de demande** vers le point de terminaison fourni par Amazon Lex à l'étape précédente. Entrez le point de terminaison que vous avez enregistré à l'étape 3, puis choisissez **Enregistrer les modifications**.
1. Abonnez-vous à la fonction **Abonnements aux événements** comme suit :
+ Activez les événements en choisissant l'option **Activé**.
+ Définissez la valeur de **l'URL de demande** sur le point de terminaison fourni par Amazon Lex à l'étape précédente.
+ Dans la section **S'abonner aux événements du bot**, sélectionnez **Ajouter un événement utilisateur bot** et ajoutez l'événement du **message.im** bot pour activer la messagerie directe entre l'utilisateur final et le bot Slack.
+ Enregistrez les Modifications.
1. Activez l'envoi de messages depuis l'onglet Messages comme suit :
+ Dans le menu de gauche, choisissez **App Home**.
+ Dans la section **Afficher les onglets**, choisissez **Autoriser les utilisateurs à envoyer des commandes et des messages Slash dans l'onglet Messages**.
1. Choisissez **Manage Distribution** sous **Paramètres**. Choisissez **Add to Slack** pour installer l'application. Si vous êtes authentifié auprès de plusieurs espaces de travail, choisissez d'abord l'espace de travail approprié dans le coin supérieur droit de la liste déroulante. Sélectionnez ensuite **Autoriser** pour autoriser le bot à répondre aux messages.
**Note**
Si vous apportez des modifications aux paramètres de votre application Slack ultérieurement, vous devez rétablir cette sous-étape.
## Étape suivante
[Étape 5 : Testez l'intégration entre votre bot Lex V2 et Slack](slack-step-5.md)
# Étape 5 : Testez l'intégration entre votre bot Lex V2 et Slack
Utilisez maintenant une fenêtre de navigateur pour tester l'intégration de Slack à votre bot Amazon Lex V2.
**Pour tester votre application Slack**
1. Lancez Slack. Dans le menu de gauche, dans la section **Messages directs**, choisissez votre bot. Si vous ne le voyez pas, choisissez l'icône plus (\$1) à côté de **Direct Messages** afin de le rechercher.
1. Discutez avec votre application Slack. Votre bot répond aux messages.
Si vous avez créé le bot en utilisant[Exercice 1 : créer un chatbot à partir d'un modèle](exercise-1.md), vous pouvez utiliser les exemples de conversations de cet exercice.