Gestion du service client WeChat


Gestion du service client

1

2
Méthode de requête http : GET

1475199575177944.jpghttps://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

Instructions de retour

8
9

10

1112
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"
       }
    ]
 }

Description du paramètre

Paramètre Description
kf_accountCompte de service client complet, le format est : préfixe du compte @compte officiel WeChat ID
kf_nick Pseudo du service client
kf_id

Numéro du service client

kf_headimgurlAvatar du service client
kf_wx

Si le compte du service client a été lié à l'identifiant WeChat du personnel du service client,

L'identifiant WeChat sera affiché ici

invite_wx

Si le compte du service client n'existe pas encore Bind WeChat ID, mais qu'une invitation contraignante a été lancée,

L'ID WeChat de l'invitation contraignante sera affiché ici

invite_expire_time

Si le compte du service client n'a pas été lié à l'identifiant WeChat, mais une invitation contraignante a été lancée. Définissez l'invitation,

L'heure d'expiration de l'invitation est l'horodatage Unix

invite_status

Le statut de l'invitation est "en attente" confirmation, "rejeté" pour rejet,

expiré "expiré"


Obtenir des informations de base sur le service client

Instructions d'appel

1
2
Méthode de requête http : GET< /code>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
🎜

Instructions de retour

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Exemple de données de retour (JSON renvoie le résultat lorsqu'il est correct) :返回数据示例（正确时的JSON返回结果）：
{
   "kf_online_list": [
       {
           "kf_account": "test1@test", 
{ 🎜🎜 "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
       }
   ]
}

Description du paramètre

ParamètreExplication
kf_accountCompte de service client complet, le format est : préfixe de compte@compte officiel WeChat ID
statutStatut en ligne du service client, actuellement : 1. web en ligne
kf_idNuméro du service client
accepted_caseLe nombre de sessions actuellement reçues par le service client

Ajouter un compte de service client

Instructions d'appel

L'exemple de données POST est le suivant :
1
2
3
4
5
6
7
Méthode de requête 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>"pseudo" : "Service Client 1"🎜🎜 }🎜🎜🎜🎜🎜

Description du paramètre

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

Instructions de retour

"errcode" : 0,
1
2
3
4
5
Exemple de données de retour (renvoie le résultat JSON lorsqu'il est correct) :< / code>返回数据示例（正确时的JSON返回结果）：
 {
    "errcode" : 0,
    "errmsg" : "ok"
 }
{
"errmsg"  : "ok"🎜🎜 }🎜🎜🎜🎜🎜

Code de retour principal

Code retourExplication
0Succès
65400L'API n'est pas disponible, c'est-à-dire que la nouvelle fonction de service client n'est pas activée/mise à niveau
65403 Client le pseudo du service est illégal
65404Le compte du service client est illégal
65405Le nombre de comptes a atteint la limite supérieure et aucun ajout supplémentaire ne peut être effectué
65406Comptes de service client déjà existants

Invitation à lier le compte du service client

Le compte du service client nouvellement ajouté ne peut pas être utilisé directement. Ce n'est qu'après que le personnel du service client a lié le compte du service client à l'aide de l'identifiant WeChat qu'il peut se connecter au client Web. service pour les opérations. Cette interface lance une invitation contraignante à l'identifiant WeChat du personnel du service client. Le personnel du service client doit confirmer avec l'identifiant WeChat sur le client WeChat avant que le compte puisse être utilisé. Les comptes qui n'ont pas été liés à l'ID WeChat peuvent être liés à l'opération d'invitation. Si l'invitation n'a pas expiré, le compte ne peut pas être lié à l'ID WeChat pour inviter à nouveau.

Instructions d'appel

1
2
3
4
5
6
7
Méthode de requête http : POST< /code>http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN
https://api.weixin.qq.com/customservice/kfaccount/inviteworker?access_token=ACCESS_TOKEN🎜
POST数据示例如下：
 {
    "kf_account" : "test1@test",
    "invite_wx" : "test_kfwx"
 }

Description du paramètre

参数说明
kf_account完整客服帐号，格式为：帐号前缀@公众号微信号
invite_wx接收绑定邀请的客服微信号

Instructions de retour

"errcode" : 0,
1
2
3
4
5
Exemple de données de retour (renvoie le résultat JSON lorsqu'il est correct) :< / code>返回数据示例（正确时的JSON返回结果）：
 {
    "errcode" : 0,
    "errmsg" : "ok"
 }
{
"errmsg"  : "ok"🎜🎜 }🎜🎜🎜🎜🎜

Code de retour principal

Code retourExplication
0Succès
65400L'API n'est pas disponible, c'est-à-dire qu'elle n'a pas été activée/mise à niveau vers la nouvelle version du service client
65401 Compte service client invalide
65407L'invité est déjà le service client de ce compte officiel
65408Ce compte officiel a envoyé une invitation à cet identifiant WeChat
65409ID WeChat invalide
65410Le nombre d'objets invités liés au service client du compte officiel a atteint la limite supérieure (actuellement, le nombre maximum de chaque identifiant WeChat peut lier 5 comptes de service client de compte public)
65411Ce compte a déjà une invitation en attente de confirmation et ne peut pas être invité à nouveau
65412Ce compte a été lié à l'identifiant WeChat et ne peut pas être invité

Définir les informations du service client

Instructions d'appel

L'exemple de données POST est le suivant :
1
2
3
4
5
6
7
Méthode de requête http : POSThttp请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN
POST数据示例如下：
 {
    "kf_account" : "test1@test",
    "nickname" : "客服1"
 }
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN
{🎜🎜 "kf_account" : "test1@test",🎜🎜 "pseudo" : "Service client 1"🎜🎜 }🎜🎜🎜🎜🎜

Description du paramètre

参数说明
kf_account完整客服帐号，格式为：帐号前缀@公众号微信号
nickname客服昵称，最长16个字
< /code>

{
 "errcode"  : 0,

"errmsg" : "ok" }

Code de retour principal

Code retourExplication
0Succès
65400L'API n'est pas disponible, c'est-à-dire que la nouvelle version de la fonction de service client n'est pas activée/mise à niveau
65401 Compte du service client invalide
65403Le pseudo du service client est illégal


Télécharger l'avatar du service client

Instructions d'appel

1
2
3
4
5
Méthode de requête 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
Exemple d'appel (utilisez la commande curl pour télécharger un fichier multimédia à l'aide du formulaire FORM) : 🎜🎜curl -F media= @test.jpg "https://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT"🎜🎜🎜🎜🎜

Description du paramètre

Paramètre Description
kf_accountCompte de service client complet, le format est : préfixe du compte @compte officiel WeChat ID
mediaform -identifiant du fichier de données, Il y a le nom du fichier, la longueur du fichier, le type de contenu et d'autres informations, et la taille du fichier est inférieure à 5 M


Description du retour 12345 Exemple de données de retour (résultat de retour JSON correct) : { "errcode" : 0, "errmsg" : "ok" } Code de retour principal Description du code de retour 0 Succès 65400 L'API n'est pas disponible, c'est-à-dire qu'elle a n'a pas été activé/mis à niveau Vers la nouvelle version de la fonction de service client 65401 Compte de service client invalide 65403 Surnom de service client illégal 40005 Type de média non pris en charge 40009 Longueur de fichier multimédia illégale Supprimer les instructions d'appel du compte de service client 12 Méthode de requête http : GET https://api. weixin.qq.com/customservice/kfaccount/ del?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT description du paramètre description du paramètre kf_account compte de service client complet, le format est : préfixe du compte @ compte officiel WeChat ID instructions de retour "errcode" : 0,
1
2
3
4
5
Exemple de données de retour (le résultat JSON renvoie lorsqu'il est correct) :返回数据示例（正确时的JSON返回结果）：
 {
    "errcode" : 0,
    "errmsg" : "ok"
 }
{
"errmsg"  : "ok"🎜🎜 }🎜🎜🎜🎜🎜

Code de retour principal

返回码

说明

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


Description du code retour de l'interface de gestion du service client

Code retourExplication
0Succès
65400L'API n'est pas disponible, c'est-à-dire que la nouvelle version de la fonction de service client n'est pas activée/mise à niveau
65401 Compte du service client invalide
65403Le pseudo du service client est illégal
65404Le compte du service client est illégal
65405Le nombre de comptes a atteint la limite supérieure et aucun ajout ne peut plus être effectué
65406Compte du service client déjà existant
654 07

L'invité est déjà le service client du compte officiel

65408

Ce compte officiel a déjà une invitation à ce compte WeChat

65409ID WeChat invalide
65410Le nombre de comptes de service client officiels liés à l'invité a atteint la limite supérieure (actuellement, chaque identifiant WeChat peut être lié à 5 comptes de service client officiels)
65411 Ce compte a déjà une invitation en attente de confirmation et ne peut pas être invité à nouveau
65412Ce compte a été lié à l'identifiant WeChat et ne peut pas être invité
40005Type de média non pris en charge
40009 La longueur du fichier multimédia est illégale


←
→

Site Web PHP chinois

MaisonMaisonCoursCoursArticleArticleQuestions et réponsesQuestions et réponsesDictionnaireDictionnaireManuelManuelTéléchargerTéléchargerrechercherechercheAPPTélécharger APPTélécharger