Interface de message modèle
Interface de message modèle
Les messages modèles ne sont utilisés que par les comptes officiels pour envoyer des notifications de service importantes aux utilisateurs et ne peuvent être utilisés que dans des scénarios de service qui répondent à leurs exigences, tels que les notifications de glissement de carte de crédit, les notifications de réussite d'achat de produits, etc. . Les messages marketing tels que les publicités et tous les autres messages susceptibles de harceler les utilisateurs ne sont pas pris en charge.
À propos des règles d'utilisation, veuillez noter :
1、所有服务号都可以在功能->添加功能插件处看到申请模板消息功能的入口，但只有认证后的服务号才可以申请模板消息的使用权限并获得该权限； 2、需要选择公众账号服务所处的2个行业，每月可更改1次所选行业； 3、在所选择行业的模板库中选用已有的模板进行调用； 4、每个账号可以同时使用25个模板。 5、当前每个账号的模板消息的日调用上限为10万次，单个模板没有特殊限制。【2014年11月18日将接口调用频率从默认的日1万次提升为日10万次，可在MP登录后的开发者中心查看】。当账号粉丝数超过10W/100W/1000W时，模板消息的日调用上限会相应提升，以公众号MP后台开发者中心页面中标明的数字为准。
À propos des documents d'interface, veuillez noter :
1、模板消息调用时主要需要模板ID和模板中各参数的赋值内容；
2、模板中参数内容必须以".DATA"结尾，否则视为保留字；
3、模板保留符号"{{ }}"。Définir l'industrie
Description de la demande d'appel d'interface Description des données POST Les exemples de données POST sont les suivants : Description du paramètre industry_id1 Requête du code de l'industrie Obtenez les informations sur l'industrie définies par le compte. Les informations sur l'industrie peuvent être consultées sur le site officiel de MP. Pour la commodité des développeurs tiers, les informations sur l'industrie définies par le compte sont obtenues via des appels d'interface. Les détails sont les suivants : Instructions de demande d'appel d'interface . Instructions sur les paramètres Description du retour Exemple de retour après appel correct : Description du paramètre de retour Sélectionnez un modèle dans la bibliothèque de modèles de l'industrie vers le backend du compte. Le processus d'obtention de l'ID du modèle peut être effectué dans MP. Pour la commodité des développeurs tiers, une méthode d'obtention de l'ID de modèle via un appel d'interface est fournie, comme suit : Description de la demande d'appel d'interface Description des données POST Les exemples de données POST sont les suivants : Description du paramètre Description du code de retour Après avoir appelé l'interface de message du modèle, un paquet de données JSON sera renvoyé. Exemple de retour d'un paquet de données JSON dans des conditions normales : Obtenez la liste de tous les modèles qui ont été ajoutés au compte Vous pouvez afficher la liste des modèles. Pour plus de commodité, les développeurs tiers fournissent un moyen d'obtenir toutes les informations de modèle sous le compte via des appels d'interface, comme suit : Instructions de demande d'appel d'interface Instructions de paramètre Description du retour Exemple de retour après un appel correct : Description du paramètre de retour La suppression de modèles peut être effectuée dans MP Pour faciliter la tâche des développeurs tiers, nous proposons un moyen de supprimer des modèles sous un compte via des appels d'interface, comme suit : . Description de la demande d'appel de l'interface La description des données POST est la suivante : Description des paramètres Instructions de retour Après avoir appelé l'interface, un paquet de données JSON sera renvoyé. Exemple de paquet de données JSON renvoyé lorsque c'est normal : Description de la demande d'appel de l'interface Description des données POST Les exemples de données POST sont les suivants : Description du paramètre Après avoir appelé l'interface de message du modèle, un paquet de données JSON sera renvoyé. Exemple d'un paquet de données JSON de retour normal : Une fois la tâche d'envoi du modèle de message terminée, le serveur WeChat indiquera si la livraison a réussi et l'enverra à le développeur Dans l'adresse de configuration du serveur renseignée au centre. 1. Lorsque la livraison est réussie, le XML poussé est le suivant : Description du paramètre 2. Lorsque la livraison échoue en raison du rejet de l'utilisateur (les paramètres de l'utilisateur refusent de recevoir les messages du compte officiel), le XML poussé est le suivant : Description du paramètre 3. Lorsque la livraison échoue pour d'autres raisons, le XML poussé est le suivant : Description du paramètrehttp请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_set_industry?access_token=ACCESS_TOKEN
{
"industry_id1":"1",
"industry_id2":"4"
}Le paramètre est-il requis ? Description access_token est Identifiants d'appel d'interface est le numéro de secteur auquel appartient le message du modèle de compte officiel industry_id2 est le numéro de secteur auquel appartient le message du modèle de compte officiel Industrie principale Sous-industrie Code Technologie informatique Internet/Commerce électronique 1 Technologie informatique Logiciels et services informatiques 2 IT Technologie Matériel et équipement informatique 3 Technologie informatique Technologie électronique 4 Technologie informatique Communications et opérateurs 5 Technologie informatique Jeux en ligne 6 Industrie financière Banque 7 Industrie financière Fonds|Gestion financière|Fiducies 8 Industrie financière Assurance 9 Restauration Restauration 10 Voyage à l'hôtel Hôtel 11 Voyage à l'hôtel Voyage 12 Transport et entreposage Express 13 Transport et entreposage Logistique 14 Transport et entreposage Entrepôt 15 Éducation Formation 16 Éducation Écoles 17 Gouvernement et services publics Recherche universitaire 18 Gouvernement et services publics Police de la circulation 19 Gouvernement et services publics Musée 20 Gouvernement et services publics Services publics|Institutions à but non lucratif 21 Pharmaceutique et soins infirmiers Produits pharmaceutiques et soins de santé 22 Soins médicaux Soins et beauté 23 Soins médicaux Santé et hygiène 24 Transport Concernant la voiture 25 Transport Liés à la moto 26 Transport Lié au train 27 Transport Lié à l'aviation 28 Immobilier Construction 29 Immobilier Propriété 30 Services aux entreprises Services intermédiaires Services aux entreprises Certification Services aux entreprises Audit Sports et divertissement Médias Sports et divertissement Sports Sports et divertissement Divertissement et loisirs Impression Impression Autres Autres Obtenez les informations sur l'industrie définies par le compte
http请求方式：GET
https://api.weixin.qq.com/cgi-bin/template/get_industry?access_token=ACCESS_TOKEN
Le paramètre est-il obligatoire ? Description access_token est le identifiants d'appel de l'interface {
"primary_industry":{"first_class":"运输与仓储","second_class":"快递"},
"secondary_industry":{"first_class":"IT科技","second_class":"互联网|电子商务"}
}Le paramètre est-il obligatoire ? Description access_token Oui Identifiants d'appel d'interface primary_industry est l'industrie principale définie par compte secondary_industry est l'industrie secondaire définie par compte Obtenir l'ID du modèle
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/template/api_add_template?access_token=ACCESS_TOKEN
{
"template_id_short":"TM00015"
}Le paramètre est-il obligatoire ? Description access_token est les informations d'identification de l'appel d'interface template_id_short est dans la bibliothèque de modèles Le numéro du modèle, y compris "TM **" et " OPENTMTM **" et autres formulaires {
"errcode":0,
"errmsg":"ok",
"template_id":"Doclyl5uP7Aciu-qZ7mJNPtWkbkYnWBWVja26EGbNyk"
} Obtenez la liste des modèles
http请求方式：GET
https://api.weixin.qq.com/cgi-bin/template/get_all_private_template?access_token=ACCESS_TOKEN
Le paramètre est-il obligatoire ? Description access_token est le identifiants d'appel de l'interface {
"template_list": [{
"template_id": "iPk5sOIt5X_flOVKn5GrTFpncEYTojx6ddbt8WYoV5s",
"title": "领取奖金提醒",
"primary_industry": "IT科技",
"deputy_industry": "互联网|电子商务",
"content": "{ {result.DATA} }\n\n领奖金额:{ {withdrawMoney.DATA} }\n领奖 时间:{ {withdrawTime.DATA} }\n银行信息:{ {cardInfo.DATA} }\n到账时间: { {arrivedTime.DATA} }\n{ {remark.DATA} }",
"example": "您已提交领奖申请\n\n领奖金额：xxxx元\n领奖时间：2013-10-10 12:22:22\n银行信息：xx银行(尾号xxxx)\n到账时间：预计xxxxxxx\n\n预计将于xxxx到达您的银行卡"
}]
}Le paramètre est-il obligatoire ? ID du modèle est Le titre du modèle est l'industrie principale de l'industrie à laquelle appartient le modèle est l'industrie secondaire de l'industrie à laquelle appartient le modèle content Contenu du modèle exemple exemple de modèle Suppression de modèles
http请求方式：POST
https://api.weixin.qq.com/cgi-bin/template/del_private_template?access_token=ACCESS_TOKEN
{
"template_id" : "Dyvp3-Ff0cnail_CDSzk1fIc6-9lOkxsQE7exTJbwUE"
}Le paramètre est-il obligatoire ? ID de message modèle sous le compte public {
"errcode" : 0,
"errmsg" : "ok"
}Envoi du modèle de message
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN
{
"touser":"OPENID",
"template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
"url":"http://weixin.qq.com/download",
"data":{
"first": {
"value":"恭喜你购买成功！",
"color":"#173177"
},
"keynote1":{
"value":"巧克力",
"color":"#173177"
},
"keynote2": {
"value":"39.8元",
"color":"#173177"
},
"keynote3": {
"value":"2014年9月22日",
"color":"#173177"
},
"remark":{
"value":"欢迎再次购买！",
"color":"#173177"
}
}
}Le paramètre est-il obligatoire ? identification tardive non saut de modèle Le lien de redirection est données de modèle
Description du code de retour {
"errcode":0,
"errmsg":"ok",
"msgid":200228332
}Event push
<xml>
<ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
<FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
<CreateTime>1395658920</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
<MsgID>200163836</MsgID>
<Status><![CDATA[success]]></Status>
</xml>
Paramètre Description ToUserName Compte officiel WeChat ID FromUserName L'openid de l'utilisateur qui reçoit le modèle de message C reateTime Creation Time MsgType Message Le type est event Event L'événement est un modèle de fin d'envoi de message MsgID identifiant du message Status L'envoi du statut est réussi <xml>
<ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
<FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
<CreateTime>1395658984</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
<MsgID>200163840</MsgID>
<Status><![CDATA[failed:user block]]></Status>
</xml>
Paramètre Description ToUserName Public ID du compte Wechat FromUserName L'openid de l'utilisateur qui reçoit le modèle de message CreateTime Creation time MsgType Le type de message est event Événement L'événement est la fin de l'envoi du modèle de message MsgID Message id Status Le statut d'envoi est que l'utilisateur a refusé de recevoir <xml>
<ToUserName><![CDATA[gh_7f083739789a]]></ToUserName>
<FromUserName><![CDATA[oia2TjuEGTNoeX76QEjQNrcURxG8]]></FromUserName>
<CreateTime>1395658984</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[TEMPLATESENDJOBFINISH]]></Event>
<MsgID>200163840</MsgID>
<Status><![CDATA[failed: system failed]]></Status>
</xml>
Paramètre Description ToUserName ID officiel du compte WeChat FromUserName Recevoir des modèles L'openid de l'utilisateur du message CreateTime Heure de création MsgType Le type de message est event Event L'événement est la fin de l'envoi du message modèle MsgID identifiant du message Status Le statut d'envoi est un échec d'envoi (non-utilisateur rejeté)
