Slack

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

Limites

Configurer Slack

Pour configurer l'intégration de Slack pour votre agent, vous avez besoin 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. Voici un exemple de fichier manifeste. Assurez-vous que les champs oauth_config et event_subscriptions correspondent à l'exemple de fichier manifeste :

    display_information:
  name: Dialogflow CX
  description: 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 à Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token (Installer l'application > Jetons OAuth pour votre espace de travail > Jeton OAuth de l'utilisateur du bot).
    • Jeton de signature : accédez à Basic Information > App Credentials > Signing Secret (Informations de base > Identifiants de l'application > Secret de signature).

Configurer Dialogflow CX

  1. Accédez à l'onglet Gérer dans le menu de navigation.
  2. Sélectionnez Intégrations.
  3. Cliquez sur le bouton Connecter sur la tuile Slack.
  4. Fournissez 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

Accédez à Slack Apps (Applications Slack) et collez votre URL de webhook sous Event Subscriptions (Abonnements aux événements) > Enable Events (Activer les événements) > Request URL (URL de la requête).

Tests

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

Messages de réponses enrichies

Les messages de réponse enrichie sont compatibles avec la charge utile personnalisée dans le fulfillment. Pour en savoir plus, consultez l'API de message Slack pour connaître le format de message.

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

{
  "text": "Hello, world"
}

Réponses spécifiques au canal

Après avoir configuré les réponses spécifiques au canal, le canal DF_CX_SLACK est automatiquement utilisé lorsque l'agent répond aux messages Slack.