批量同步聊天对话数据,单次批量不超过500条。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListSyncMessages | 系统规定参数。取值:ListSyncMessages。 |
MessageDTOList | Array | 是 | 聊天数据DTO |
|
RobotCode | String | 是 | 1cY9drMec4b2uzS2 | 机器人code |
UserNick | String | 是 | 测试买家账号 | 买家nick |
UserId | String | 否 | 124652 | 买家ID |
StaffNick | String | 是 | 测试卖家账号客服 | 卖家小二nick |
StaffId | String | 否 | 275123 | 卖家小二ID |
SellerNick | String | 是 | 测试卖家账号 | 卖家nick |
SellerId | String | 否 | 234213 | 卖家ID |
Direction | String | 是 | 商家发给消费者:B2C;消费者发给商家:C2B | 消息发送方向 |
Content | String | 是 | 你好 | 消息内容 |
MessageId | String | 否 | 1de361ac62b570e | 消息ID |
SendTime | Long | 否 | 1627006485951 | 消息发送时间戳 |
Source | String | 是 | PERSON | 消息来源(人工:PERSON,智能辅助机器人: ASSIST_ROBOT,系统自动下发:SYSTEM_AUTO,其他:OTHERS) |
ContentType | String | 是 | TEXT | 消息类型(文本:TEXT, 图片:PICTURE,语音:VOICE,卡片:CARD,其他:OTHERS) |
SessionId | String | 否 | 11111 | 对话sessionId |
ChatId | String | 否 | 22222 | 对话chatId |
ProductId | String | 否 | 1234 | 商品id |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | E24A795A-EDBA-4D65-8B9C-257E700E195A | Id of the request |
Success | Boolean | true | 是否成功 |
Code | String | 200 | 错误码 |
Message | String | successful | 错误信息 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListSyncMessages
&MessageDTOList=[{"RobotCode":"1cY9drMec4b2uzS2","UserNick":"测试买家账号","UserId":"124652","StaffNick":"测试卖家账号客服","StaffId":"275123","SellerNick":"测试卖家账号","SellerId":"234213","Direction":"商家发给消费者:B2C;消费者发给商家:C2B","Content":"你好","MessageId":"1de361ac62b570e","SendTime":1627006485951,"Source":"PERSON","ContentType":"TEXT","SessionId":"11111","ChatId":"22222","ProductId":"1234"}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListSyncMessagesResponse>
<RequestId>E24A795A-EDBA-4D65-8B9C-257E700E195A</RequestId>
<Success>true</Success>
<Code>200</Code>
<Message>successful</Message>
</ListSyncMessagesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "E24A795A-EDBA-4D65-8B9C-257E700E195A",
"Success" : true,
"Code" : "200",
"Message" : "successful"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
429 | Throttling.Api | The request was denied due to API flow control. | 请求已超过最大允许的流量 |
500 | InternalError | The request processing has failed due to some unknown error. | 内部服务出现错误 |
访问错误中心查看更多错误码。