Slack

L'intégration Slack vous permet de créer facilement des bots Slack avec une compréhension du langage naturel basée sur la technologie des agents conversationnels (Dialogflow CX).

Limites

• Cette intégration n'est compatible qu'avec la saisie de texte dans la langue par défaut de l'agent.

Configurer Slack

Pour configurer l'intégration Slack pour votre agent, vous devez disposer des éléments suivants :

• Un compte Slack
• Un espace de travail Slack

Créer un bot Slack

1. Accédez à vos applications Slack.
2. Créez une application Slack à partir d'un fichier manifeste d'application. Vous trouverez ci-dessous un exemple de fichier manifeste. Assurez-vous que les champs oath_config et event_subscriptions correspondent à l'exemple de fichier manifeste.

   display_information:
     name: Conversational Agents (Dialogflow CX)
     description: Conversational Agents (Dialogflow CX) integration
     background_color: "#1148b8"
   features:
     app_home:
       home_tab_enabled: false
       messages_tab_enabled: true
       messages_tab_read_only_enabled: false
     bot_user:
       display_name: CX
       always_online: true
   oauth_config:
     scopes:
       bot:
         - app_mentions:read
         - chat:write
         - im:history
         - im:read
         - im:write
         - incoming-webhook
   settings:
     event_subscriptions:
       request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
       bot_events:
         - app_mention
         - message.im
     org_deploy_enabled: false
     socket_mode_enabled: false
     token_rotation_enabled: false
   

3. Installez votre application dans l'espace de travail de votre choix.
   • Jeton OAuth de l'utilisateur du bot
     • Accédez à "Installer une application" > "Jetons OAuth pour votre espace de travail" > "Jeton OAuth de l'utilisateur bot".
   • Jeton de signature
     • Accédez à Informations générales > Identifiants de l'application > Secret de signature.

Configurer des agents de conversation (Dialogflow CX)

1. Cliquez sur l'onglet Gérer dans le panneau de gauche.
2. Cliquez sur Intégrations dans le menu de gauche.
3. Cliquez sur le bouton Connecter du bloc Slack.
4. Renseignez les informations suivantes :
   • Jeton d'accès
   • Jeton de signature
5. Sélectionnez un environnement, le cas échéant.
6. Cliquez sur Démarrer.
7. Copiez l'URL Webhook.

Activer le webhook dans Slack

Revenez à votre application Slack et collez l'URL de votre webhook sous Event Subscriptions > Enable Events > Request URL (Abonnements aux événements > Activer les événements > URL de la requête).

Tests

Pour tester votre application configurée, dans l'espace de travail dans lequel vous l'avez installée, mentionnez-la dans un canal de groupe ou envoyez-lui un message privé.

Messages de réponses enrichies

Les messages de réponses enrichies sont acceptés via une charge utile personnalisée dans Fulfillment. Pour connaître le format de message, consultez la section API de message Slack.

Par exemple, la charge utile personnalisée suivante fournit un message texte Slack simple:

{
  "text": "Hello, world"
}

Réponses spécifiques à la chaîne

Une fois que vous avez configuré les réponses spécifiques au canal, le canal DF_CX_SLACK est automatiquement utilisé lorsque l'agent répond aux messages Slack.