위챗 세션 제어


Session Control

201610171124143832.png

Create Session

이 인터페이스는 고객 서비스와 사용자 세션이 이미 존재하는 경우 0을 직접 반환합니다. 지정된 고객 서비스 계정은 WeChat ID와 온라인에 연결되어 있어야 합니다.

통화 지침

1
2
3
4
5
6
7
http 요청 방법: POST  http请求方式: POST
 https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN
 POST数据示例如下:
 {
    "kf_account" : "test1@test",
    "openid" : "OPENID"
 }

参数说明

参数说明
kf_account完整客服帐号,格式为:帐号前缀@公众号微信号
openid粉丝的openid

返回说明

POST 데이터 예시는 다음과 같습니다:
1
2
3
4
5
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }
https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN
{🎜🎜 "kf_account" : "test1@test" ,< /code>🎜🎜 "openid" : "OPENID" 🎜🎜 }🎜🎜🎜🎜🎜 🎜매개변수 설명🎜🎜🎜🎜
매개변수🎜설명🎜🎜
kf_account🎜완전한 고객 서비스 계정, 형식은 다음과 같습니다: 계정 접두어 @ 공식 계정 WeChat ID 🎜🎜
반환 데이터 예(올바른 JSON 반환 결과): 🎜🎜 {🎜🎜 code>" errcode" : 0,🎜🎜 "errmsg" : < code>"확인"< /code>🎜🎜 }🎜🎜🎜🎜🎜


세션 종료

전화 안내

1
2
3
4
5
6
7
http 요청 방법: POSThttp请求方式: POST
 https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
 POST数据示例如下:
 {
    "kf_account" "test1@test",
    "openid" "OPENID"
 }

参数说明

参数说明
kf_account完整客服帐号,格式为:帐号前缀@公众号微信号
openid粉丝的openid

返回说明

POST 데이터 예는 다음과 같습니다:
1
2
3
4
5
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }
https://api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
{


"kf_account " : "test1@test",

"openid" < code>: "OPENID" }매개변수 설명ParameterInstructionskf_account전체 고객 서비스 계정, 형식은 다음과 같습니다. account prefix@official account WeChat IDopenidfan's openid1 2345
반환 지침
🎜반환 데이터 예(정확한 경우 JSON 반환 결과):🎜🎜 {< /code> 🎜🎜 "errcode" : 0,🎜🎜 "errmsg" : "확인"🎜🎜 }🎜🎜🎜🎜🎜🎜기본 반환 코드🎜🎜🎜🎜🎜 🎜반환 코드 🎜🎜Explanation🎜🎜🎜🎜0🎜🎜Success🎜🎜🎜🎜65400🎜🎜API를 사용할 수 없습니다. 즉, 새 버전의 고객 서비스 기능이 활성화/업그레이드되지 않았습니다🎜🎜🎜🎜65401 🎜🎜잘못된 고객 서비스 계정🎜 🎜🎜🎜65402🎜🎜계정 WeChat ID가 바인딩되지 않아 사용할 수 없습니다🎜🎜🎜🎜65413🎜🎜사용자에 해당하는 세션 정보가 없습니다🎜🎜🎜🎜65414🎜🎜고객이 현재 사용 중입니다. 다른 고객센터에서 받았습니다🎜🎜🎜🎜40003🎜🎜불법 openid🎜🎜 🎜🎜

고객 세션 상태 가져오기

이 인터페이스는 고객의 세션을 가져옵니다. 존재하지 않는 경우 kf_account는 비어 있습니다.

통화 지침

1
2
http 요청 방법: GET http请求方式: GET
https://api.weixin.qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID
https://api.weixin. qq.com/customservice/kfsession/getsession?access_token=ACCESS_TOKEN&openid=OPENID


매개변수 설명

매개변수Descriptionopenid팬의 오픈ID
🎜

반환 지침

