Message du service client

Lorsqu'un utilisateur interagit avec un compte public avec une action spécifique (veuillez consulter la description ci-dessous pour la liste d'actions spécifiques), WeChat transmettra les données du message au développeur, et le développeur pourra les utiliser dans un délai de heure (actuellement modifiée à 48 heures) Appelez l'interface du service client et envoyez des messages aux utilisateurs ordinaires en publiant un paquet de données JSON. Cette interface est principalement utilisée pour des fonctions telles que le service client qui nécessitent un traitement manuel des messages, afin que les développeurs puissent fournir de meilleurs services aux utilisateurs.

La liste actuelle des actions autorisées est la suivante (la plateforme publique mettra à jour la liste en fonction de la situation de fonctionnement. Après le déclenchement de différentes actions, le nombre de messages autorisés à être envoyés par l'interface du service client est différent. Lorsque le nombre des messages envoyés atteint la limite supérieure, un code retour d'erreur sera rencontré. Veuillez consulter la page de description du code retour pour plus de détails) :

1、用户发送信息
2、点击自定义菜单（仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中”提示框这3种菜单类型是会触发客服接口的）
3、关注公众号
4、扫描二维码
5、支付成功
6、用户维权

Afin d'aider les comptes publics à utiliser différentes identités de service client pour servir différents groupes d'utilisateurs, le service client L'interface a été mise à niveau. Les développeurs peuvent gérer les comptes de service client et définir l'avatar et le surnom du compte de service client. Cette fonctionnalité est ouverte à tous les comptes publics disposant d’autorisations d’interface de service client.

De plus, les développeurs doivent noter que tous les endroits où media_id est utilisé dans cette interface peuvent désormais utiliser le matériel permanent media_id dans la gestion du matériel.

Gestion du compte du service client

Une fois que le développeur a terminé le développement conformément aux exigences du document de développement, les utilisateurs de WeChat utilisant la version 6.0.2 et supérieure communiquent avec le compte officiel pour service client. Une fois que le compte officiel a utilisé différents comptes de service client pour répondre, les utilisateurs peuvent voir l'avatar et le pseudo du service client correspondants.

Veuillez noter que vous devez d'abord créer un identifiant WeChat pour le compte public sur le site officiel de la plateforme publique avant de pouvoir utiliser cette fonctionnalité.

Ajouter un compte de service client

Les développeurs peuvent ajouter des comptes de service client aux comptes officiels via cette interface. Chaque compte officiel peut ajouter jusqu'à 10 comptes de service client. La demande d'appel d'interface est la suivante :

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN

L'exemple de données POST est le suivant :

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

