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 avec 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 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 conversationnels (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 votre webhook. url sous 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. Consultez la page API de message Slack pour les format de message.

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 paramètres des réponses, les Le canal DF_CX_SLACK est automatiquement utilisé lorsque l'agent répond aux messages Slack.