微信客服管理


客服管理

1475199575177944.jpg




取得客服基本資訊
呼叫說明
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.
##"kf_headimgurl" : "http://mmbiz.##"kf_headimgurl" : "http://mmbiz.##"kf_headimgurl" : 0FD3vN0V8PILcibEGb2fPfEOmw /0",
          "kf_id" : "1001",
# " : "ntest1",
#          
"kf_wx" : "kfwx1"
o  : ,
       {
          "kf_account"       "kf_account"       
"kf_account" test: #          
"kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnqpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnqpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnqpic.cn/mmbiz/4whpV1VZl2iccsvYbHvn
"kf_id" : "1002",
          
          #"kf_nick" : "ntest2",
#######
          #"kf_wx" : "kfwx2"
卷# #       {
          
 ##"kf_headimgurl" : "http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEO#m0GSaLic0FD3vN0V8PILcibEGb2fPfEO#10 "kf_id" : " 1003 ",
          "kf_nick" : "ntest3",# 
#  : "kfwx3",
          
"invite_expire_time" : 123456789, 
##> : 「等待」＃＃＃＃＃＃＃＃＃＃＃ ＃  }
#

參數說明

參數#說明
kf_account 完整客服帳號，格式為：帳號前綴@公眾號微訊號
#kf_nick客服暱稱
## kf_id

###客服編號###
kf_headimgurl客服頭像
kf_wx

如果客服帳號已綁定了客服人員微訊號，

則此處顯示微訊號

#invite_wx

如果客服帳號尚未綁定微訊號，但已經發起了一個綁定邀請，

則此處顯示綁定邀請的微訊號

invite_expire_time

如果客服帳號尚未綁定微訊號，但已經發起過一個綁定邀請，

邀請的過期時間，為unix 時間戳

invite_status

邀請的狀態，有等待確認“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": [
###       ######{############      "######: ######"test1@test"######, ######
           #"狀態": 1, 
       #: "1001"##,            #"accepted_case"
##: 
#       },
       {"kf_account"
: "test2@test", 
           
#Hhehe白票“狀態”： 1， 
           “kf_id”： “1002”, 
           "accepted_case": 2##  #  
}
   
]
#}

參數說明

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

新增客服帳號

#呼叫說明

4
#1
2
3
5##6
#7
http要求方式: POST
#https://api.weixin.qq.com/customservice/kfaccount/ add?access_token=ACCESS_TOKENPOST資料範例如下：
 ##{
#    "kf_account" : "test1@test",
    "nickname" : "客服1"
#########"nickname" : "客服1"##### ####### ######}###################

參數說明

#
参数说明
kf_account完整客服帐号，格式为：帐号前缀@公众号微信号，帐号前缀最多10个字符，必须是英文、数字字符或者下划线，后缀为公众号微信号，长度不超过30个字符
nickname客服昵称，最长16个字

傳回說明

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

主要回傳碼

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

邀請綁定客服帳號

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

呼叫說明

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

主要回傳碼

API不可用，即沒有開啟/升級到新版客服無效客服帳號###### ######65407######邀請物件已經是本公眾號客服#######
回傳碼說明
#0成功
##65400
65401
65408本公眾號已發送邀請給該微訊號
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_TOKENPOST資料範例如下：
# ##{
############################## ######"kf_account" : "test1@test",#############    ######"nickname" : "客服1"############"nickname" : "客服1"######## #### ######}###################

參數說明

#
参数说明
kf_account完整客服帐号，格式为：帐号前缀@公众号微信号
nickname客服昵称，最长16个字

傳回說明

#

主要回傳碼

#1
2
##3
#4
5
傳回資料範例（正確時的JSON回傳結果）：
{
    #"errcode" : 0,
#    "errmsg" : "ok"
 }
API不可用，即沒有開啟/升級到新版客服帳號無效客服帳號
回傳碼說明
#0成功
##65400
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 完整客服帳號，格式為：帳號前綴@公眾號微訊號
mediaform-data 中媒體檔案標識，有filename、filelength、content -type 等信息，檔案大小為5M 以內
#


返回說明12345回傳資料範例（正確時的JSON回傳結果）： {    "errcode" : 0,    "errmsg" : "ok" }主要回傳碼回傳碼說明0成功65400API不可用成功65400API不可用成功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成功
65400API不可用，即没有开通/升级到新版客服功能
65401无效客服帐号


#客服管理介面回傳碼說明

API不可用，即沒有開啟/升級到新版客服帳號無效客服帳號##### #######65403######客服暱稱不合法#######
回傳碼說明
#0成功
##65400
65401
65404客服帳號不合法
#65405帳號數目已達到上限，無法繼續加上
65406已經存在的客服帳號
65407

邀請已經是該對公號客服

65408

本公眾號已經有一個邀請給該微信

65409無效的微訊號
65410邀請物件綁定公眾號客服數達到上限（目前每個微訊號可以綁定5個公眾號客服帳號）
#65411該帳號已經有一個等待確認的邀請，不能重複邀請
65412該帳號已經綁定微訊號，不能進行邀請
40005#不支援的媒體類型
40009媒體檔案長度不合法


←
→

PHP中文網

首頁首頁課程課程文章文章問答問答詞典詞典手册手册下載下載搜尋搜尋APP下載 APP下載