Connecter un bot à Slack

  • Article

S’APPLIQUE À : SDK v4

Vous pouvez configurer votre bot pour communiquer avec des personnes sur l’application Slack. Le présent article explique comment créer une application Slack à l’aide de Slack, connecter votre bot à votre application Slack dans Azure et tester votre bot dans Slack.

Le présent article montre comment ajouter un canal Slack à votre bot dans le portail Azure. Pour en savoir plus sur l’utilisation d’un adaptateur de canal personnalisé, reportez-vous à Informations supplémentaires.

Prérequis

  • Un abonnement Azure. Si vous n’en avez pas encore, créez un compte gratuit avant de commencer.
  • Bot publié sur Azure que vous souhaitez vous connecter à Slack.
  • Accès à un espace de travail Slack en disposant des autorisations suffisantes pour créer et gérer des applications sur https://api.slack.com/apps. Si vous n’avez accès à aucun environnement Slack, vous pouvez créer un espace de travail.

Créer une application dans Slack

Commencez par créer une application dans Slack, qui génère les informations dont vous avez besoin pour configurer le canal Slack pour votre bot dans Azure.

  1. Reportez-vous au panneau Vos applications et connectez-vous à votre compte Slack.
  2. Sélectionnez Créer une nouvelle application ou Créer une application s’il s’agit de votre première application.
    1. Dans la page Créer une application, sélectionnez À partir de zéro.
    2. Dans la page Nom de l’application & choisissez espace de travail , pour Nom de l’application, entrez le nom de votre application Slack.
    3. Pour choisir un espace de travail dans lequel développer votre application, sélectionnez un espace de travail pour votre application.
    4. Examinez et acceptez les conditions d’utilisation du service de l’API Slack.
    5. Sélectionnez Créer une application.

Ajouter une nouvelle URL de redirection

Une fois l’application créée, ajoutez une URL de redirection à votre application.

  1. Sélectionnez OAuth &Autorisations.

  2. Dans le volet qui s’affiche, sous URL de redirection, sélectionnez Ajouter une URL de redirection.

  3. Dans la zone d’entrée, saisissez l’une des URL de redirection suivantes, puis sélectionnez Ajouter.

    • Pour un bot global, saisissez https://slack.botframework.com.
    • Pour un bot régional, entrez l’URL suivante en fonction de la région sélectionnée :
    Région URL de redirection
    Europe https://europe.slack.botframework.com
    Inde https://india.slack.botframework.com

  4. Sélectionnez Enregistrer les URL.

S’abonner aux événements de bot

Après avoir ajouté l’URL de redirection, abonnez votre application aux événements du bot pour que Slack notifie votre bot des activités de l’utilisateur à l’URL spécifiée. Abonnez-vous à des événements basés sur les fonctionnalités que votre bot utilisera dans Slack.

  1. Sélectionnez Abonnement aux événements.

  2. Dans le volet qui s’affiche, faites basculer l’option Activer les événements sur Activé.

  3. Pour l’URL de la demande, saisissez l’une des URL de requête suivantes, où {bot-name} est le nom complet de votre ressource Azure Bot, sans accolades.

    • Pour un bot global, saisissez https://slack.botframework.com/api/Events/{bot-name}.
    • Pour un bot régional, entrez l’URL suivante en fonction de la région sélectionnée :
    Région URL de la requête
    Europe https://europe.slack.botframework.com/api/Events/{bot-name}
    Inde https://india.slack.botframework.com/api/Events/{bot-name}

  4. Dans la rubrique S’abonner aux événements de bot, sélectionnez Ajouter un événement utilisateur de bot, puis abonnez-vous aux événements. Par exemple :

    • member_joined_channel
    • member_left_channel
    • message.channels
    • message.groups
    • message.im
    • message.mpim

  5. Sélectionnez Enregistrer les modifications.

Permettre aux utilisateurs d’envoyer des messages au bot

