Personalized menu developed by WeChat

In order to help public accounts achieve flexible business operations, the WeChat public platform has added a personalized menu interface. Developers can use this interface to allow different user groups of public accounts to see different customized menus. This interface is open to certified subscription accounts and certified service accounts.

Developers can set the menu that users see through the following conditions:

1. User Group (The developer’s business needs can be completed with the help of user grouping)
2. Gender
3. Mobile operating system
4. Region (the region set by the user on the WeChat client)
5. Language (the language set by the user on the WeChat client)

Personalized menu interface description:

1. The personalized menu requires the user’s WeChat client version to be iPhone6.2.2, Android 6.2.4 or above .
2. The refresh strategy of the menu is that when the user enters the public account conversation page or the public account profile page, if the last request to pull the menu is found 5 minutes ago, it will be pulled. Click the menu. If the menu has update, the client's menu will be refreshed. When testing, you can try to unfollow the public account and follow it again, and you can see the effect after creation.
3. The number of new interfaces for the personalized menu of ordinary public accounts is limited to 2,000 times per day, the number of deletion interfaces is also 2,000 times, and the number of times for testing the personalized menu matching result interface is 20,000 times
4 , For security considerations, all personalized menus of an official account can only be set to jump to links under 3 domain names at most
5. A default menu must be created before creating a personalized menu (The default menu refers to the menu created using the ordinary custom menu creation interface). If you delete the default menu, all personalized menus will also be deleted

Personalized menu matching rule description:

When an official account creates multiple personalized menus , will be matched one by one according to the publishing order, from new to old, until the user information matches matchrule. If all personalized menus are not matched successfully, the default menu will be returned.
For example, the public account has released the default menu, personalized menu 1, personalized menu 2, and personalized menu 3. Then when the user enters the official account page, matching will start from personalized menu 3. If personalized menu 3 is successfully matched, it will directly return to personalized menu 3. Otherwise, it will continue to try to match personalized menu 2 until a menu is successfully matched.
According to the above matching rules, in order to avoid confusion about the menu's effective time, it has been decided not to provide personalized menu editingAPI. When developers need to update the menu, they need to re-release the complete configuration.

Directory

1 Create a personalized menu

2 Delete a personalized menu

3 Test the matching result of the personalized menu

4 QueryPersonalized menu

5 Delete all menus

Create personalized menu

http request method: POST (please use https protocol)

api.weixin.qq.com/cgi-bin/menu/addconditional?access_token=ACCESS_TOKEN

Request example

{
 "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":{
  "group_id":"2",
  "sex":"1",
  "country":"中国",
  "province":"广东",
  "city":"广州",
  "client_platform_type":"2"
  "language":"zh_CN"
  }
}

Parameter description

matchrule has a total of six fields, all of which can be empty, but not all of them. At least one matching information must be non-empty. The regional information composed of country, province, and city will be verified in the order of country, province, and city, and must comply with the content of the regional information table. The regional information is verified from large to small. The small one does not need to be filled in. That is, if the province information is filled in, the national information must also be filled in and matches. The city information does not need to be filled in. For example, "Guangzhou City, Guangdong Province, China" and "Guangdong Province, China" are both legal geographical information, but "Guangzhou City, China" is illegal because the city information is filled in but the province information is not filled in. Please click to download the regional information table.

Return result

The correct return valueJSONThe data packet is as follows. For the error return code, please see the interface return code description.

{
"menuid":"208379533"
}

删除个性化菜单

http请求方式：POST（请使用https协议）

api.weixin.qq.com/cgi-bin/menu/delconditional?access_token=ACCESS_TOKEN

请求示例

{"menuid":"208379533"}

menuid为菜单id，可以通过自定义菜单查询接口获取。

正确时的返回JSON数据包如下，错误时的返回码请见接口返回码说明。：

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

测试个性化菜单匹配结果

http请求方式：POST（请使用https协议）

api.weixin.qq.com/cgi-bin/menu/trymatch?access_token=ACCESS_TOKEN

请求示例

{
"user_id":"weixin"
}

user_id可以是粉丝的OpenID，也可以是粉丝的微信号。

返回结果 该接口将返回菜单配置，示例如下：

{
    "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": [ ]
        }
    ]
}

错误时的返回码请见接口返回码说明。

查询个性化菜单

使用普通自定义菜单查询接口可以获取默认菜单和全部个性化菜单信息，请见自定义菜单查询接口的说明。

删除所有菜单

使用普通自定义菜单删除接口可以删除所有自定义菜单（包括默认菜单和全部个性化菜单），请见自定义菜单删除接口的说明。

【相关推荐】

1. 特别推荐：“php程序员工具箱”V0.1版本下载

2. 微信公众号平台源码下载

3. 微信投票源码下载

The above is the detailed content of Personalized menu developed by WeChat. For more information, please follow other related articles on the PHP Chinese website!