閱讀(17.4k) 書簽贊(0) 我要糾錯(cuò)

微信客服管理

2019-03-14 12:03 更新

客服管理

企業(yè)客服

獲取客服基本信息

調(diào)用說明

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

返回說明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{

"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"

}

]

}

參數(shù)說明

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

獲取客服基本信息

調(diào)用說明

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

返回說明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{

"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

}

]

}

參數(shù)說明

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

添加客服帳號(hào)

調(diào)用說明

http請(qǐng)求方式: POST

https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN

POST數(shù)據(jù)示例如下：

{

"kf_account" : "test1@test",

"nickname" : "客服1"

}

參數(shù)說明

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

返回說明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{

"errcode" : 0,

"errmsg" : "ok"

}

主要返回碼

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

邀請(qǐng)綁定客服帳號(hào)

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

調(diào)用說明

http請(qǐng)求方式: POST

https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN

POST數(shù)據(jù)示例如下：

{

"kf_account" : "test1@test",

"invite_wx" : "test_kfwx"

}

參數(shù)說明

參數(shù)	說明
kf_account	完整客服帳號(hào)，格式為：帳號(hào)前綴@公眾號(hào)微信號(hào)
invite_wx	接收綁定邀請(qǐng)的客服微信號(hào)

返回說明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{

"errcode" : 0,

"errmsg" : "ok"

}

主要返回碼

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

設(shè)置客服信息

調(diào)用說明

http請(qǐng)求方式: POST

https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN

POST數(shù)據(jù)示例如下：

{

"kf_account" : "test1@test",

"nickname" : "客服1"

}

參數(shù)說明

參數(shù)	說明
kf_account	完整客服帳號(hào)，格式為：帳號(hào)前綴@公眾號(hào)微信號(hào)
nickname	客服昵稱，最長(zhǎng)16個(gè)字

返回說明

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{

"errcode" : 0,

"errmsg" : "ok"

}

主要返回碼

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

上傳客服頭像

調(diào)用說明

http請(qǐng)求方式: POST/FORM

https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT

調(diào)用示例（使用curl命令，用FORM表單方式上傳一個(gè)多媒體文件）：

curl -F media=@test.jpg "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT"

參數(shù)說明

參數(shù)	說明
kf_account	完整客服帳號(hào)，格式為：帳號(hào)前綴@公眾號(hào)微信號(hào)
media	form-data 中媒體文件標(biāo)識(shí)，有filename、filelength、content-type 等信息，文件大小為5M 以內(nèi)

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

返回?cái)?shù)據(jù)示例（正確時(shí)的JSON返回結(jié)果）：

{

"errcode" : 0,

"errmsg" : "ok"

}

主要返回碼

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

客服管理接口返回碼說明

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

以上內(nèi)容是否對(duì)您有幫助：

← 將消息轉(zhuǎn)發(fā)到微信客服

微信會(huì)話控制 →

寫筆記

我要補(bǔ)充