Contrôle de session WeChat
Contrôle de session
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 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"
🎜🎜
}
🎜🎜🎜🎜🎜 🎜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) : 🎜🎜
{
🎜🎜 code>" errcode"
: 0,
🎜🎜
"errmsg"
:
< code>"ok"< /code>🎜🎜
}
🎜🎜🎜🎜🎜
Fermer la séance
Instructions d'appel
1234567 Méthode de requête 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
L'exemple de données POST est le suivant :
{
"kf_account " code> :
"test1@test"
,
"openid" code> < code> :
"OPENID"
}
Description du paramètre Paramètre Instructions kf_account Compte de service client complet, le format est : préfixe de compte@compte officiel WeChat ID openid fan's openid Re instructions de virage 1 23 4 5
🎜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
12
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ètre Description openid Openid 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 123 Exemple de données de retour (lorsque le résultat JSON est correct) :
{
"liste de sessions"
: [
{
" 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
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
🎜🎜🎜🎜🎜返回说明
123456789 1011121314 返回数据示例(正确时的JSON返回结果):
返回数据示例(正确时的JSON返回结果):
{
"count"
: 150,
"waitcaselist"
: [
{
"latest_time"
: 123456789,
"openid"
:
"OPENID"
},
{
"latest_time"
: 123456789,
"openid"
:
"OPENID"
}
]
}
{
< code>"count" : 150,
"liste d'attente"
: [
< code>
{
"latest_time"
: 123456789,
code>"openid"
:
"OPENID"
},
{
"latest_time"
: 123456789,
< /code>"openid"
:
"OPENID"
}
]
}
参数说明 参数 说明
🎜count🎜🎜未接入会话数量🎜🎜🎜🎜waitcaselist🎜🎜未接入会话列表,最多返回100条数据,按照来访顺序🎜🎜🎜🎜openid🎜🎜粉丝的openid🎜🎜🎜🎜latest_time🎜 🎜粉丝的最后一条消息的时间🎜🎜🎜🎜Description du code de retour
Code de retour description 0 Succès 65400 L'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 65401 Compte du service client invalide 65402 Le compte du service client n'a pas été lié à l'identifiant WeChat et ne peut pas être utilisé 65413 Il n'y a aucune information de session pour le correspondant utilisateur 65414 Les fans sont reçus par un autre service client 65415 Le service client désigné n'est pas en ligne 40003 Openid illégal