Contrôle de session WeChat


Contrôle de session

201610171124143832.png

Créer une session

Cette interface crée une session entre le service client et l'utilisateur. Si le service client et la session utilisateur existent déjà, elle renvoie 0 directement. Le compte de service client désigné doit être lié à l'identifiant WeChat et en ligne.

Instructions d'appel

1
2
3
4
5
6
7
méthode de requête 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

返回说明

Les exemples de données POST sont les suivants :
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" 🎜🎜 }🎜🎜🎜🎜🎜 🎜Description des paramètres🎜🎜🎜🎜
Paramètres🎜Description🎜🎜
kf_account🎜Compte de service client complet, le format est : préfixe de compte @ compte officiel WeChat ID 🎜🎜
Exemple de données de retour (résultat de retour JSON correct) : 🎜🎜 {🎜🎜 " errcode"  : 0,🎜🎜 "errmsg"  : < code>"ok"< /code>🎜🎜 }🎜🎜🎜🎜🎜


Fermer la séance

Instructions d'appel

1
2
3
4
5
6
7
Méthode de requête 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

返回说明

L'exemple de données POST est le suivant :
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" }Description du paramètreParamètreInstructionskf_accountCompte de service client complet, le format est : préfixe de compte@compte officiel WeChat IDopenidfan's openid1 2345
Re instructions de virage
🎜Exemple de données de retour (le résultat JSON renvoie lorsqu'il est correct) :🎜🎜 {< /code> 🎜🎜 "errcode"  : 0,🎜🎜 "errmsg"  : "ok"🎜🎜 }🎜🎜🎜🎜🎜🎜Code retour principal🎜🎜🎜🎜🎜 🎜Code retour 🎜🎜Explication🎜🎜🎜🎜0🎜🎜Succès🎜🎜🎜🎜65400🎜🎜L'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 🎜🎜Client invalide compte de service🎜 🎜🎜🎜65402🎜🎜Compte L'identifiant WeChat n'a pas été lié et ne peut pas être utilisé🎜🎜🎜🎜65413🎜🎜Il n'y a aucune information de session correspondant à l'utilisateur🎜🎜🎜🎜65414🎜🎜Le client est en cours reçu par un autre service client🎜🎜🎜🎜40003🎜🎜Openid illégal🎜🎜 🎜🎜

Obtenir le statut de la session client

Cette interface récupère la session d'un client si elle n'existe pas, kf_account est vide.

Instructions d'appel

1
2
Méthode de requête 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 du paramètre

ParamètreDescriptionopenidOpenid des fans
🎜

Instructions de retour

12345 Exemple de données de retour (résultat de retour JSON correct) : { "createtime" : 123456789, "kf_account" : "test1@test" } Description du paramètre Description du paramètre kf_account reçoit le service client, vide signifie qu'il n'y a personne. code retour lors de la réception d'un accès à la session de création Description du code retour 0 Succès 65400 L'API n'est pas disponible, c'est-à-dire qu'elle n'a pas été activée/mise à niveau vers la nouvelle version de la fonction de service client 40003 Openid illégal Obtenir la liste des sessions du service client Description de l'appel 12 Méthode de requête http : GET https://api.weixin.qq.com/customservice/kfsession/getsessionlist?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 retour dit ]
1
2
3 Exemple de données de retour (lorsque le résultat JSON est correct) :
{
"liste de sessions"  : [
{
" 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
Get non connecté Liste des sessions🎜🎜Instructions d'appel🎜🎜🎜🎜🎜🎜1🎜🎜2🎜🎜🎜🎜Méthode de requête http : GET🎜🎜https://api.weixin.qq.com/customservice /kfsession/getwaitcase?access_token=ACCESS_TOKEN🎜🎜🎜🎜🎜

返回说明

    < code>"count"  : 150,
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"
       }
    ]
 }
  {
    "liste d'attente"  : [


< code>       
{

          "latest_time"  : 123456789,           "openid"  : "OPENID"       },       {          "latest_time"  : 123456789,           < /code>"openid"  : "OPENID"       }    ] }参数说明参数说明
🎜count🎜🎜未接入会话数量🎜🎜🎜🎜waitcaselist🎜🎜未接入会话列表,最多返回100条数据,按照来访顺序🎜🎜🎜🎜openid🎜🎜粉丝的openid🎜🎜🎜🎜latest_time🎜 🎜粉丝的最后一条消息的时间🎜🎜🎜🎜

Description du code de retour

Code de retour description
0Succès
65400L'API n'est pas disponible, c'est-à-dire que la nouvelle version de la fonction de service client n'a pas été activée ou mise à niveau
65401Compte du service client invalide
65402Le compte du service client n'a pas été lié à l'identifiant WeChat et ne peut pas être utilisé
65413Il n'y a aucune information de session pour le correspondant utilisateur
65414Les fans sont reçus par un autre service client
65415Le service client désigné n'est pas en ligne
40003Openid illégal