调用GetConversationDetailByContactId根据话务ID(ContactId)获得此次对话的文本信息。

说明 此接口依赖于智能对话分析服务,请确保在云呼叫中心中已经开通了智能对话分析,详见:https://help.aliyun.com/document_detail/118820.html, 需要注意的是,智能对话分析服务对转写文本最长保存90天,建议您将数据拉取到本地进行持久化存储。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetConversationDetailByContactId

系统规定参数。取值:GetConversationDetailByContactId

ContactId String 2020927020

话务ID

InstanceId String 9cfad875-6260-4a53-ab6e-b13e3fb31f7d

待获取日常性能数据的呼叫中心实例ID

PageNumber Integer 1

为扩展预留,目前不生效,请传入1。

PageSize Integer 2

为扩展预留,目前不生效,请传入1-99之间数字。

返回数据

名称 类型 示例值 描述
Code String OK

响应码

DataList Struct

对话结果

List Array

对话文本

QualityCheckPhrase
Begin Long 1317

对话开始偏移量

End Long 3272

对话结束偏移量

Identity String xxx

身份

Role String 客服

角色,客户或者客服。

Words String 您好

对话文本

PageNumber Integer 1

为扩展预留分页数据

PageSize Integer 2

为扩展预留分页数据

TotalCount Integer 2

对话轮数

HttpStatusCode Integer 200

HTTP状态码

Message String

响应信息

RequestId String D5A4E013-09E1-4CDA-B70A-F5D3B75015A3

请求ID

Success Boolean true

是否成功

示例

请求示例

http(s)://ccc.cn-shanghai.aliyuncs.com/?Action=GetConversationDetailByContactId
&ContactId=2020927020
&InstanceId=9cfad875-6260-4a53-ab6e-b13e3fb31f7d
&PageNumber=1
&PageSize=2
&<公共请求参数>

正常返回示例

XML 格式

<GetConversationDetailByContactIdResponse>
      <code>OK</code>
      <requestId>D5A4E013-09E1-4CDA-B70A-F5D3B75015A3</requestId>
      <success>true</success>
      <dataList>
            <pageNumber>1</pageNumber>
            <pageSize>10</pageSize>
            <totalCount>2</totalCount>
            <list>
                  <role>客服</role>
                  <words>您好</words>
                  <end>3272</end>
                  <begin>1317</begin>
            </list>
            <list>
                  <role>客户</role>
                  <words>您好</words>
                  <end>6082</end>
                  <begin>3847</begin>
            </list>
      </dataList>
      <httpStatusCode>200</httpStatusCode>
</GetConversationDetailByContactIdResponse>

JSON 格式

{
  "code": "OK",
  "requestId": "D5A4E013-09E1-4CDA-B70A-F5D3B75015A3",
  "success": true,
  "dataList": {
    "pageNumber": 1,
    "pageSize": 10,
    "totalCount": 2,
    "list": [
      {
        "role": "客服",
        "words": "您好",
        "end": 3272,
        "begin": 1317
      },
      {
        "role": "客户",
        "words": "您好",
        "end": 6082,
        "begin": 3847
      }
    ]
  },
  "httpStatusCode": 200
}

错误码

访问错误中心查看更多错误码。