企业微信二次开发：外部群机器人文本消息发送实践

搞企微外部群机器人，文本消息下发绝对是出场率最高的动作。不管是新客户进群自动触发欢迎语、每天定时推送业务早报，还是对接 AI 大模型实现社群自动答疑，全都要靠这个最基础的接口来兜底。

今天咱们不聊虚的架构，直接翻开底层协议，手把手教你怎么把一段文字精准推送到指定的外部客户群里。

瞄准靶心：拿到目标群聊ID

你要向群里发消息，第一步得先有个明确的"收件地址"。企业微信的底层网关是不认识诸如"VIP售后1群"这种中文名字的，它只认由系统生成的群唯一标识。

通常你有两种途径拿到它：

被动监听 ：通过 Webhook 回调监听群内的聊天或进群事件，从报文中提取 ChatId。
主动拉取：调用"获取外部群列表"接口，遍历拿到目标群的 ID。

拿到这个类似 wr_xxxxxxxxxxxxxxxxxxxx 格式的字符串后，先把它存进变量里备用。

组装 JSON 报文，准备开火

发消息的本质，就是向业务网关发起一个带有特定请求头的 HTTP POST 请求。为了确保字段万无一失，写代码前建议先查阅官方的字段规范。

来看一个标准的纯文本消息载荷：

JSON

复制代码

{
    "instance_guid": "inst_xxxxxxxxxxxx",
    "conversationId": "wr_xxxxxxxxxxxxxxxxxxxx",
    "msgtype": "text",
    "text": {
        "content": "大家好，我是本群的专属技术客服！\n如有任何API对接问题，欢迎随时在群内提问。"
    }
}

关键参数踩坑点：

conversationId：这里填入你刚才拿到的群聊 ID。
msgtype：必须死死写成 text。
content：你的消息正文。注意，如果你想在消息里换行，不要用 HTML 的 <br>，必须使用标准的转义字符 \n。

高阶玩法：如何在群里精准 @ 客户？

在外部客户群里做自动答疑，如果机器人只是干巴巴地把答案扔出来，提问的客户很容易漏看。我们通常需要机器人像真人一样，带上 @提问者 的标识。

实现这个功能非常简单，不需要在 content 里面硬拼客户名字。你只需要在 JSON 的 text 对象里，加上一个 mentioned_list（提醒列表）字段，并把目标客户的 ID 扔进去即可：

JSON

复制代码

{
    "instance_guid": "inst_xxxxxxxxxxxx",
    "conversationId": "wr_xxxxxxxxxxxxxxxxxxxx",
    "msgtype": "text",
    "text": {
        "content": "您的接口配额已刷新，请登录后台查看。",
        "mentioned_list": ["wm_xxxxxxxxxxxxxxxxxxxx"] 
    }
}

把这段 JSON 发出去，企微客户端就会自动将该客户的昵称高亮显示为蓝色的 @客户名，并给他的手机弹送一条强提醒。

研发效率与排错建议

1. 告别代码盲写，先上工具联调 遇到接口报错（比如 400 参数格式错误），千万别在几千行的业务代码里找 Bug。直接把官方 API文档导入到 Apifox 等结构化测试工具中。把你写的这串 JSON 丢进去跑一次。工具里能发出消息，就说明是你的后端代码在序列化 JSON 时出了偏差（比如少了引号、转义失败）。

2. 敬畏风控，别做"群轰炸机" 文本消息接口虽然调用简单，但千万不要写个死循环去群里做毫无意义的刷屏。频繁的无用下发极易触发企业微信的安全风控机制，导致你的机器人账号被限制甚至直接踢下线。如果是推送业务通知，建议做好频率控制（如加入 Redis 漏桶限流）。

理清了上面这些结构和限制，外部群的文本发送就是一层窗户纸。把文本发通了，后续再换成发图片、发小程序，也就是改个 msgtype 的事了。如果在参数组装上遇到奇葩报错，欢迎在评论区贴出 JSON 一起交流！