Une fois que vous vous êtes abonné aux événements du bot, permettez aux utilisateurs d’envoyer des messages à votre bot.

  1. Sélectionnez l’icône d’accueil de l’application.
  2. Dans le volet qui s’affiche, dans la section Afficher les onglets sous l’onglet Messages, activez l’option Autoriser les utilisateurs à envoyer des commandes de barre oblique et des messages à partir de l’onglet Messages.

Ajouter et configurer des messages interactifs

Si vous le souhaitez, activez les messages interactifs.

  1. Sélectionnez Interactivité et Raccourcis.

  2. Pour l’URL de la demande :

    • Pour un bot global, saisissez https://slack.botframework.com/api/Actions.
    • Pour un bot régional, entrez l’URL suivante en fonction de la région sélectionnée :
    Région URL de la requête
    Europe https://europe.slack.botframework.com/Actions
    Inde https://india.slack.botframework.com/Actions

  3. Sélectionnez Enregistrer les modifications.

Copier les informations de votre application

Vous aurez besoin des informations suivantes pour ajouter le canal Slack à votre bot. Veillez toujours à copier les identifiants de l’application et à les tenir en sécurité.

  1. Sélectionnez Informations de base.
  2. Dans le volet qui s’affiche, dans la rubrique Identifiants de l’application, recherchez l’ID client, la clé secrète client et le secret de signature.
  3. À présent, sélectionnez OAuth &Autorisations.
  4. Dans le volet qui s’affiche, recherchez la section Étendues. Enregistrez les étendues de jeton de bot pour votre application.

Configurer votre bot dans Azure

Pour ce faire, vous aurez besoin des identifiants de l’application Slack que vous avez obtenus à l’étape précédente.

  1. Ouvrez le portail Azure.

  2. Ouvrez le panneau de la ressource Azure Bot pour votre bot.

  3. Ouvrez Canaux et sélectionnez Slack.

  4. Dans Configuration du canal Slack, saisissez les informations que vous avez copiées plus haut.

    1. Saisissez les identifiants Slack requis pour l’application que vous avez créée dans Slack.
    2. Si vous le souhaitez, fournissez une URL de page de destination vers laquelle les utilisateurs Slack seront redirigés après l’ajout de votre bot.
    3. L’URL de redirection OAuth & Permissions et les valeurs d’URL de demande d’abonnement aux événements doivent correspondre aux valeurs que vous avez entrées dans Slack pour ajouter l’URL de redirection et s’abonner aux événements de bot.

    submit credentials

  5. Sélectionnez Appliquer.

  6. Vous êtes redirigé vers Slack pour terminer l’installation de votre application Slack.

    • Si les autorisations demandées sont correctes, sélectionnez Autoriser.

Votre bot est désormais configuré pour communiquer avec des utilisateurs dans Slack. Les utilisateurs de l’espace de travail peuvent désormais interagir avec votre bot dans l’application Slack.

Tester vos applications dans Slack

  1. Connectez-vous à l’espace de travail Slack où vous avez installé votre application.
  2. Dans la rubrique Applications, sélectionnez votre application.
  3. Dans le volet qui s’affiche, envoyez des messages dans l’application.

Informations supplémentaires

Remarque

Depuis juin 2020, le canal Slack prend en charge l’étendue des autorisations Slack V2, qui permettent au bot de spécifier ses capacités et ses autorisations de manière plus granulaire. Tous les canaux Slack nouvellement configurés utiliseront les champs d’application V2. Pour basculer votre bot vers les étendues V2, supprimez et recréez la configuration du canal Slack dans le panneau Canaux Portail Azure.

Pour en savoir plus sur la prise en charge de Slack pour les bots, reportez-vous à la documentation de l’API Slack :

Connecter un bot à Slack à l'aide de l'adaptateur Slack

Au même titre que le canal disponible dans l’Azure AI Bot Service pour connecter votre bot à Slack, les référentiels communautaires de Bot Builder définissent un adaptateur de canal personnalisé pour Slack.

  • Pour en savoir plus sur l’adaptateur C#, reportez-vous à la section Adaptateurs du référentiel de la communauté .NET.
  • Pour en savoir plus sur l’adaptateur JavaScript, consultez la section Adaptateurs du référentiel de la communauté JavaScript.