Skip to content

Configurer son bot pour Slack

Si vous avez suivi le guide Créer son premier bot avec Tock Studio, vous avez déclaré un connecteur de type Slack mais celui-ci n’est pas encore configuré pour que le bot parle réellement sur Slack.

Avec un peu de configuration côté Slack et côté Tock, un bot peut recevoir des messages et répondre sur ce canal.

Si vous le souhaitez, vous pouvez aussi sauter cette étape et configurer un canal Messenger ou passer directement à la suite.

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 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 Configuration > Bot 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 Bot Configurations. Sur la ligne correspondant à votre connecteur Slack, il s’agit du champ Relative REST path

  • Ouvrez Add Workspace Event et sélectionnez l’évenement message.channels pour utiliser le bot sur une chaîne Slack.

D’autres événements “message” sont également disponibles : message.im pour les messages privés, message.groups, etc. Cf 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

Créer un bot Slack (et lui parler)

  • Dans la page de votre application Slack, allez dans Bot Users et faites Add a Bot User

  • Choisissez un nom / identifiant pour le bot dans Slack

  • Validez avec Add Bot User

  • Allez dans Install App et Reinstall App

  • Sélectionnez la chaîne Slack puis Installer

  • Dans Slack, allez sur la chaîne et ajoutez le bot à la chaîne

  • 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 et 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

Félicitations!

Vous venez de configurer votre bot pour qu’il parle également sur Slack.

Comme vous le constatez, connecter un bot Tock à un (ou plusieurs) canaux externes n’est qu’une affaire de configuration. Vous pouvez construire le modèle conversationnel, les fonctionnalités et la personnalité de votre assistant indépendamment des canaux sur lesquels vous souhaitez lui parler, aujourd’hui ou à l’avenir.

Continuer…

Dans les sections suivantes vous apprendrez à :

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.

Pour en savoir plus sur Tock Studio, les fonctionnalités et les modes de déploiement de Tock, vous pouvez aussi parcourir le manuel utilisateur, plus complet.