批量同步聊天对话数据,单次批量不超过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. | 内部服务出现错误 |
访问错误中心查看更多错误码。