Instructions de retour (le résultat JSON renvoie lorsqu'il est correct) :

{
     "errcode" : 0,
     "errmsg" : "ok",
}

En cas d'erreur, WeChat renverra le code d'erreur et d'autres informations, veuillez interroger les informations d'erreur en fonction du code d'erreur

Modifier le compte du service client

Les développeurs peuvent modifier le compte du service client du compte officiel via cette interface. La demande d'appel d'interface est la suivante :

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN

L'exemple de données POST est le suivant :

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

Instructions de retour (le résultat JSON renvoie lorsqu'il est correct) :

{
     "errcode" : 0,
     "errmsg" : "ok",
}

En cas d'erreur, WeChat renverra le code d'erreur et d'autres informations, veuillez interroger les informations d'erreur en fonction du code d'erreur

Supprimer le compte du service client

Les développeurs peuvent supprimer les comptes du service client pour les comptes publics via cette interface. La demande d'appel d'interface est la suivante :

http请求方式: GET
https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN

L'exemple de données POST est le suivant :

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

Instructions de retour (le résultat JSON renvoie lorsqu'il est correct) :

{
     "errcode" : 0,
     "errmsg" : "ok",
}

En cas d'erreur, WeChat renverra le code d'erreur et d'autres informations, veuillez interroger les informations d'erreur en fonction du code d'erreur

Définir l'avatar du compte du service client

Les développeurs peuvent appeler cette interface pour télécharger une photo comme avatar du personnel du service client. Le fichier image de l'avatar doit être au format jpg. Image de taille 640*640 pour obtenir le meilleur effet. La demande d'appel d'interface est la suivante :

http请求方式: POST/FORM
http://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
调用示例：使用curl命令，用FORM表单方式上传一个多媒体文件，curl命令的具体用法请自行了解

Instructions de retour (le résultat JSON est renvoyé lorsqu'il est correct) :

{
     "errcode" : 0,
     "errmsg" : "ok",
}

En cas d'erreur, WeChat renverra le code d'erreur et d'autres informations. Veuillez interroger les informations d'erreur en fonction du code d'erreur

.

Obtenez tous les comptes du service client

Grâce à cette interface, les développeurs peuvent obtenir les informations de base du service client définies dans le compte officiel, y compris l'identifiant du service client, le surnom du service client et le compte de connexion du service client.

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

Instructions de retour (résultat renvoyé par JSON lorsqu'il est correct) :

{
    "kf_list": [
        {
            "kf_account": "test1@test", 
            "kf_nick": "ntest1", 
            "kf_id": "1001"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0"
        }, 
        {
            "kf_account": "test2@test", 
            "kf_nick": "ntest2", 
            "kf_id": "1002"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }, 
        {
            "kf_account": "test3@test", 
            "kf_nick": "ntest3", 
            "kf_id": "1003"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }
    ]
}

Lorsqu'il y a une erreur, WeChat renverra le code d'erreur et d'autres informations. Veuillez interroger les informations d'erreur en fonction du code d'erreur

.

Description unifiée des paramètres de l'interface

Interface du service client - Envoyer un message

Description de la demande d'appel de l'interface

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

Les paquets de données JSON requis pour chaque type de message sont les suivants : terminer le SMS

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    }
}

Envoyer un message photo

{
    "touser":"OPENID",
    "msgtype":"image",
    "image":
    {
      "media_id":"MEDIA_ID"
    }
}

Envoyer un message vocal

{
    "touser":"OPENID",
    "msgtype":"voice",
    "voice":
    {
      "media_id":"MEDIA_ID"
    }
}

Envoyer un message vidéo

{
    "touser":"OPENID",
    "msgtype":"video",
    "video":
    {
      "media_id":"MEDIA_ID",
      "thumb_media_id":"MEDIA_ID",
      "title":"TITLE",
      "description":"DESCRIPTION"
    }
}

Envoyer des messages musicaux

{
    "touser":"OPENID",
    "msgtype":"music",
    "music":
    {
      "title":"MUSIC_TITLE",
      "description":"MUSIC_DESCRIPTION",
      "musicurl":"MUSIC_URL",
      "hqmusicurl":"HQ_MUSIC_URL",
      "thumb_media_id":"THUMB_MEDIA_ID" 
    }
}

Envoyer des messages graphiques (cliquez pour accéder au lien externe) Le nombre de messages graphiques est limité à 8. Notez que si le nombre de messages graphiques dépasse 8, il n'y aura pas de réponse.

{
    "touser":"OPENID",
    "msgtype":"news",
    "news":{
        "articles": [
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         },
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         }
         ]
    }
}

Envoyer des messages graphiques (cliquez pour accéder à la page des messages graphiques). Le nombre de messages graphiques est limité à 8. Notez que si le nombre de messages graphiques dépasse 8, il n'y aura pas de réponse.

{
    "touser":"OPENID",
    "msgtype":"mpnews",
    "mpnews":
    {
         "media_id":"MEDIA_ID"
    }
}

Envoyer des cartes et des coupons

{
  "touser":"OPENID", 
  "msgtype":"wxcard",
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad"        
            },
}

Portez une attention particulière à l'interface de message du service client pour l'envoi de cartes et de coupons. Seules les cartes avec des codes non personnalisés et des modes de code importés sont prises en charge.

Veuillez noter que si vous devez utiliser un compte de service client pour envoyer un message (pour afficher un avatar personnalisé dans WeChat 6.0.2 et supérieur), vous devez ajouter le paramètre customservice à la seconde moitié du paquet de données JSON. , comme l'envoi d'un message texte. Puis remplacez par :

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    },
    "customservice":
    {
         "kf_account": "test1@kftest"
    }
}

Description du retour de l'interface

Exemple de données de retour (résultat de retour JSON lorsqu'il est correct) :