微信會話控制

#建立會話

#此介面在客服和使用者之間建立一個會話，如果該客服和使用者會話已存在，則直接傳回0。指定的客服帳號必須已經綁定微訊號且線上。

呼叫說明

 }

1 #2 3 ##4 5 6 7

# http要求方式: POST  https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN  ##  # POST資料範例如下：  {     "kf_account" : "test1 @test",     "openid" : "OPENID"

參數說明參數#kf_accountopenid

##說明
完整客服帳號，格式為：帳號前綴@公眾號微訊號

#粉絲的openid

回傳說明4# }

1 #2 3

5 #傳回資料範例（正確時的JSON回傳結果）：   {     "errcode"  : 0, #    "errmsg"  :  "ok"

############

關閉會話

呼叫說明

 }

#1 2 3 4 5 6 #7

http請求方式: POST  https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN  POST資料範例如下： # {     "kf_account" : "test1@test",    ##   #"openid"   : "OPENID"

說明完整客服帳號，格式為：帳號前綴@公眾號微訊號

	參數說明
	#參數
	kf_account

openid

粉絲的openid2## 

回傳說明 #1

#34 5 傳回資料範例（正確時的JSON回傳結果）： # {     "errcode" : 0, #     "errmsg" :  "ok"

#}

#主要回傳碼#回傳碼

	##說明
#0	成功
65400	API不可用，即沒有開通/升級到新版客服功能
65401	無效的客服帳號
65402	帳號尚未綁定微訊號，不能投入使用
65413	不存在對應使用者的會話資訊
65414	客戶正在被其他客服接待

40003#######非法的openid############

取得客戶會話狀態

此介面取得一個客戶的會話，如果不存在，則kf_account為空。

呼叫說明

1 #2	http請求方式: GET https://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID

#參數說明

	#說明
#openid	粉絲的openid

#

回傳說明

12345 回傳資料範例（正確時的JSON回傳結果）： {    "createtime" : 123456789,    "kf_account"createtime" : 123456789,    "kf_account"create： ，為空表示沒有人在接待createtime會話接入的時間主要返回碼返回碼說明0成功65400API不可用，即沒有開通/升級到新版客服功能40003非法的openid獲取客服會話列表調用說明12 http請求方式: GEThttps://api.weixin.qq.com/customservice/kfsession/getsessionlist?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT參數說明參數說明kf_account完整客服帳號，格式為：帳號前綴@公眾號碼微訊號回傳說}

1 2 3 4 5 ##6 #7 8 9 10 11 12 13

傳回資料範例（正確時的JSON回傳結果）：  {     "sessionlist" : [         #          #"createtime" : 123456789,    #: "OPENID"        }, #        |           "createtime" : 123456789,## "   : "OPENID"        } #   #]

取得未存取會話清單呼叫說明1https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN

2 http要求方式: GET

######### ######

回傳說明

 

1 #2 3 ##4 5 6 7 8 #9 10 11 12 13 14

#傳回資料範例（正確時的JSON回傳結果）：  {     "count" : 150, #    "waitcaselist" : [ 〉           "OPENID"       },                #       ##        ##        ##       #1 #           "latest_time" : 123456789,## ## : "OPENID" #       }     #} #    ]

}

參數說明
參數	說明
#count	未存取會話數量

##################### #######waitcaselist######未接入會話列表，最多返回100條數據，按照來訪順序############openid######粉絲的openid############latest_time######粉絲的最後一則訊息的時間############

回傳碼說明

##65401無效客服帳號65402客服帳號尚未綁定微訊號，不能投入使用65413不存在對應使用者的會話資訊65414#粉絲正在被其他客服接待##6541540003

回傳碼	說明
0	#成功
65400	API不可用，即沒有開啟或升級到新版客服功能
指定的客服不在線
#不存在的openid