위챗 고객 서비스 관리


고객 서비스 관리

1475199575177944.jpg


기본 고객 서비스 정보 받기

통화 안내

1
2
<코드 class= "html plain">http 요청 방법: GEThttp请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN
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.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"
       }
    ]
 }

매개변수 설명

고객 서비스 계정이 고객 서비스 직원의 WeChat ID 고객 서비스 계정이 아직 WeChat ID에 바인딩되지 않았지만 바인딩 초대가 시작된 경우 The 바인딩된 초대의 WeChat ID가 여기에 표시됩니다. Signal고객 서비스 계정인 경우 WeChat ID에 바인딩되지 않았지만 바인딩이 시작되었습니다. 초대, 초대 만료 시간은 유닉스 타임스탬프 #🎜 🎜#초대 상태에는 확인을 기다리는 '대기 중', 거부되는 '거부됨',
Parameter Description
kf_account 형식은 다음과 같습니다. 계정 접두사 @공식 계정 WeChat ID
kf_nick고객 서비스 닉네임
kf_id

고객센터 전화번호

kf_headimgurl고객 서비스 아바타
kf_wx#🎜 🎜## 🎜 🎜#

, WeChat ID

#🎜🎜에 바인딩된 경우 ##🎜 🎜#invite_wx

invite_expire_time

invite_status
expired "만료됨" #🎜이 포함됩니다. 🎜#

#🎜🎜 #


기본 고객 서비스 정보 얻기

통화 지침

1
2
요청 방법: GET< / 코드>http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN
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
< code class="php plain">데이터 반환 예시(올바른 경우 JSON 반환 결과):
{
# 🎜🎜# "kf_online_list": [#🎜 🎜 #返回数据示例(正确时的JSON返回结果):
{
   "kf_online_list": [
       {
           "kf_account""test1@test"{
#🎜🎜# < /code>"kf_account": "test1@test" 코드>, #🎜🎜#
           "status": 1, 
           "kf_id""1001"
           "accepted_case": 1
       },
       {
           "kf_account""test2@test"
           "status": 1, 
           "kf_id""1002"
           "accepted_case": 2
       }
   ]
}

매개변수 설명

#🎜 🎜 #전체 고객 서비스 계정, 형식은 다음과 같습니다. 계정 접두어@공개 계정 WeChat IDstatus고객 서비스 온라인 상태, 현재: 1 .웹 온라인kf_id고객 서비스 번호accepted_case#🎜 🎜## 🎜🎜#현재 고객 서비스에서 받고 있는 세션 수

고객 서비스 계정 추가

통화 지침

ParameterDescription
kf_account
POST 데이터 예시는 다음과 같습니다:
1
2
3
4
5
6
7
<코드클래스 = "html plain">http 요청 방법: POSThttp请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN
POST数据示例如下:
 {
    "kf_account" : "test1@test",
    "nickname" : "客服1"
 }
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN
{🎜 🎜 "kf_account" : "test1@test",🎜🎜 code>"nickname" : "고객 서비스 1"🎜🎜 }🎜🎜🎜🎜🎜

매개변수 설명

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

반품 지침

"errmsg" : < /code>"확인"
1
2#🎜 🎜#
3
4
5
데이터 반환 예(올바른 JSON 반환 결과):
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 } {# 🎜🎜#
"errcode" : 0, code>
} #🎜🎜##🎜🎜##🎜🎜##🎜🎜##🎜🎜#

기본 반환 코드

#🎜 🎜#成65400API를 사용할 수 없습니다. 즉, 새로운 고객 서비스 기능으로 활성화/업그레이드되지 않았습니다.# 🎜🎜#65403고객센터 닉네임이 불법입니다65404#🎜 🎜# 고객센터 계정이 불법입니다# 🎜🎜#

고객 서비스 계정 연결 초대

새로 추가된 고객 서비스 계정은 다음과 같습니다. 직접 사용 예, 고객 서비스 담당자가 고객 서비스 계정을 WeChat ID와 연결한 후에만 웹 고객 서비스에 로그인하여 작업을 수행할 수 있습니다. 이 인터페이스는 고객 서비스 직원의 WeChat ID에 대한 바인딩 초대를 시작합니다. 고객 서비스 직원은 계정을 사용하기 전에 WeChat 클라이언트에서 WeChat ID를 확인해야 합니다. WeChat ID에 바인딩되지 않은 계정은 초대 작업에 바인딩될 수 있습니다. 초대가 만료되지 않은 경우 계정을 WeChat ID에 바인딩하여 다시 초대할 수 없습니다.

전화 안내

반환 코드설명
0
# 🎜🎜#
65405계정 수가 최대 한도에 도달하여 더 이상 추가할 수 없습니다
65406# 🎜🎜##🎜🎜 #이미 존재하는 고객 서비스 계정
http 요청 방법: POST
1
#🎜 🎜 #2
3
4
5
6
7#🎜🎜 #
https: //api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKENhttp请求方式: 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接收绑定邀请的客服微信号

반품 지침

"errmsg" : < /code>"확인"
1
2#🎜 🎜#
3
4
5
데이터 반환 예(올바른 JSON 반환 결과):
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 } {# 🎜🎜#
"errcode" : 0, code>
} #🎜🎜##🎜🎜##🎜🎜##🎜🎜##🎜🎜#

기본 반환 코드

