위챗 세션 제어
Session Control
Create Session
이 인터페이스는 고객 서비스와 사용자 세션이 이미 존재하는 경우 0을 직접 반환합니다. 지정된 고객 서비스 계정은 WeChat ID와 온라인에 연결되어 있어야 합니다.
통화 지침
1 2 3 4 5 6 7 | http 요청 방법: POST code> https://api.weixin.qq.com/customservice/kfsession/create?access_token=ACCESS_TOKEN POST数据示例如下: { "kf_account" : "test1@test", "openid" : "OPENID" } |
参数说明
参数 | 说明 |
kf_account | 完整客服帐号,格式为:帐号前缀@公众号微信号 |
openid | 粉丝的openid |
返回说明
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>🎜🎜
}
🎜🎜🎜🎜🎜
세션 종료
전화 안내
1234567 http 요청 방법: POST
http请求方式: POST
https:
//api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
POST数据示例如下:
{
"kf_account"
:
"test1@test"
,
"openid"
:
"OPENID"
}
参数说明
参数 说明 kf_account 完整客服帐号,格式为:帐号前缀@公众号微信号 openid 粉丝的openid
返回说明
12345 返回数据示例(正确时的JSON返回结果):
{
"errcode"
: 0,
"errmsg"
:
"ok"
}
https:
//api.weixin.qq.com/customservice/kfsession/close?access_token=ACCESS_TOKEN
POST 데이터 예는 다음과 같습니다:
{
"kf_account " code> :
"test1@test"
,
"openid" code> < code>:
"OPENID"
}
매개변수 설명 Parameter Instructions kf_account 전체 고객 서비스 계정, 형식은 다음과 같습니다. account prefix@official account WeChat ID openid fan's openid 반환 지침 1 23 4 5
🎜반환 데이터 예(정확한 경우 JSON 반환 결과):
🎜🎜
{< /code> 🎜🎜
"errcode"
: 0,
🎜🎜
"errmsg"
:
"확인"
🎜🎜
}
🎜🎜🎜🎜🎜🎜기본 반환 코드🎜🎜🎜🎜🎜 🎜반환 코드 🎜🎜Explanation🎜🎜🎜🎜0🎜🎜Success🎜🎜🎜🎜65400🎜🎜API를 사용할 수 없습니다. 즉, 새 버전의 고객 서비스 기능이 활성화/업그레이드되지 않았습니다🎜🎜🎜🎜65401 🎜🎜잘못된 고객 서비스 계정🎜 🎜🎜🎜65402🎜🎜계정 WeChat ID가 바인딩되지 않아 사용할 수 없습니다🎜🎜🎜🎜65413🎜🎜사용자에 해당하는 세션 정보가 없습니다🎜🎜🎜🎜65414🎜🎜고객이 현재 사용 중입니다. 다른 고객센터에서 받았습니다🎜🎜🎜🎜40003🎜🎜불법 openid🎜🎜 🎜🎜고객 세션 상태 가져오기
이 인터페이스는 고객의 세션을 가져옵니다. 존재하지 않는 경우 kf_account는 비어 있습니다.
통화 지침
12
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
매개변수 설명
매개변수 Description openid 팬의 오픈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는 을 반환합니다. 123 데이터 반환 예(올바른 JSON 반환 결과인 경우):
{
"세션 목록"
: [
{
" createtime"
: 123456789,
"openid"
:
"OPENID"< /code>
},
{
"createtime"
: 123456789, code>
"openid"
:
"OPENID"
}
]
}
返回数据示例(正确时的JSON返回结果):
{
"sessionlist"
: [
{
"createtime"
: 123456789,
"openid"
:
"OPENID"
},
{
"createtime"
: 123456789,
"openid"
:
"OPENID"
}
]
}
获取未接入会话列表
调用说明
12 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
🎜🎜🎜🎜🎜반품 지침
12#🎜 🎜#345678#🎜 🎜#910111213#🎜 🎜 #14데이터 반환 예시(정확한 경우 JSON 반환 결과):
code >{
返回数据示例(正确时的JSON返回结果):
{
"count"
: 150,
"waitcaselist"
: [
{
"latest_time"
: 123456789,
"openid"
:
"OPENID"
},
{
"latest_time"
: 123456789,
"openid"
:
"OPENID"
}
]
}
"count"
: 150,
# 🎜 🎜#
"대기자 목록"
: [
{ code >
"최근_시간"
: 123456789,
코드>"openid"
:
"OPENID"
} ,
{
"최신_시간"< /code> 코드> : 123456789,
"openid"
:
"OPENID "
}
]
}
#🎜🎜 #매개변수 설명 Parameters Description # 🎜🎜# count 연결되지 않은 세션 수
#🎜🎜#waitcaselist#🎜🎜##🎜🎜#연결되지 않은 세션 목록, 최대 100개 반환 데이터 수, 방문 순#🎜🎜##🎜🎜##🎜🎜##🎜🎜#openid#🎜🎜##🎜🎜#fans' openid#🎜🎜##🎜🎜##🎜🎜##🎜🎜 #latest_time# 🎜🎜##🎜🎜#팬들의 마지막 메시지 시간#🎜🎜##🎜🎜##🎜🎜##🎜🎜#반품 코드 설명
반품 코드 설명 0 Success 65400 API를 사용할 수 없습니다. 즉, 새 버전의 고객 서비스 기능이 활성화되거나 업그레이드되지 않았습니다. 65401 고객 서비스 계정이 잘못되었습니다 65402 고객 서비스 계정이 WeChat ID에 바인딩되지 않아 사용할 수 없습니다 65413 해당 계정에 대한 세션 정보가 없습니다. user 65414 다른 고객센터에서 팬을 받고 있습니다 65415 지정된 고객센터가 온라인이 아닙니다 40003 openid가 불법입니다