微信會(huì)話控制

創(chuàng)建會(huì)話

此接口在客服和用戶之間創(chuàng)建一個(gè)會(huì)話，如果該客服和用戶會(huì)話已存在，則直接返回0。指定的客服帳號(hào)必須已經(jīng)綁定微信號(hào)且在線。

調(diào)用說(shuō)明

1 2 3 4 5 6 7

http請(qǐng)求方式: POST  https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN  POST數(shù)據(jù)示例如下：  {     "kf_account" : "test1@test",     "openid" : "OPENID"  }

參數(shù)說(shuō)明

參數(shù)	說(shuō)明
kf_account	完整客服帳號(hào)，格式為：帳號(hào)前綴@公眾號(hào)微信號(hào)
openid	粉絲的openid

返回說(shuō)明

1 2 3 4 5

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：  {     "errcode" : 0,     "errmsg" : "ok"  }

關(guān)閉會(huì)話

調(diào)用說(shuō)明

1 2 3 4 5 6 7

http請(qǐng)求方式: POST  https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN  POST數(shù)據(jù)示例如下：  {     "kf_account" : "test1@test",     "openid" : "OPENID"  }

參數(shù)說(shuō)明

參數(shù)	說(shuō)明
kf_account	完整客服帳號(hào)，格式為：帳號(hào)前綴@公眾號(hào)微信號(hào)
openid	粉絲的openid

返回說(shuō)明

1 2 3 4 5

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：  {     "errcode" : 0,     "errmsg" : "ok"  }

主要返回碼

返回碼	說(shuō)明
0	成功
65400	API不可用，即沒(méi)有開(kāi)通/升級(jí)到新版客服功能
65401	無(wú)效的客服帳號(hào)
65402	帳號(hào)尚未綁定微信號(hào)，不能投入使用
65413	不存在對(duì)應(yīng)用戶的會(huì)話信息
65414	客戶正在被其他客服接待
40003	非法的openid

獲取客戶會(huì)話狀態(tài)

此接口獲取一個(gè)客戶的會(huì)話，如果不存在，則kf_account為空。

調(diào)用說(shuō)明

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

參數(shù)說(shuō)明

參數(shù)	說(shuō)明
openid	粉絲的openid

返回說(shuō)明

12345 返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）： {    "createtime" : 123456789,    "kf_account" : "test1@test" }參數(shù)說(shuō)明參數(shù)說(shuō)明kf_account正在接待的客服，為空表示沒(méi)有人在接待createtime會(huì)話接入的時(shí)間主要返回碼返回碼說(shuō)明0成功65400API不可用，即沒(méi)有開(kāi)通/升級(jí)到新版客服功能40003非法的openid獲取客服會(huì)話列表調(diào)用說(shuō)明12 http請(qǐng)求方式: GEThttps://api.weixin.qq.com/customservice/kfsession/getsessionlist?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT參數(shù)說(shuō)明參數(shù)說(shuō)明kf_account完整客服帳號(hào)，格式為：帳號(hào)前綴@公眾號(hào)微信號(hào)返回說(shuō)

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

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：  {     "sessionlist" : [        {           "createtime" : 123456789,           "openid" : "OPENID"        },        {           "createtime" : 123456789,           "openid" : "OPENID"        }     ]  }

獲取未接入會(huì)話列表

調(diào)用說(shuō)明

1 2	http請(qǐng)求方式: GET https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN

返回說(shuō)明

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

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：  {     "count" : 150,     "waitcaselist" : [        {           "latest_time" : 123456789,           "openid" : "OPENID"        },        {           "latest_time" : 123456789,           "openid" : "OPENID"        }     ]  }

參數(shù)說(shuō)明

參數(shù)	說(shuō)明
count	未接入會(huì)話數(shù)量
waitcaselist	未接入會(huì)話列表，最多返回100條數(shù)據(jù)，按照來(lái)訪順序
openid	粉絲的openid
latest_time	粉絲的最后一條消息的時(shí)間

返回碼說(shuō)明

返回碼	說(shuō)明
0	成功
65400	API不可用，即沒(méi)有開(kāi)通或升級(jí)到新版客服功能
65401	無(wú)效客服帳號(hào)
65402	客服帳號(hào)尚未綁定微信號(hào)，不能投入使用
65413	不存在對(duì)應(yīng)用戶的會(huì)話信息
65414	粉絲正在被其他客服接待
65415	指定的客服不在線
40003	非法的openid