列出對話

在 Customer Experience Insights 中列出對話時，可以依一或多項特徵篩選對話，縮小結果範圍。您也可以依選取的對話屬性排序結果。

排序

如要依下列任一值排序 ListConversations API 傳回的對話，請在要求中傳遞 order_by 欄位：

  • create_time {asc, desc}
  • customer_satisfaction_rating {asc, desc}
  • duration {asc, desc}
  • latest_analysis {asc, desc}
  • start_time {asc, desc}
  • turn_count {asc, desc}

預設排序順序為遞增，但您可以指定 asc 或 desc 來設定排序順序。

篩選

您可以在「對話篩選」頁面，根據一或多項特徵篩選對話。

代理 ID

篩選由特定服務專員 ID 處理的對話。系統僅支援等號運算子。

REST

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：您的 Google Cloud 專案 ID。
  • AGENT_ID：虛擬服務專員 ID。

HTTP 方法和網址：

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=agent_id=\"AGENT_ID\"

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "agentId": "AGENT_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "agentId": "AGENT_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "agentId": "AGENT_ID",
      ...
    },
  ]
}

Dialogflow 對話

篩選對應至 Dialogflow 對話資源名稱的對話。系統僅支援等號運算子。如果您在 Dialogflow 中建立對話、啟用 Dialogflow 執行階段整合功能，並想找出 Customer Experience Insights 中的哪些對話對應至 Dialogflow 中的哪些對話，這個篩選器就非常實用。

REST

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：您的 Google Cloud 專案 ID。
  • DIALOGFLOW_CONVERSATION：Dialogflow 對話資源名稱。格式為 projects/{project}/locations/{location}/conversations/{conversation}

HTTP 方法和網址：

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=data_source.dialogflow_source.dialogflow_conversation=\"DIALOGFLOW_CONVERSATION\"

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "dataSource": {
        "dialogflowSource": {
          "dialogflowConversation": "DIALOGFLOW_CONVERSATION",
        },
      },
      ...
    },
  ]
}

Dialogflow 對話設定檔 ID

篩選對應至 Dialogflow 對話設定檔 ID 的對話。唯一支援的運算子是等號。如果您設定 Dialogflow 對話設定檔，在 Dialogflow 中建立對話，並啟用 Dialogflow 執行階段整合功能，這個篩選器就很有用。您可以使用這個篩選器，找出 Customer Experience Insights 中對應至特定 Dialogflow 對話設定檔所建立對話的對話。

REST

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：您的 Google Cloud 專案 ID。
  • DIALOGFLOW_CONVERSATION_PROFILE_ID：Dialogflow 對話設定檔 ID。請注意，這只是 ID，不是資源路徑。

HTTP 方法和網址：

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/conversations?filter=dialogflow_conversation_profile_id=\"DIALOGFLOW_CONVERSATION_PROFILE_ID\"

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_1",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_2",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
    {
      "name": "projects/PROJECT_ID/locations/us-central1/conversations/CONVERSATION_ID_3",
      "dialogflowConversationProfileId": "DIALOGFLOW_CONVERSATION_PROFILE_ID",
      ...
    },
  ]
}