Interface de menu personnalisée
Interface de menu personnalisée
Afin d'aider les comptes publics à réaliser des opérations commerciales flexibles, la plateforme publique WeChat a ajouté une interface de menu personnalisée. Les développeurs peuvent utiliser cette interface pour permettre à différents groupes d'utilisateurs de comptes publics de voir différentes vues. . Cette interface est ouverte aux comptes d'abonnement certifiés et aux comptes de service certifiés.
Les développeurs peuvent définir le menu que les utilisateurs voient dans les conditions suivantes :
1、用户标签(开发者的业务需求可以借助用户标签来完成) 2、性别 3、手机操作系统 4、地区(用户在微信客户端设置的地区) 5、语言(用户在微信客户端设置的语言)
Description de l'interface du menu personnalisé :
1、个性化菜单要求用户的微信客户端版本在iPhone6.2.2,Android 6.2.4以上,暂时不支持其他版本微信 2、菜单的刷新策略是,在用户进入公众号会话页或公众号profile页时,如果发现上一次拉取菜单的请求在5分钟以前,就会拉取一下菜单,如果菜单有更新,就会刷新客户端的菜单。测试时可以尝试取消关注公众账号后再次关注,则可以看到创建后的效果 3、普通公众号的个性化菜单的新增接口每日限制次数为2000次,删除接口也是2000次,测试个性化菜单匹配结果接口为20000次 4、出于安全考虑,一个公众号的所有个性化菜单,最多只能设置为跳转到3个域名下的链接 5、创建个性化菜单之前必须先创建默认菜单(默认菜单是指使用普通自定义菜单创建接口创建的菜单)。如果删除默认菜单,个性化菜单也会全部删除 6、个性化菜单接口支持用户标签,请开发者注意,当用户身上的标签超过1个时,以最后打上的标签为匹配
Description de la règle de correspondance du menu personnalisé :
个性化菜单的更新是会被覆盖的。 例如公众号先后发布了默认菜单,个性化菜单1,个性化菜单2,个性化菜单3。那么当用户进入公众号页面时,将从个性化菜单3开始匹配,如果个性化菜单3匹配成功,则直接返回个性化菜单3,否则继续尝试匹配个性化菜单2,直到成功匹配到一个菜单。 根据上述匹配规则,为了避免菜单生效时间的混淆,决定不予提供个性化菜单编辑API,开发者需要更新菜单时,需将完整配置重新发布一轮。
Créer un menu personnalisé
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN
Exemple de requête
{ "button":[ { "type":"click", "name":"今日歌曲", "key":"V1001_TODAY_MUSIC" }, { "name":"菜单", "sub_button":[ { "type":"view", "name":"搜索", "url":"http://www.soso.com/" }, { "type":"view", "name":"视频", "url":"http://v.qq.com/" }, { "type":"click", "name":"赞一下我们", "key":"V1001_GOOD" }] }], "matchrule":{ "tag_id":"2", "sex":"1", "country":"中国", "province":"广东", "city":"广州", "client_platform_type":"2", "language":"zh_CN" } }
Description du paramètre
Le paramètre | est-il obligatoire ? | Description |
---|---|---|
button | est un | tableau de menu de premier niveau, le nombre doit être compris entre 1 et 3 |
sub_button | Non | Menu secondaire tableau, Le nombre doit être compris entre 1 et 5 |
type | est le type d'action de réponse du | menu |
name | est le | titre du menu, pas plus de 16 octets, et non plus de 40 caractères pour la section du sous-menu |
key | le clic et les autres types de clic doivent | valeur KEY du menu, utilisée pour l'interface de message push, pas plus de 128 octets |
url | le type de vue doit | lien Web, l'utilisateur peut cliquer sur le menu pour ouvrir le lien, pas plus de 1024 octets |
media_id | media_id type et view_limited doivent | appeler la nouvelle interface matérielle permanente pour renvoyer le media_id légal |
matchrule | est | règle de correspondance du menu |
tag _id | NonNon | Version client, actuellement uniquement modèle de système spécifique : IOS(1), Android(2),Autres(3), si non renseigné, aucune correspondance sera fait |
pays | Non | Informations sur le pays, oui La région définie par l'utilisateur dans WeChat Veuillez vous référer au tableau d'informations sur la région pour plus de détails |
langue | Non | Les informations linguistiques sont la langue définie par l'utilisateur dans WeChat. Pour plus de détails, veuillez vous référer au tableau des langues : 1. Chinois simplifié "zh_CN" 2. Chinois traditionnel TW "zh_TW" 3. Chinois traditionnel. HK "zh_HK" 4. Anglais "en" 5. Indonésien "id" 6. Malais "ms" 7. Espagnol "es" 8. Coréen "ko" 9. Italien "it" 10. Japonais "ja" 11. Polonais " pl" 12, portugais "pt" 13, russe "ru" 14, thaï "th" 15, vietnamien "vi" 16, arabe "ar" 17, nord-indien "hi" 18, hébreu "he" 19, turc "tr " 20. Allemand "de" 21. Français "fr" |
Matchrule a un total de six champs, qui peuvent tous être vides, mais tous au moins une information correspondante ne doit pas être vide. Les informations régionales composées du pays, de la province et de la ville seront vérifiées dans l'ordre du pays, de la province et de la ville et doivent être conformes au contenu du tableau d'informations régionales. Les informations régionales sont vérifiées de grande à petite. Il n'est pas nécessaire de remplir la petite. Autrement dit, si les informations de la province sont remplies, les informations nationales doivent également être remplies et les informations de la ville n'ont pas besoin de le faire. être rempli. Par exemple, « Ville de Guangzhou, province du Guangdong, Chine » et « Province du Guangdong, Chine » sont toutes deux des informations géographiques légales, mais « Ville de Guangzhou, Chine » est illégale car les informations sur la ville sont renseignées mais les informations sur la province ne le sont pas. Veuillez cliquez pour télécharger pour accéder au tableau d'information régional.
Résultats de retour
Le paquet de données JSON renvoyé lorsqu'il est correct est le suivant Pour le code de retour lorsqu'il est erroné, veuillez consulter la description du code de retour de l'interface.
{ "menuid":"208379533" }
Supprimer le menu personnalisé
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq.com/cgi-bin/menu/delconditional?access_token=ACCESS_TOKEN
Exemple de demande
{ "menuid":"208379533" }
menuid est l'identifiant du menu, qui peut être obtenu via l'interface de requête de menu personnalisée.
Le paquet de données JSON renvoyé lorsqu'il est correct est le suivant Pour le code retour lorsqu'il est incorrect, veuillez consulter la description du code retour de l'interface. :
{"errcode":0,"errmsg":"ok"}
Testez les résultats de correspondance du menu personnalisé
Méthode de requête http : POST (veuillez utiliser le protocole https)
https://api.weixin.qq.com/cgi-bin/menu/trymatch?access_token=ACCESS_TOKEN
Exemple de demande
{ "user_id":"weixin" }
user_id peut être l'OpenID du fan ou l'ID WeChat du fan.
Résultat du retour Cette interface renverra la configuration du menu, l'exemple est le suivant :
{ "button": [ { "type": "view", "name": "tx", "url": "http://www.qq.com/", "sub_button": [ ] }, { "type": "view", "name": "tx", "url": "http://www.qq.com/", "sub_button": [ ] }, { "type": "view", "name": "tx", "url": "http://www.qq.com/", "sub_button": [ ] } ] }
Pour le code retour en cas d'erreur, veuillez consulter la description du code retour de l'interface.
Requête de menu personnalisé
Utilisez l'interface de requête de menu personnalisée normale pour obtenir le menu par défaut et toutes les informations de menu personnalisées. Veuillez consulter la description de l'interface de requête de menu personnalisée.
Supprimer tous les menus
Utilisez l'interface de suppression de menu personnalisée normale pour supprimer tous les menus personnalisés (y compris les menus par défaut et tous les menus personnalisés), veuillez consulter la description de l'interface de suppression de menu personnalisée.