Aller au contenu

Connecteur Slack

Le connecteur Slack connecte un bot à Slack : le bot reçoit les messages d'une chaîne Slack via l'API Events de Slack, et répond avec un incoming webhook.

Ce que vous allez créer

  • Une configuration (dans Slack et dans Tock) pour recevoir et envoyer des messages Slack

  • Un bot qui parle sur une chaîne Slack

Pré-requis

  • Environ 15 minutes

  • Un bot Tock fonctionnel (par exemple suite au guide premier bot Tock)

  • Un compte Slack et un espace de travail / une chaîne où intégrer le bot

Si vous n'avez jamais utilisé Slack, rendez-vous sur https://slack.com/

Créer une application dans Slack

  • Allez sur la page Create a Slack app

  • Entrez un nom pour l'application

  • Sélectionnez un espace de travail

  • Terminez avec Create App

Activer l'envoi de messages à Slack

  • Ouvrez Incoming Webhooks et cochez Activate Incoming Webhooks

  • Cliquez sur Add New Webhook to Workspace

  • Sélectionnez une chaîne ou une personne pour la conversation avec le bot

  • Terminez par Installer

  • Copiez la Webhook URL qui vient d'être créée

La Webhook URL ressemble dans son format à quelque chose comme : https://hooks.slack.com/services/{workspaceToken}/{webhookToken}/{authToken}

  • Dans Tock Studio allez dans Settings > Configurations

  • Trouvez votre connecteur de type Slack (ou créez-en un nouveau si besoin) et ouvrez la section Connector Custom Configuration

  • Saisissez dans les trois champs tokens les jetons issus de l'adresse précédemment copiée :

    • Token 1 : le premier token de la WebhookURL, ou workspaceToken

    • Token 2 : le deuxième token de la WebhookURL, ou webhookToken

    • Token 3 : le dernier token de la WebhookURL, ou authToken

  • Terminez avec Update

Attention : en cas de réinstallation de l'application Slack dans le workspace, URL et jetons sont changés et doivent être reportés dans la configuration côté Tock.

Activer la reception de messages depuis Slack

  • Dans la page de votre application Slack, allez dans Event Subscriptions et activez Enable Events

  • Entrez dans le champ Request URL l'adresse complète de votre connecteur Slack dans Tock.

Sur la plateforme de démonstration Tock, cette adresse sera du type https://demo.tock.ai/{chemin_relatif_du_connecteur_slack}

Le chemin relatif du connecteur est indiqué dans la page Settings > Configurations. Sur la ligne correspondant à votre connecteur Slack, il s'agit du champ Relative REST path

  • Dans Subscribe to bot events, ajoutez l'événement message.channels pour utiliser le bot sur une chaîne Slack.

    D'autres événements "message" sont également disponibles : message.im pour les messages directs, message.groups pour les chaînes privées, etc. Voir la documentation Slack.

  • Validez avec Save Changes

  • Allez dans Interactive Components et activez Interactivity

  • Entrez la même Request URL que précédemment

  • Validez avec Save Changes

Installer le bot (et lui parler)

  • Dans la page de votre application Slack, allez dans OAuth & Permissions et ajoutez, dans Bot Token Scopes, les scopes nécessaires aux événements auxquels vous êtes abonné : channels:history pour message.channels, im:history pour message.im, groups:history pour message.groups

  • Allez dans Install App et installez (ou réinstallez) l'application dans le workspace

  • Dans Slack, ajoutez le bot à la chaîne (par exemple avec /invite @<nom du bot>)

  • Parlez au bot (par exemple "bonjour"). Il vous répond maintenant dans Slack !

Regarder la conversation dans Tock Studio (optionnel)

Quelque soient les canaux utilisés pour converser avec le bot, vous pouvez suivre les conversations directement dans tous les écrans Tock Studio, par exemple : Language Understanding > Inbox sentences et Sentences logs, ou encore toutes vues du menu Analytics :

  • Dans Tock, ouvrez Analytics > Users et cliquez sur l'icône Display dialog pour voir toute la conversation provenant de Slack

Aller plus loin

Pour en savoir plus sur le connecteur Slack fourni avec Tock, rendez-vous dans le dossier connector-slack sur GitHub, où vous retrouverez les sources et le README du connecteur.

Chat with Tock
×