Slack

透過 Slack 整合,您可以輕鬆建立 Slack 機器人,並以自然語言理解技術 (Conversational Agents,即 Dialogflow CX) 為基礎。

限制

設定 Slack

如要為您的代理程式設定 Slack 整合,您必須符合以下條件:

  • 具備 Slack 帳戶
  • Slack 工作區

建立 Slack 機器人

  1. 前往 Slack 應用程式
  2. 使用應用程式資訊清單建立新的 Slack 應用程式。以下是資訊清單範例。請確認 oath_configevent_subscriptions 欄位與範例資訊清單相符。
    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. 將應用程式安裝到所選工作區中
    • 機器人使用者 OAuth 權杖
      • 依序前往「安裝應用程式」>「工作區的 OAuth 權杖」>「機器人使用者 OAuth 權杖」。
    • 簽署權杖
      • 依序前往「基本資訊」>「應用程式憑證」>「簽署密鑰」

設定 Conversational Agents (Dialogflow CX)

  1. 按一下左側面板中的「管理」分頁標籤。
  2. 按一下左側選單中的 [Integrations] (整合)
  3. 按一下「Slack」圖塊中的「連結」按鈕。
  4. 填寫下列資訊:
    • 存取權杖
    • 簽署權杖
  5. 視情況選擇環境。
  6. 按一下「啟動」
  7. 複製 Webhook 網址

在 Slack 中啟用 Webhook

返回 Slack 應用程式,然後在「事件訂閱」>「啟用事件」>「要求網址」下方貼上 webhook 網址

測試

如要測試已設定的應用程式,請在安裝應用程式的工作區中,在群組管道中提及該應用程式,或傳送即時訊息給該應用程式。

複合式回應訊息

執行中透過自訂酬載支援複合式回應訊息。如要瞭解訊息格式,請參閱 Slack 訊息 API

舉例來說,下列自訂酬載會提供簡單的 Slack 文字訊息:

{
  "text": "Hello, world"
}

管道專屬回應

設定管道專屬回應後,代理程式回應 Slack 訊息時,系統會自動使用管道 DF_CX_SLACK