微信取得聊天記錄
取得聊天記錄
此介面傳回的聊天記錄中,對於圖片、語音、視頻,分別展示成文字格式的[image]、[voice]、[video ]。對於較可能包含重要資訊的圖片訊息,後續將提供圖片拉取URL,近期將上線。
呼叫說明
1 #2345678 | 9
http要求方式: POST
POST資料範例如下: #{ #"starttime " : 987654321, "endtime" : 987654321, ## . 1,
"number" : 10000
} |
#說明 | |
#starttime | |
#endtime | |
msgid | |
number |
傳回說明
1 2 3 # 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | # ##{
## "recordlist" : [
{
#"text" : " 您好,客服test1為您服務。" ##" 您好,客服test1為您服務。", , , . ## : #"time" : 1400563710,
# "test1@test"
},
{
"openid": "opercode" "oDF3iY9WMaswOPWjCI
# : 2003, #oo ## : "你好,有什麼事?" , #"time" : 1400563731, ##"worker" : # }
#} |
參數說明
參數 | 說明 |
#worker | 完整客服帳號,格式為:帳號前綴@公眾號微訊號 |
openid | 使用者標識 |
#opercode | 操作碼,2002(客服發送訊息),2003(客服接收訊息) |
text | #聊天記錄 |
time | 操作時間,unix時間戳記 |
#回傳碼說明
回傳碼 | 說明 |
#65400 | API不可用,即沒有開通或升級到新版客服功能 |
65416 | 查詢參數不合法 |
查詢時間段超出限制 |
呼叫範例#
第一次 请求: https://api.weixin.qq.com/customservice/msgrecord/getmsglist ?access_token=ACCESS_TOKEN POST数据示例如下: { "starttime" : 1464710400, "endtime" : 1464796800, "msgid" : 1, "number" : 10000 } 返回: { "recordlist" : [ { "openid" : "oDF3iY9WMaswOPWjCIp_f3Bnpljk" , "opercode" : 2002, "text" : " 您好,客服test1为您服务。" , "time" : 1464710500, "worker" : "test1@test" }, { "openid" : "oDF3iY9WMaswOPWjCIp_f3Bnpljk" , "opercode" : 2003, "text" : "你好,有什么事情?" , "time" : 1464710600, "worker" : "test1@test" }, ...... ], "number":10000, "msgid":20165258 } 请求的number(10000)和返回的number(10000)一样,该时间段可能还有聊天记录未获取,将msgid(20165258)填进下次请求中; 第二次 请求: https://api.weixin.qq.com/customservice/msgrecord/getmsglist ?access_token=ACCESS_TOKEN POST数据示例如下: { "starttime" : 1464710400, "endtime" : 1464796800, "msgid" : 20165258, "number" : 10000 } 返回: { "recordlist" : [ { "openid" : "oDF3iY9WMaswOPWjCIp_f3Bnpljk" , "opercode" : 2002, "text" : " 您好,客服test1为您服务。" , "time" : 1464710700, "worker" : "test1@test" }, { "openid" : "oDF3iY9WMaswOPWjCIp_f3Bnpljk" , "opercode" : 2003, "text" : "你好,有什么事情?" , "time" : 1464710800, "worker" : "test1@test" }, ...... ], "number":4, "msgid":20165267 } 请求的number(10000)和返回的number(4)不一样,则该时间段的后续聊天记录获取完毕;