查询对话记录

调试

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

请求参数

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

系统规定参数。取值：QueryConversations。
InstanceId String 是 12f407b22cbe4890ac595f09985848d5

实例ID
PageNumber Integer 是 1

当前页数
PageSize Integer 是 10

每页条数
CallingNumber String 否 02811111111

主叫号码
BeginTimeLeftRange Long 否 1582183381000

开始日期范围左区间
BeginTimeRightRange Long 否 1582356181000

开始日期范围右区间

返回数据

名称 类型 示例值 描述
Conversations Array

会话列表
BeginTime Long 1582183381000

开始时间
CallingNumber String 02811111111

主叫号码
ConversationId String af81a389-91f0-4157-8d82-720edd02b66a

会话ID
EffectiveAnswerCount Integer 8

有效回答数量
EndTime Long 1582183481000

结束时间
SkillGroupId String AAA

技能组
TransferredToAgent Boolean true

是否转人工
UserUtteranceCount Integer 10

用户回答数量
PageNumber Integer 1

当前页数
PageSize Integer 10

每页条数
RequestId String 14C39896-AE6D-4643-9C9A-E0566B2C2DDD

请求ID
TotalCount Long 100

总数量

示例

请求示例

http(s)://[Endpoint]/?Action=QueryConversations
&InstanceId=12f407b22cbe4890ac595f09985848d5
&PageNumber=1
&PageSize=10
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>14C39896-AE6D-4643-9C9A-E0566B2C2DDD</RequestId>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<TotalCount>100</TotalCount>
<Conversations>
    <CallingNumber>02811111111</CallingNumber>
    <BeginTime>1582183381000</BeginTime>
    <EndTime>1582183481000</EndTime>
    <TransferredToAgent>true</TransferredToAgent>
    <SkillGroupId>AAA</SkillGroupId>
    <UserUtteranceCount>10</UserUtteranceCount>
    <EffectiveAnswerCount>8</EffectiveAnswerCount>
    <ConversationId>af81a389-91f0-4157-8d82-720edd02b66a</ConversationId>
</Conversations>

JSON 格式 

{
    "RequestId": "14C39896-AE6D-4643-9C9A-E0566B2C2DDD",
	"PageNumber": 1,
	"PageSize": 10,
	"TotalCount": 100,
	"Conversations": [
	  {
	    "CallingNumber": "02811111111",
	    "BeginTime": "1582183381000",
	    "EndTime": "1582183481000",
	    "TransferredToAgent":true,
	    "SkillGroupId":"AAA",
	    "UserUtteranceCount":10,
	    "EffectiveAnswerCount":8,
        "ConversationId":"af81a389-91f0-4157-8d82-720edd02b66a"
	  }
	]
}

错误码

HttpCode 错误码 错误信息 描述
500 InternalError An error occurred while processing your request. Please try again later. Submit a ticket if the error still exists. 内部错误。建议重试，如果多次重试报错请提交工单。
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例ID不存在。
400 InvalidParameter The specified parameter %s is invalid. 参数值校验不通过。请使用请求参数构造规范化的请求字符串。

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

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