Pengurusan perkhidmatan pelanggan WeChat
Pengurusan Perkhidmatan Pelanggan
Dapatkan maklumat asas perkhidmatan pelanggan
1 | 2 http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN 🎜kaedah permintaan http: DAPATKAN🎜🎜https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN kod>🎜 |
Arahan pulangkan
Kembalikan contoh data (hasil pulangan JSON apabila betul):
1 2 3 3444 8 9 10111213141516171818 22232425 2627 | { "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"
}
]
}
|
Parameter Keterangan
Parameter | Penerangan |
kf_account | Akaun perkhidmatan pelanggan penuh, formatnya ialah: awalan akaun @akaun rasmi |
| Nama Panggilan Perkhidmatan Pelanggan |
kf_id | Nombor perkhidmatan pelanggan . |
jemput_wx | Jika akaun perkhidmatan pelanggan belum wujud lagi Ikat ID WeChat, tetapi jemputan mengikat telah dimulakan, | ID WeChat jemputan mengikat akan dipaparkan di sini
| invite_expire_time belum terikat dengan ID WeChat, tetapi jemputan yang mengikat telah dimulakan Untuk menentukan jemputan, masa tamat jemputan ialah cap waktu unix |
| status_jemputanstatus jemputan adalah "jemputan" untuk pengesahan, "rejected" kerana ditolak, expired "expired" |
|
Dapatkan maklumat asas perkhidmatan pelanggan
Arahan panggilan
1 1 | dalam">permintaan http Kaedah: GET< / code>https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getonlinekflist?access_token=ACCESS_TOKEN
|
Arahan pulangkan 10 11
1213 14151617Kembalikan contoh data (hasil pemulangan JSON apabila betul): { "kf_online_list" : [ { "kf_account" : "test1@test" , "status" : 1,
"kf_id" : "1001" ,
"accepted_case" : 1
},
{
"kf_account" : "test2@test" ,
"status" : 1,
"kf_id" : "1002" ,
"accepted_case" : 2
}
]
}
|
Penerangan parameter
. kf_id | Nombor perkhidmatan pelanggan |
kes_terima | Bilangan sesi yang sedang diterima oleh perkhidmatan pelanggan |
Tambah akaun perkhidmatan pelanggan
Arahan panggilan 1 2 6 7 | kaedah permintaan http: POSThttps://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN
POST数据示例如下:
{
"kf_account" : "test1@test",
"nickname" : "客服1"
}
Contoh data POST adalah seperti berikut: | { kod>
"kf_account" : "test1@test", 🎜🎜 code>"nickname" : "Customer Service 1" 🎜🎜 kod kod>🎜🎜🎜🎜🎜Penerangan parameter
参数 | 说明 | kf_account | 完整客服帐号,格式为:帐号前缀@公众号微信号,帐号前缀最多10个字符,必须是英文、数字字符或者下划线,后缀为公众号微信号,长度不超过30个字符 | nickname | 客服昵称,最长16个字 |
Arahan pengembalian 1 2 3 4 5 | 1返回数据示例(正确时的JSON返回结果): {
"errcode" : 0,
"errmsg" : "ok"
} 2 | 3 4🎜🎜5🎜🎜🎜🎜 dalam kelas 🎜🎜 { 🎜🎜 "errcode" : 0, 🎜🎜 "errmsg" : "ok" 🎜🎜 } 🎜🎜🎜🎜🎜Kod Pemulangan Utama
Kod pemulangan | Penjelasan | 0 | Success | 65400 | API tidak tersedia, iaitu | d fungsi perkhidmatan pelanggan tidak tersedia, iaitu d. 65403 | Pelanggan nama panggilan perkhidmatan adalah haram | 65404 | Akaun perkhidmatan pelanggan adalah haram | 65405 | Jumlah akaun telah mencapai had atas dan tiada lagi penambahan boleh dibuat | 65406 | Akaun perkhidmatan pelanggan sedia ada |
Jemputan untuk mengikat akaun perkhidmatan pelanggan Akaun perkhidmatan pelanggan yang baru ditambah tidak boleh digunakan secara langsung Hanya selepas kakitangan perkhidmatan pelanggan mengikat akaun perkhidmatan pelanggan menggunakan ID WeChat, mereka boleh log masuk ke pelanggan Web perkhidmatan untuk operasi. Antara muka ini memulakan jemputan terikat kepada ID WeChat kakitangan perkhidmatan pelanggan Kakitangan perkhidmatan pelanggan perlu mengesahkan dengan ID WeChat pada klien WeChat sebelum akaun boleh digunakan. Akaun yang belum terikat dengan ID WeChat boleh terikat dengan operasi jemputan Jika jemputan belum tamat tempoh, akaun itu tidak boleh terikat dengan ID WeChat untuk dijemput semula. Arahan panggilan ">Permintaan http Kaedah: POST< /code> https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN POST数据示例如下:
{
"kf_account" : "test1@test",
"invite_wx" : "test_kfwx"
}
|
Penerangan parameter
参数 | 说明 |
kf_account | 完整客服帐号,格式为:帐号前缀@公众号微信号 |
invite_wx | 接收绑定邀请的客服微信号 |
Arahan pengembalian
1 2 3 4 5 | 1返回数据示例(正确时的JSON返回结果): {
"errcode" : 0,
"errmsg" : "ok"
} 2 |
3
4🎜🎜5🎜🎜🎜🎜 dalam kelas 🎜🎜
{
🎜🎜
"errcode"
: 0,
🎜🎜
"errmsg"
:
"ok"
🎜🎜
}
🎜🎜🎜🎜🎜Kod Pemulangan Utama
Pulangan kod | Penjelasan |
0 | Sukses |
65400 | API belum tersedia, iaitu versi baharu perkhidmatan pelanggan belum diaktifkan/diaktifkan |
65401 Akaun perkhidmatan pelanggan tidak sah | |
65407Penjemputan sudah pun menjadi perkhidmatan pelanggan akaun rasmi ini | . (pada masa ini bilangan maksimum setiap ID WeChat Boleh mengikat 5 akaun perkhidmatan pelanggan akaun awam) |
| 65411 |
Akaun ini sudah mempunyai jemputan menunggu pengesahan dan tidak boleh dijemput lagi | | 65412
Akaun ini telah dibuat terikat kepada ID WeChat dan tidak boleh dijemput | . 6 7Kaedah permintaan http: POST https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN contoh data POST adalah seperti berikut: { "kf_account" : "test1@test", "nickname" : "Customer Service 1" } Penerangan parameter
参数 | 说明 | kf_account | 完整客服帐号,格式为:帐号前缀@公众号微信号 | nickname | 客服昵称,最长16个字 |
Arahan pulangkan /code> {
"errcode" : 0,
"errmsg" : "ok" } Kod Pemulangan Utama
Pulangan kod | Penjelasan | 0 | Success | 65400 | API tidak tersedia, iaitu, versi baharu activated/fungsi pelanggan tidak tersedia | 65401 Akaun perkhidmatan pelanggan tidak sah | | 65403Nama panggilan perkhidmatan pelanggan adalah haram | |
Muat naik avatar perkhidmatan pelanggan Arahan panggilan 1 1 5Kaedah permintaan http: POST/FORM | https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT 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"
| Contoh panggilan (gunakan perintah curl untuk memuat naik fail multimedia menggunakan borang FORM): curl -F media= @test.jpg "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT" 🎜🎜🎜🎜Perihalan Parameter pengecam fail data borang, Terdapat nama fail, panjang fail, jenis kandungan dan maklumat lain, dan saiz fail dalam lingkungan 5M
Kembali perihalan 12345 Kembalikan contoh data (hasil pemulangan JSON yang betul): { "errcode" : 0, "errmsg" : "ok" } Kod pulangan utama Perihalan kod pulangan 0 Success 65400 API tidak tersedia, iaitu, ia mempunyai tidak diaktifkan/dinaik taraf Kepada versi baharu fungsi perkhidmatan pelanggan 65401 Akaun perkhidmatan pelanggan tidak sah 65403 Nama panggilan perkhidmatan pelanggan yang tidak sah 40005 Jenis media tidak disokong 40009 Panjang fail media yang tidak sah Padamkan arahan panggilan akaun perkhidmatan pelanggan 12 Kaedah permintaan http: DAPATKAN https://api. weixin.qq.com/customservice/kfaccount/ del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT perihalan parameter perihalan parameter kf_account akaun perkhidmatan pelanggan lengkap, formatnya ialah: awalan akaun @ akaun rasmi arahan pengembalian ID WeChat 1 345 | 返回数据示例(正确时的JSON返回结果): {
"errcode" : 0,
"errmsg" : "ok"
} Kembalikan contoh data (hasil pemulangan JSON apabila betul):
| { "errcode" : 0, 🎜 "errmsg" : "ok" 🎜🎜 } kod>🎜🎜🎜🎜🎜Kod Pemulangan Utama
返回码 | 说明 | 0 | 成功 | 65400 | API不可用,即没有开通/升级到新版客服功能 | 65401 | 无效客服帐号 |
Antara muka pengurusan perkhidmatan pelanggan perihalan kod pulangan Pulangan kod | Penjelasan | 0 | Success | 65400 | API tidak tersedia, iaitu, versi baharu activated/fungsi pelanggan tidak tersedia | 65401 Akaun perkhidmatan pelanggan tidak sah | | 65403Nama panggilan perkhidmatan pelanggan adalah haram | | 65404 | Akaun perkhidmatan pelanggan adalah tidak sah | 654 07 Penjemputan sudah pun menjadi Akaun rasmi perkhidmatan pelanggan | | 65408 | Akaun rasmi ini sudah mempunyai jemputan ke akaun WeChat ini | 65409 | ID WeChat tidak sah | 65410 | Bilangan akaun perkhidmatan pelanggan rasmi yang terikat kepada jemputan telah mencapai had atas (pada masa ini setiap akaun WeChat yang terikat kepada ID rasmi pelanggan | boleh terikat kepada ID WeChat5) 65411 | Akaun ini sudah mempunyai jemputan menunggu pengesahan dan tidak boleh dijemput lagi | 65412 | Akaun ini telah terikat dengan ID WeChat dan tidak boleh dijemput | 5 jenis media yang tidak dijemput | | | | 40009 Panjang fail media adalah haram
🎜🎜🎜
|
| |