微信服务平台接口实战：Postman 调试自定义菜单、自动回复与关键词回复

原创已于 2025-12-03 10:21:34 修改 · 506 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#微信 #postman

于 2025-12-03 10:20:19 首次发布

移动端架构专栏收录该内容

14 篇文章

订阅专栏

微信公众号的自定义菜单、关注自动回复、关键词回复是提升用户交互体验的核心功能，通过微信开放接口可实现这些功能的程序化配置，无需依赖后端代码，仅用 Postman 即可完成调试。本文将以「美食推荐公众号」为例，完整演示如何通过 Postman 调用微信接口配置上述功能。

一、前置准备

1. 核心前提

已完成微信服务号 / 订阅号（需认证）的开发者配置：登录微信公众平台→「设置与开发」→「基本配置」，获取AppID和AppSecret；开启「服务器配置」（暂无需填写实际服务器地址，仅需启用开发者模式）。
Postman 工具：下载并安装 Postman（免费版即可），用于发送 HTTP 请求。

2. 获取接口调用凭证（access_token）

所有微信接口调用均需依赖access_token（有效期 2 小时），首先通过AppID和AppSecret获取：

请求信息

请求方式：GET
请求 URL：

https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=你的AppID&secret=你的AppSecret

Postman 操作

新建 GET 请求，粘贴上述 URL，替换你的AppID和你的AppSecret；
点击「Send」发送请求，返回结果示例：

{
  "access_token": "1234567890abcdefghijklmnopqrstuvwxyz",
  "expires_in": 7200
}

复制access_token，后续所有接口均需使用。

二、接口实战：配置核心功能

案例背景

「美食推荐公众号」需求：

自定义菜单：包含「今日推荐」「美食分类」「联系我们」3 个一级菜单，「美食分类」下分「川菜」「粤菜」「湘菜」3 个二级菜单；
关注自动回复：用户关注后自动发送「欢迎关注美食推荐！回复 “川菜” 获取热门川菜菜谱～」；
关键词回复：用户回复「川菜」触发「麻婆豆腐、水煮鱼、回锅肉」，回复「粤菜」触发「白切鸡、叉烧、肠粉」。

1. 配置自定义菜单

接口说明

请求方式：POST
请求 URL：

https://api.weixin.qq.com/cgi-bin/menu/create?access_token=你的access_token

请求体（JSON 格式）：按微信菜单接口规范构造，示例如下：

{
  "button": [
    {
      "name": "今日推荐",
      "type": "click",
      "key": "today_recommend"
    },
    {
      "name": "美食分类",
      "sub_button": [
        {
          "name": "川菜",
          "type": "click",
          "key": "food_sichuan"
        },
        {
          "name": "粤菜",
          "type": "click",
          "key": "food_guangdong"
        },
        {
          "name": "湘菜",
          "type": "click",
          "key": "food_hunan"
        }
      ]
    },
    {
      "name": "联系我们",
      "type": "view",
      "url": "https://www.meishituijian.com/contact"
    }
  ]
}

Postman 操作

新建 POST 请求，粘贴上述 URL 并替换你的access_token；
切换到「Body」→「raw」→ 选择「JSON」格式，粘贴上述 JSON 请求体；
点击「Send」，返回{"errcode":0,"errmsg":"ok"}即配置成功；
关注公众号后，即可看到配置的自定义菜单。

2. 配置关注自动回复

接口说明

微信的自动回复接口需通过「自定义回复规则」配置，关注回复属于「事件回复」，需先创建回复规则：

请求方式：POST
请求 URL：

https://api.weixin.qq.com/cgi-bin/reply/set_auto_reply?access_token=你的access_token

请求体（JSON 格式）：

{
  "rule": {
    "is_add_rule": true,
    "rule_name": "关注自动回复",
    "keyword_list_info": [],
    "reply_mode": "reply_all",
    "type": "event",
    "event_type": "subscribe"
  },
  "reply_list_info": [
    {
      "type": "text",
      "content": "欢迎关注美食推荐！回复“川菜”获取热门川菜菜谱～"
    }
  ]
}

Postman 操作

新建 POST 请求，替换 URL 中的access_token；
Body 选择 JSON，粘贴上述请求体；
发送请求，返回{"errcode":0,"errmsg":"ok"}即配置成功；
用新微信账号关注公众号，即可收到配置的关注回复。

3. 配置关键词回复

接口说明

关键词回复需创建「关键词规则」，支持精准匹配 / 模糊匹配，以下配置「川菜」「粤菜」两个关键词的回复：

请求方式：POST
请求 URL：

https://api.weixin.qq.com/cgi-bin/reply/add?access_token=你的access_token

配置「川菜」关键词回复（请求体）

{
  "rule": {
    "is_add_rule": true,
    "rule_name": "川菜关键词回复",
    "keyword_list_info": [
      {
        "keyword": "川菜",
        "match_mode": "exact" // exact精准匹配，contain模糊匹配
      }
    ],
    "reply_mode": "reply_all",
    "type": "text"
  },
  "reply_list_info": [
    {
      "type": "text",
      "content": "热门川菜推荐：麻婆豆腐、水煮鱼、回锅肉"
    }
  ]
}

配置「粤菜」关键词回复（请求体）

{
  "rule": {
    "is_add_rule": true,
    "rule_name": "粤菜关键词回复",
    "keyword_list_info": [
      {
        "keyword": "粤菜",
        "match_mode": "exact"
      }
    ],
    "reply_mode": "reply_all",
    "type": "text"
  },
  "reply_list_info": [
    {
      "type": "text",
      "content": "热门粤菜推荐：白切鸡、叉烧、肠粉"
    }
  ]
}

Postman 操作

新建两个 POST 请求（分别配置川菜、粤菜关键词），替换 URL 中的access_token；
分别粘贴对应请求体，发送请求；
关注公众号后回复「川菜」「粤菜」，即可收到对应的关键词回复。

三、常见问题排查

access_token失效：重新调用 token 接口获取，注意有效期 2 小时；
接口返回errcode:40001：AppID/AppSecret 错误，或 access_token 无效；
自定义菜单不显示：公众号需认证（订阅号未认证无法配置菜单），或需重新关注公众号刷新；
关键词回复不触发：检查match_mode（精准 / 模糊），或关键词规则名称重复。

四、总结

通过 Postman 调用微信开放接口，无需编写后端代码即可完成自定义菜单、关注自动回复、关键词回复的配置。核心步骤为：获取access_token→ 按接口规范构造 JSON 请求体 → 发送 POST 请求。需注意接口的权限限制（如订阅号未认证无法配置自定义菜单）、access_token的有效期，以及请求体的格式规范。掌握这些接口调试方法，可快速完成公众号交互功能的配置，适配不同的运营需求。