列出对话

在“客户体验数据分析”中列出对话时，您可以按一个或多个特征过滤对话，以缩小结果范围。您还可以按所选对话属性对结果进行排序。

排序

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 运行时集成，并想了解客户体验分析中的哪些对话与特定 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",
      ...
    },
  ]
}