在运营微信公众号时，积分体系是维持用户粘性的重要手段。为了让用户能够直观地看到自己的积分能换取什么，我们可以在公众号底部设置一个专属的自定义菜单。当用户点击这个菜单按钮时，系统会触发一个点击事件，进而弹出积分兑换页面或展示可兑换的礼品列表。这种交互方式不仅直观，而且能够有效引导用户参与活动。本文将深入探讨如何通过微信公众号自定义菜单事件实现这一功能。
微信公众号自定义菜单配置与事件推送原理
要实现点击菜单弹出礼品列表，首先需要了解自定义菜单的配置方式。自定义菜单允许开发者通过接口创建菜单结构，每个菜单项可以指定不同的类型。对于需要触发后端逻辑的场景，我们通常将菜单的type属性设置为click，并为其分配一个唯一的Key值。当用户点击该菜单项时，微信服务器会接收到点击动作，并向开发者配置的服务器地址推送一个事件消息。
这个事件消息是一个XML格式的数据包，其中包含了用户的OpenID、开发者账号、事件类型以及菜单的Key值。后端服务需要解析这个XML数据包，提取出EventKey字段。通过判断EventKey的值，我们可以区分用户点击的是哪一个菜单，从而执行对应的业务逻辑。例如，如果EventKey等于JIFEN_EXCHANGE，我们就知道用户请求查看积分兑换列表。这种基于事件驱动的架构使得菜单功能非常灵活，可以承载各种复杂的业务交互。
在配置菜单时，我们需要调用微信的菜单创建接口，提交JSON格式的数据。在数据结构中，必须明确指定按钮的名称、类型以及对应的Key值。只有正确配置了这些参数，微信服务器才能在用户点击时准确地将事件转发到我们的服务器。同时，服务器端必须配置好有效的URL和Token，以便通过微信服务器的签名验证，确保请求确实来自微信官方。
后端接收菜单点击事件并处理业务逻辑
当后端服务器接收到微信推送的XML消息后，首要任务是进行解析和路由。以PHP语言为例，我们可以通过file_get_contents函数读取POST请求的原始数据，然后使用simplexml_load_string将其转换为对象进行操作。解析出MsgType为event，Event为CLICK后，紧接着获取EventKey和FromUserName。FromUserName即为用户的OpenID，这是识别用户身份的关键。
拿到OpenID后，后端需要做两件事：一是查询该用户的当前积分余额，二是从数据库中检索出所有处于上架状态且所需积分小于等于用户余额的礼品列表。如果礼品数量较多，还需要考虑分页展示。在实际业务中，查询数据库可能需要一定时间，而微信服务器要求被动回复消息必须在5秒内完成，否则会提示用户服务出现故障。因此，如果业务逻辑复杂，建议先给用户回复一条简单的文本提示，比如正在为您查询可兑换礼品，请稍候，然后再通过客服消息接口异步发送详细的礼品列表。
$postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
if (!empty($postStr)) {
$postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
if (strtolower($postObj->MsgType) == 'event' and strtolower($postObj->Event) == 'click') {
$eventKey = $postObj->EventKey;
$fromUser = $postObj->FromUserName;
if ($eventKey == 'JIFEN_EXCHANGE') {
// 查询用户积分和可兑换礼品
$giftList = queryExchangeableGifts($fromUser);
// 组装客服消息并发送
sendCustomMessage($fromUser, $giftList);
}
}
}
在上述代码中，我们首先判断了消息类型是否为事件，并且事件是否为菜单点击事件。匹配到预设的EventKey后，执行了查询和发送动作。这种设计模式将业务逻辑与框架底层解耦，使得代码结构更加清晰。同时，为了提高系统的健壮性，建议在查询数据库时加入缓存机制，比如将用户的积分信息缓存在Redis中，减少对数据库的直接访问压力。
构建图文消息或客服消息返回礼品列表
为了给用户展示精美的礼品列表，图文消息是最佳选择。图文消息可以包含标题、描述、图片链接和跳转链接，非常适合展示商品。如果选择异步发送，我们需要调用微信的客服消息接口。这要求先通过AppID和AppSecret获取access_token，然后向微信服务器发送POST请求，请求体为JSON格式数据。
在构建JSON数据时，需要指定接收者即用户的OpenID，消息类型为news，并组装articles数组。每个article对应一个礼品，包含礼品名称、简短描述、缩略图URL以及点击后跳转的H5页面链接。用户点击图文消息后，可以进入详细的兑换页面完成最终操作。需要注意的是，access_token有有效期限制，且每日调用次数有上限，因此在后端实现时应当做好缓存机制，避免频繁请求导致接口不可用。通过这种方式，用户点击菜单后就能收到一份图文并茂的积分兑换清单，大大提升了使用体验。
{
"touser": "OPENID",
"msgtype": "news",
"news": {
"articles": [
{
"title": "100积分兑换咖啡券",
"description": "点击兑换星巴克咖啡券一张",
"url": "https://ipipp.com/exchange?id=1",
"picurl": "https://ipipp.com/images/coffee.jpg"
}
]
}
}
在组装图文消息时，要注意图文的数量限制，通常一条图文消息最多可以包含8条图文。如果可兑换的礼品超过这个数量，可以在图文消息的最后一条加上一个查看更多礼品的引导链接，指向完整的H5商城页面。此外，缩略图的大小和比例也需要符合微信的规范，以确保在手机端显示时不会变形或模糊。通过精心设计的图文消息，不仅能展示礼品信息，还能传递品牌的视觉形象，增强用户的信任感。