로 활성화/업그레이드되지 않았습니다.
반환 코드Explanation
0Success
65400API를 사용할 수 없습니다. 즉, 새 버전의 고객 서비스
65401 잘못된 고객 서비스 계정
65407초대 대상자는 이미 이 공식 계정의 고객 서비스 계정입니다
65408이 공식 계정에서 해당 WeChat ID로 초대장을 보냈습니다
65409잘못된 WeChat ID
65410공식 계정 고객센터에 바인딩된 초대 개체 수가 상한에 도달했습니다. (현재 WeChat ID당 최대 5개의 공용 계정 고객 서비스 계정을 바인딩할 수 있습니다.)
65411이 계정에는 이미 확인 대기 중인 초대장이 있으므로 다시 초대할 수 없습니다
65412이 계정은 다음과 같습니다. 위챗 아이디에 묶여 있어서 초대받을 수 없습니다

고객 서비스 정보 설정

통화 안내 ### ## ## ## ## ## ## #####1##########3########## # 4

56 "nickname" : "고객 서비스 1 "

매개변수 설명

7
http 요청 방법: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token= ACCESS_TOKEN
POST 데이터 예시는 다음과 같습니다:
{
"kf_account " : " test1@test",
}http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN
POST数据示例如下:
 {
    "kf_account" : "test1@test",
    "nickname" : "客服1"
 }
#🎜 🎜##🎜 🎜#
参数说明
kf_account完整客服帐号,格式为:帐号前缀@公众号微信号
nickname客服昵称,最长16个字
######반품 지침### ## ## ## ## ## ## ## ## ###1###### #2

3
4

5
데이터 반환 예(올바른 경우 JSON 반환 결과):
{
"errcode" : 0,
"errmsg" : "확인"
}
返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }

기본 반환 코드

#🎜 🎜#成65400API를 사용할 수 없습니다. 즉, 고객의 새 버전으로 활성화/업그레이드되지 않았습니다. 서비스 함수### ## ## ## ####65401#🎜🎜 ## 🎜🎜#잘못된 고객 서비스 계정#🎜🎜 ## ## ######65403#🎜 🎜#


고객 서비스 아바타 업로드

통화 지침

반환 코드설명
0
고객센터 닉네임은 불법입니다# 🎜 🎜#
1
2
3
4
5
http 요청 방법: POST/FORMhttp请求方式: 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"
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"🎜🎜🎜🎜🎜Parameter description eterParameter

description

KF_ACCOUNT


반환 설명 12345 반환 데이터 예(올바른 JSON 반환 결과): { "errcode" : 0, "errmsg" : "ok" } 기본 반환 코드 반환 코드 설명 0 성공 65400 API를 사용할 수 없습니다. 활성화/업그레이드되지 않았습니다. 고객 서비스 기능의 새 버전으로 65401 잘못된 고객 서비스 계정 65403 잘못된 고객 서비스 별명 40005 지원되지 않는 미디어 유형 40009 잘못된 미디어 파일 길이 고객 서비스 계정 호출 지침 삭제 12 http 요청 방법: GET https://api. weixin.qq.com/customservice/kfaccount/ del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT 매개변수 설명 매개변수 설명 kf_account 전체 고객 서비스 계정, 형식은 다음과 같습니다. 계정 접두어 @ 공식 계정 WeChat ID 반환 지침
FULL 고객 서비스 계정, 형식은 다음과 같습니다. 계정 접두사 @Official 계정 weChat id id id id idmedia idaform-data 파일 식별자, 파일 이름, 파일 길이, 콘텐츠 유형 및 기타 정보가 있으며 파일 크기는 5M 이내입니다
"errcode": 0,
1
2
3
4
5
데이터 반환 예시(정확한 경우 JSON 반환 결과):返回数据示例(正确时的JSON返回结果):
 {
    "errcode" : 0,
    "errmsg" "ok"
 }
{
"errmsg" : "확인"🎜🎜 }🎜🎜🎜🎜🎜

기본 반환 코드

返回码

说明

0成功
65400API不可用,即没有开通/升级到新版客服功能
65401无效客服帐号


고객 서비스 관리 인터페이스 반환 코드 설명

반환 코드Explanation
0Success
65400API를 사용할 수 없습니다. 즉, 새 버전의 고객 서비스 기능이 활성화/업그레이드되지 않았습니다
65401 잘못된 고객 서비스 계정
65403고객 서비스 닉네임이 불법입니다
65404고객 서비스 계정이 불법입니다
65405계정 수가 최대 한도에 도달하여 더 이상 추가할 수 없습니다
65406이미 기존 고객 서비스 계정
654 07

초대받은 사람은 이미 공식 계정 고객 서비스

65408

이 공식 계정에는 이미 이 WeChat 계정에 대한 초대장이 있습니다

65409잘못된 WeChat ID
65410초대 대상자와 연결된 공식 고객 서비스 계정 수가 상한에 도달했습니다. (현재 각 WeChat ID는 5개의 공식 고객 서비스 계정에 바인딩될 수 있습니다.)
65411 이 계정에는 이미 확인 대기 중인 초대장이 있으므로 다시 초대할 수 없습니다.
65412이 계정은 WeChat ID에 바인딩되어 있으므로 초대할 수 없습니다
40005지원되지 않는 미디어 유형
40009 미디어 파일 길이가 불법입니다