在小程序的实际运营中，用户完成下单后，往往希望实时了解订单的处理进度，例如“已支付”“备货中”“已发货”“已完成”等状态变化。传统的做法是让用户主动进入小程序、点击“我的订单”页面来查看。这种方式虽然可行，但存在两个明显不足：一是用户需要主动操作，体验不够流畅；二是当订单状态发生变化时，用户无法第一时间获知，容易产生焦虑或反复咨询客服。
为了解决这个问题，开发者可以利用小程序提供的“客服消息”能力，在订单状态发生变化时，主动向用户发送一条消息提醒。这种消息会出现在微信的“客服会话”列表中，用户点击后可以进入小程序查看详情，也可以直接回复消息与客服互动。
需要注意的是，客服消息并非可以随意发送。它有两个重要前提：第一，用户必须在最近 48 小时内曾向小程序的客服会话发送过消息（即触发过一次客服会话）；第二，每次用户消息可以回复最多 5 条客服消息。这意味着，我们不能在用户从未互动的情况下主动推送任何消息。因此，在设计订单状态推送方案时，需要引导用户在下单前或下单后主动发起一次客服咨询，或者利用用户已有的客服会话记录来发送后续的状态更新。
在开始编写代码之前，需要完成以下几项基础配置工作。
登录小程序管理后台，在左侧菜单中找到“功能”->“客服”。确保已经开通了客服消息功能。开通后，系统会自动分配一个客服账号，你也可以添加多名客服人员，并设置在线/离线状态。这一步通常在创建小程序时就已经完成，如果没有开通，按照页面提示操作即可。
在小程序管理后台的“开发”->“开发管理”->“开发设置”中，可以看到小程序的 AppID。AppSecret 需要点击“重置”或“生成”来获取，首次获取时会显示在页面上，请务必保存好。如果遗失，只能重置。AppSecret 用于调用微信接口时获取 access_token，非常重要，不能泄露在前端代码中。
如果你的订单状态变更逻辑发生在自己的后端服务器上（通常如此），需要在“开发”->“开发设置”->“服务器域名”中，配置“request 合法域名”为你后端 API 所在的域名。否则，小程序前端无法调用你后端的接口。
客服消息的推送需要通过微信的 HTTP API 来完成，基本流程如下：
后端服务器使用 AppID 和 AppSecret 换取 access_token（有效期通常为 2 小时，需要缓存并定时刷新）。
当订单状态发生变化时，后端根据用户的 openId，调用客服消息接口发送文本、图片或链接消息。
微信服务器收到请求后，将消息推送到用户的客服会话中。
后端的编程语言不限，这里以通用的思路来描述实现步骤，你可以根据自己熟悉的技术栈（例如 Python、Node.js、Java、PHP 等）进行编码。
access_token 是调用绝大多数微信接口的凭证。由于每个小程序每天获取 access_token 的次数有限（目前是 2000 次），并且每个 token 有效期为 7200 秒，因此不能每次发送消息都去获取一次，而应该将 token 缓存起来，在过期前重复使用。
实现逻辑如下：
首先检查缓存中是否存在有效的 access_token。可以将其存储在内存、文件或 Redis 中，记录下获取时间。
如果不存在或已过期，则调用接口 GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=你的APPID&secret=你的SECRET。
接口返回的数据中包含 access_token 和 expires_in（有效秒数）。将 token 保存下来，并记录当前时间戳。
下次调用时，判断当前时间是否小于“获取时间 + expires_in - 200 秒”（预留 200 秒安全边界），如果有效则直接使用缓存中的 token。
微信客服消息接口的地址为：POST https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
请求体为 JSON 格式，至少需要包含两个字段：touser（用户的 openId）和 msgtype（消息类型）。对于订单状态推送，通常使用文本消息（text）或链接消息（link）。
文本消息示例：
{
"touser": "用户openId",
"msgtype": "text",
"text": {
"content": "您的订单已发货，运单号：SF1234567890。点击进入小程序查看详情。"
}}链接消息示例：
{
"touser": "用户openId",
"msgtype": "link",
"link": {
"title": "订单状态更新",
"description": "您的订单已发货，点击查看物流信息",
"url": "https://yourdomain.com/order/detail?orderId=123",
"thumb_url": "https://yourdomain.com/thumb.jpg"
}}需要注意的是，链接消息中的 url 必须是已经配置到业务域名中的网址。如果希望用户点击后直接跳转到小程序内的某个页面，可以使用小程序卡片消息（miniprogrampage 类型），这种消息会直接打开小程序。
小程序卡片消息示例：
{
"touser": "用户openId",
"msgtype": "miniprogrampage",
"miniprogrampage": {
"title": "订单状态更新",
"pagepath": "pages/order/detail?orderId=123",
"thumb_media_id": "图片素材的media_id"
}}使用小程序卡片消息时，需要先通过素材管理接口上传一张图片（建议尺寸 520*416），获得 thumb_media_id。
通常，订单状态的变化发生在以下几种场景：
用户支付成功后（支付回调通知）
商家后台修改订单状态（发货、完成、取消等）
定时任务检查超时未支付自动取消
在这些业务逻辑处理完成后，判断该订单对应的用户是否满足客服消息发送条件。最简单的判断方式是：调用发送接口，如果微信返回错误码 45065（表示用户未在 48 小时内给客服发消息），则本次推送失败，可以记录下来稍后重试或放弃。更优雅的做法是在订单表中增加一个字段 last_customer_msg_time，记录用户最后一次向客服发消息的时间戳，只有当前时间距离该时间戳小于 48 小时才尝试发送。
由于客服消息的前提是用户必须先向客服会话发送过消息，因此前端需要设计一个合理的引导机制，确保大部分用户在订单生命周期内已经触发过客服会话。
在小程序的页面中，可以使用 来创建一个客服按钮。用户点击后，会直接打开客服会话界面，并且系统会自动发送一条“用户进入客服会话”的事件。这条事件会被视为用户发送了一条消息，从而满足后续 48 小时内可回复的条件。
建议在以下位置放置客服按钮：
订单详情页底部：方便用户在下单后对订单有疑问时直接咨询。
个人中心页面：作为常用的联系方式入口。
购物车页面或结算页面：用户在下单前可能咨询商品问题。
按钮的样式可以根据小程序的设计风格自定义，代码示例：
