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

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 bot
      • Accédez à Installer l'application > Jetons OAuth pour votre espace de travail > Jeton OAuth de l'utilisateur bot.
    • Jeton de signature
      • Accédez à Informations de base > 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.

Tests

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

Messages de réponses enrichies

Les messages de réponses enrichies sont acceptés via une charge utile personnalisée dans Fulfillment. Consultez la documentation de l'API de messagerie Slack pour connaître le format des messages.

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

{
  "text": "Hello, world"
}

Réponses spécifiques aux chaînes

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