微信會話控制


會話控制

201610171124143832.png

#建立會話

#此介面在客服和使用者之間建立一個會話，如果該客服和使用者會話已存在，則直接傳回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成功
65400API不可用，即沒有開通/升級到新版客服功能
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#成功
65400API不可用，即沒有開啟或升級到新版客服功能
指定的客服不在線
#不存在的openid
########################################################################################################### ########