微信客服管理

獲取客服基本信息

調用說明

1 2	http請求方式: GET https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

返回說明

返回數據示例（正確時的JSON返回結果）：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

{     "kf_list" : [        {           "kf_account" : "test1@test",           "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",           "kf_id" : "1001",           "kf_nick" : "ntest1",           "kf_wx" : "kfwx1"        },        {           "kf_account" : "test2@test",           "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",           "kf_id" : "1002",           "kf_nick" : "ntest2",           "kf_wx" : "kfwx2"        },        {           "kf_account" : "test3@test",           "kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0",           "kf_id" : "1003",           "kf_nick" : "ntest3",           "invite_wx" : "kfwx3",           "invite_expire_time" : 123456789,           "invite_status" : "waiting"        }     ]  }

參數說明

參數	說明
kf_account	完整客服帳號，格式為：帳號前綴@公眾號微信號
kf_nick	客服昵稱
kf_id	客服編號
kf_headimgurl	客服頭像
kf_wx	如果客服帳號已綁定了客服人員微信號， 則此處顯示微信號
invite_wx	如果客服帳號尚未綁定微信號，但是已經發(fā)起了一個綁定邀請， 則此處顯示綁定邀請的微信號
invite_expire_time	如果客服帳號尚未綁定微信號，但是已經發(fā)起過一個綁定邀請， 邀請的過期時間，為unix 時間戳
invite_status	邀請的狀態(tài)，有等待確認“waiting”，被拒絕“rejected”， 過期“expired”

獲取客服基本信息

調用說明

1 2	http請求方式: GET https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN

返回說明

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

返回數據示例（正確時的JSON返回結果）： {    "kf_online_list": [        {            "kf_account": "test1@test",             "status": 1,             "kf_id": "1001",             "accepted_case": 1        },        {            "kf_account": "test2@test",             "status": 1,             "kf_id": "1002",             "accepted_case": 2        }    ] }

參數說明

參數	說明
kf_account	完整客服帳號，格式為：帳號前綴@公眾號微信號
status	客服在線狀態(tài)，目前為：1、web 在線
kf_id	客服編號
accepted_case	客服當前正在接待的會話數

添加客服帳號

調用說明

1 2 3 4 5 6 7

http請求方式: POST https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN POST數據示例如下：  {     "kf_account" : "test1@test",     "nickname" : "客服1"  }

參數說明

參數	說明
kf_account	完整客服帳號，格式為：帳號前綴@公眾號微信號，帳號前綴最多10個字符，必須是英文、數字字符或者下劃線，后綴為公眾號微信號，長度不超過30個字符
nickname	客服昵稱，最長16個字

返回說明

1 2 3 4 5

返回數據示例（正確時的JSON返回結果）：  {     "errcode" : 0,     "errmsg" : "ok"  }

主要返回碼

返回碼	說明
0	成功
65400	API不可用，即沒有開通/升級到新客服功能
65403	客服昵稱不合法
65404	客服帳號不合法
65405	帳號數目已達到上限，不能繼續(xù)添加
65406	已經存在的客服帳號

邀請綁定客服帳號

新添加的客服帳號是不能直接使用的，只有客服人員用微信號綁定了客服賬號后，方可登錄Web客服進行操作。此接口發(fā)起一個綁定邀請到客服人員微信號，客服人員需要在微信客戶端上用該微信號確認后帳號才可用。尚未綁定微信號的帳號可以進行綁定邀請操作，邀請未失效時不能對該帳號進行再次綁定微信號邀請。

調用說明

1 2 3 4 5 6 7

http請求方式: POST https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN POST數據示例如下：  {     "kf_account" : "test1@test",     "invite_wx" : "test_kfwx"  }

參數說明

參數	說明
kf_account	完整客服帳號，格式為：帳號前綴@公眾號微信號
invite_wx	接收綁定邀請的客服微信號

返回說明

1 2 3 4 5

返回數據示例（正確時的JSON返回結果）：  {     "errcode" : 0,     "errmsg" : "ok"  }

主要返回碼

返回碼	說明
0	成功
65400	API不可用，即沒有開通/升級到新版客服
65401	無效客服帳號
65407	邀請對象已經是本公眾號客服
65408	本公眾號已發(fā)送邀請給該微信號
65409	無效的微信號
65410	邀請對象綁定公眾號客服數量達到上限（目前每個微信號最多可以綁定5個公眾號客服帳號）
65411	該帳號已經有一個等待確認的邀請，不能重復邀請
65412	該帳號已經綁定微信號，不能進行邀請

設置客服信息

調用說明

1 2 3 4 5 6 7

http請求方式: POST https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN POST數據示例如下：  {     "kf_account" : "test1@test",     "nickname" : "客服1"  }

參數說明

參數	說明
kf_account	完整客服帳號，格式為：帳號前綴@公眾號微信號
nickname	客服昵稱，最長16個字

返回說明

1 2 3 4 5

返回數據示例（正確時的JSON返回結果）：  {     "errcode" : 0,     "errmsg" : "ok"  }

主要返回碼

返回碼	說明
0	成功
65400	API不可用，即沒有開通/升級到新版客服功能
65401	無效客服帳號
65403	客服昵稱不合法

上傳客服頭像

調用說明

1 2 3 4 5

http請求方式: POST/FORM https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT   調用示例（使用curl命令，用FORM表單方式上傳一個多媒體文件）： curl -F media=@test.jpg "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT"

參數說明

參數	說明
kf_account	完整客服帳號，格式為：帳號前綴@公眾號微信號
media	form-data 中媒體文件標識，有filename、filelength、content-type 等信息，文件大小為5M 以內

返回說明12345返回數據示例（正確時的JSON返回結果）： {    "errcode" : 0,    "errmsg" : "ok" }主要返回碼返回碼說明0成功65400API不可用，即沒有開通/升級到新版客服功能65401無效客服帳號65403客服昵稱不合法40005不支持的媒體類型40009媒體文件長度不合法刪除客服帳號調用說明12http請求方式: GEThttps://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT參數說明參數說明kf_account完整客服帳號，格式為：帳號前綴@公眾號微信號返回說明

1 2 3 4 5

返回數據示例（正確時的JSON返回結果）：  {     "errcode" : 0,     "errmsg" : "ok"  }

主要返回碼

返回碼	說明
0	成功
65400	API不可用，即沒有開通/升級到新版客服功能
65401	無效客服帳號

客服管理接口返回碼說明

返回碼	說明
0	成功
65400	API不可用，即沒有開通/升級到新版客服功能
65401	無效客服帳號
65403	客服昵稱不合法
65404	客服帳號不合法
65405	帳號數目已達到上限，不能繼續(xù)添加
65406	已經存在的客服帳號
65407	邀請對象已經是該公眾號客服
65408	本公眾號已經有一個邀請給該微信
65409	無效的微信號
65410	邀請對象綁定公眾號客服數達到上限（目前每個微信號可以綁定5個公眾號客服帳號）
65411	該帳號已經有一個等待確認的邀請，不能重復邀請
65412	該帳號已經綁定微信號，不能進行邀請
40005	不支持的媒體類型
40009	媒體文件長度不合法