Message du modèle d'API du mini programme WeChat
Sur la base du canal de notification de WeChat, nous fournissons aux développeurs des capacités de messagerie modèles qui peuvent atteindre efficacement les utilisateurs, afin d'obtenir un service en boucle fermée et d'offrir une meilleure expérience.
Emplacement push du modèle : notification de service
Conditions de livraison du modèle : déclenchées après que l'utilisateur interagit avec la page dans le système WeChat Pour plus de détails, veuillez consulter la description des conditions de livraison
Capacité de saut de modèle : cliquez pour afficher les détails et pouvez uniquement. passez à la page suivante. Chaque page du compte où le modèle est envoyé
Mode d'emploi
- Obtenez l'ID du modèle
Connectez-vous à https://mp.weixin.qq.com pour obtenir le modèle. .S'il n'y a pas de modèle approprié, vous pouvez demander à ajouter un nouveau modèle et le réviser. Veuillez vous référer aux instructions de révision du modèle pour plus de détails. messages modèles.
<form/>组件，属性report-submit为true时，可以声明为需发模板消息，此时点击按钮提交表单可以获取formId，用于发送模板消息。或者当用户完成支付行为，可以获取prepay_idDescription de l'interface- 1. Obtenir access_tokenaccess_token est l'identifiant d'appel d'interface unique au monde que les développeurs doivent utiliser access_token lors de l'appel de chacun. interface. Veuillez le conserver correctement. Au moins 512 caractères d'espace doivent être réservés pour le stockage access_token. La période de validité de access_token est actuellement de 2 heures et doit être actualisée régulièrement. Une acquisition répétée rendra le dernier access_token invalide.
- Afin de préserver la confidentialité de l'application, le tiers a besoin d'un serveur de contrôle central pour obtenir et actualiser le access_token. Le access_token utilisé par d'autres serveurs de logique métier provient du serveur de contrôle central et ne doit pas être actualisé individuellement, sinon le access_token sera écrasé et affectera l'entreprise.
- La période de validité actuelle du access_token est transmise via le expire_in renvoyé, qui est actuellement 7200 secondes de valeur. Le serveur de contrôle central doit actualiser le nouveau access_token à l'avance en fonction de cette heure valide. Pendant le processus d'actualisation, le serveur de contrôle central génère toujours l'ancien access_token. À ce stade, le backend de la plate-forme publique garantira que l'ancien et le nouveau access_token sont disponibles dans un court laps de temps après l'actualisation, ce qui garantit une transition en douceur des tiers. business ;
- access_token est valide L'heure peut être ajustée à l'avenir, de sorte que le serveur de contrôle central doit non seulement s'actualiser activement en interne à intervalles réguliers, mais doit également fournir une interface pour actualiser passivement le access_token, afin que le serveur d'entreprise peut déclencher le processus d'actualisation du access_token lorsque l'appel d'API apprend que le access_token a expiré.
Les développeurs peuvent utiliser AppID et AppSecret pour appeler cette interface afin d'obtenir access_token. AppID et AppSecret peuvent être obtenus en vous connectant au site officiel de la plateforme publique WeChat - Paramètres - Paramètres de développement (vous devez être lié pour devenir développeur et le compte n'a aucun statut anormal). Veuillez enregistrer vous-même l'AppSecret après sa génération, car chaque fois qu'il est généré et affiché sur la plateforme publique, l'AppSecret sera réinitialisé. Notez que le protocole https doit être utilisé lors de l'appel de toutes les interfaces WeChat. Si le tiers n'utilise pas le serveur de contrôle central, mais choisit chaque point de logique métier pour actualiser le access_token séparément, des conflits peuvent survenir, entraînant une instabilité du service.
Adresse de l'interface :
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
Méthode de requête HTTP :
GET
Description du paramètre :
Description du paramètre de retour
Norm : Allié, WeChat renverra le package de données JSON suivant à développeurs :
{"access_token":"ACCESS_TOKEN","expires_in":7200}
Lorsqu'une erreur se produit, WeChat renvoie un code d'erreur et d'autres informations. L'exemple de package de données JSON est le suivant (cet exemple est une erreur AppID invalide) :
{"errcode":40013,"errmsg":"invalid appid"}2.
Adresse d'interface : (ACCESS_TOKEN doit être remplacé par le access_token obtenu ci-dessus)https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN
POST
{
"touser": "OPENID",
"template_id": "TEMPLATE_ID",
"page": "index",
"form_id": "FORMID",
"data": {
"keyword1": {
"value": "339208499",
"color": "#173177"
},
"keyword2": {
"value": "2015年01月05日 12:30",
"color": "#173177"
},
"keyword3": {
"value": "粤海喜来登酒店",
"color": "#173177"
} ,
"keyword4": {
"value": "广州市天河区天河路208号",
"color": "#173177"
}
},
"emphasis_keyword": "keyword1.DATA"
}
Après avoir appelé l'interface de message du modèle, un paquet de données JSON sera renvoyé.
Exemple de paquet de données JSON renvoyé dans des conditions normales :
{ "errcode":0, "errmsg":"ok",
}Les informations sur le code d'erreur seront renvoyées lorsqu'une erreur se produit, la description est la suivante :
| Code retour | Explication |
|---|---|
| 40037 | template_id est incorrect |
| 41028 | form_id est incorrect ou expiré |
| 41029 | form_id a été utilisé |
| 41030 | la page est incorrecte |
Effet d'utilisation :
Remarque : Pendant la phase de test interne, après l'émission du modèle de message, seules les notifications simples émises par « l'assistant de sécurité du compte officiel » peuvent être vues sur le client. Si vous recevez cette invite, cela signifie que la fonction de message modèle a été déboguée avec succès. Une fois cette fonction officiellement lancée, elle sera affichée comme indiqué dans l'image ci-dessus.
Description de la condition du problème
Paiement
Lorsque l'utilisateur termine le comportement de paiement dans le mini-programme, le développeur est autorisé à envoyer un nombre limité de modèles de messages à l'utilisateur dans les 7 jours (un paiement peut être émis par temps, le nombre de transactions sous plusieurs paiements est indépendant et ne s'affecte pas les uns les autres)
Soumettre le formulaire
Lorsqu'un utilisateur soumet un formulaire dans le mini-programme et que le formulaire est déclaré pour envoyer des messages modèles, le développeur doit fournir à l'utilisateur Lors de la diffusion, les développeurs peuvent être autorisés à envoyer un nombre limité de modèles de messages aux utilisateurs dans les 7 jours (un message peut être envoyé une fois qu'un formulaire est soumis, et le nombre de messages envoyés après plusieurs soumissions est indépendant et ne le fait pas
Instructions d'audit
1. Titre
1.1 Le titre ne peut pas être le même
1.2 La signification du titre ne peut pas être trop similaire
1.3 Le titre doit se terminer par "rappel" ou " notification"
1.4 Le titre ne peut pas contenir de symboles spéciaux, de mots personnalisés, etc. Aucun Contenu général de l'industrie
1.5 Le titre doit refléter le scénario de service spécifique
1.6 Le titre ne peut pas impliquer de contenu lié au marketing, y compris, mais sans s'y limiter, :
Remises aux consommateurs, remises sur les achats, mises à jour de produits, coupons et bons d'achat, enveloppes rouges, cartes de membre, points, activités et autres notifications de tendances marketing
2. Mots-clés
2.1 Sous le même titre, les mots-clés ne peuvent pas être les mêmes.
2.2 Sous le même titre, les mots-clés ne peuvent pas être trop similaires
2.3 Les mots-clés ne peuvent pas contenir de symboles spéciaux, de mots personnalisés et d'autres contenus qui ne sont pas à l'échelle de l'industrie
2.4 Les exemples de contenu de mots-clés doivent correspondre aux mots-clés
2.5 Les mots-clés ne peuvent pas. être trop large et doit être restrictif, tel que : " Le « Contenu » est trop large et ne peut pas être approuvé
Description de la violation
En plus de ne pas violer les spécifications de fonctionnement, les règles suivantes ne peuvent pas être violées, y compris, mais sans s'y limiter à :
- Il n'est pas autorisé d'inciter les utilisateurs à effectuer des opérations de déclenchement pour obtenir des résultats acceptables. Le but de fournir des modèles aux utilisateurs
- Le harcèlement malveillant n'est pas autorisé. Les modèles qui provoquent le harcèlement des utilisateurs ne sont pas autorisés. non autorisé. Les modèles sont émis à des fins de marketing
- Il n'est pas autorisé d'émettre des modèles via des comptes de service pour informer les utilisateurs du mini-programme. Contenu lié au service déclenché Description de la pénalité
Pour la première violation, le modèle de violation sera supprimé à titre d'avertissement,
Pour la deuxième violation, le bannissement sera imposé 7 jours pour l'interface. La troisième violation entraînera une interdiction d'interface de 30 jours
La quatrième violation entraînera une interdiction d'interface permanente
Les résultats et les raisons de la pénalité seront informés sous la forme d'un message sur le site
.