12345 반환 데이터 예(올바른 JSON 반환 결과): { "createtime" : 123456789, "kf_account" : "test1@test" } 매개변수 설명 매개변수 설명 kf_account가 고객 서비스를 받고 있으며, 비어 있으면 아무도 없음을 의미합니다. createtime 세션 액세스 수신 시 반환 코드 반환 코드 설명 0 성공 65400 API를 사용할 수 없습니다. 즉, 새 버전의 고객 서비스 기능으로 활성화/업그레이드되지 않았습니다. 40003 잘못된 openid 고객 서비스 세션 목록 가져오기 호출 설명 12 http 요청 방법 : GET https://api.weixin.qq.com/customservice/kfsession/getsessionlist?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT 매개변수 설명 매개변수 설명 kf_account 완전한 고객 서비스 계정, 형식은 다음과 같습니다. 계정 접두사 @공식 계정 WeChat ID는 을 반환합니다. ]
1
2
3 데이터 반환 예(올바른 JSON 반환 결과인 경우):
{
"세션 목록" : [
{
" createtime" : 123456789,
"openid" : "OPENID"< /code>
},
{
"createtime" : 123456789,
"openid" : "OPENID"
}
} 返回数据示例(正确时的JSON返回结果):
 {
    "sessionlist" : [
       {
          "createtime" : 123456789,
          "openid" "OPENID"
       },
       {
          "createtime" : 123456789,
          "openid" "OPENID"
       }
    ]
 }

获取未接入会话列表

调用说明

1
2
http请求方式: GET
https://api.weixin.qq.com/customservice/kfsession/getwaitcase?access_token=ACCESS_TOKEN
연결되지 않음 세션 목록🎜🎜통화 지침🎜🎜🎜🎜🎜🎜1🎜🎜2🎜🎜🎜🎜http 요청 방법: GET🎜🎜https://api.weixin.qq.com/customservice /kfsession/getwaitcase?access_token=ACCESS_TOKEN🎜🎜🎜🎜🎜

반품 지침

{
1
2
#🎜 🎜#3
4
5
6
7
8#🎜 🎜#
9
10
11
12
13
#🎜 🎜 #14
데이터 반환 예시(정확한 경우 JSON 반환 결과):
{
返回数据示例(正确时的JSON返回结果):
 {
    "count" : 150,
    "waitcaselist" : [
       {
          "latest_time" : 123456789,
          "openid" "OPENID"
       },
       {
          "latest_time" : 123456789,
          "openid" "OPENID"
       }
    ]
 } "count" : 150,
# 🎜 🎜# "대기자 목록" : [
"최근_시간" : 123456789,


코드>"openid" : "OPENID"

} , { "최신_시간"< /code> 코드> : 123456789, "openid" : "OPENID " } ] }Description# 🎜🎜# count연결되지 않은 세션 수
#🎜🎜 #매개변수 설명
Parameters
#🎜🎜#waitcaselist#🎜🎜##🎜🎜#연결되지 않은 세션 목록, 최대 100개 반환 데이터 수, 방문 순#🎜🎜##🎜🎜##🎜🎜##🎜🎜#openid#🎜🎜##🎜🎜#fans' openid#🎜🎜##🎜🎜##🎜🎜##🎜🎜 #latest_time# 🎜🎜##🎜🎜#팬들의 마지막 메시지 시간#🎜🎜##🎜🎜##🎜🎜##🎜🎜#

반품 코드 설명

반품 코드 설명
0Success
65400API를 사용할 수 없습니다. 즉, 새 버전의 고객 서비스 기능이 활성화되거나 업그레이드되지 않았습니다.
65401고객 서비스 계정이 잘못되었습니다
65402고객 서비스 계정이 WeChat ID에 바인딩되지 않아 사용할 수 없습니다
65413해당 계정에 대한 세션 정보가 없습니다. user
65414다른 고객센터에서 팬을 받고 있습니다
65415지정된 고객센터가 온라인이 아닙니다
40003openid가 불법입니다