WeCom Smart Bot Message Pushing: Proactive Messaging via Enterprise WeChat Intelligent Robot

前言

在企业微信里做通知类功能时,常见的做法是走自建应用的应用消息接口。这条路需要先创建应用、配置可信 IP、申请通讯录权限,流程不短。如果需求只是把通知、天气、提醒这类消息发出去,用企业微信的「智能机器人」(aibot)会更轻:不需要应用凭证,Bot ID 和 Secret 由用户动态提供,消息直接推到指定会话。

下面介绍的这个 Skill 就是做这件事的:它把「向企微智能机器人推送消息」封装成一个可被 Agent 调用的能力。

这是什么

这是一个社区来源的 Skill,坐标 @user_c14d983d/wecom-aibot-send,名称「企微智能机器人消息推送」,当前版本 1.0.0,分类为 ai-agent,发布者为 user_c14d983d,来源标记为 community。

它解决的问题是:Agent 需要把自定义消息经企业微信智能机器人主动发出时,不必自己研究企微接口细节,调用这个 Skill 即可。按 SkillHub 页面数据,该 Skill 评分为 100000,下载量 859。

核心功能

1、支持两种推送模式:

  • 已知会话 ID 直接推送。群聊用 chatid,单聊用 userid。
  • 不知会话 ID 时,通过监听自动捕获会话 ID,再完成推送。

2、凭证管理:Bot ID 和 Secret 由用户动态提供,且仅从环境变量读取,不写进任何文件。

3、适用的消息类型为通知、天气、提醒等主动推送场景。

安装与启用

该 Skill 采用通用 SKILL.md 格式,需通过 SkillHub 页面获取后在对应工具中使用。本文写作时 SkillHub 页面正文抓取失败,安装命令未核实到,具体安装方式以官方页面 https://www.skillhub.cn/skills/user_c14d983d/wecom-aibot-send 为准。

启用前需准备凭证,做法是把 Bot ID 和 Secret 放进环境变量,不要把凭证写进配置文件或代码仓库。例如:

export WECOM_AIBOT_BOT_ID="<你的 Bot ID>"
export WECOM_AIBOT_SECRET="<你的 Secret>"

变量名以 Skill 实际读取的名称为准。凭证只通过环境变量传递,这是该 Skill 明确要求的约束。

典型用法

以下用法来自该 Skill 的官方简介,未核实到可复现的命令行示例。

1、已知会话 ID 的直接推送。适用于群聊或单聊场景:把自定义消息内容和目标会话 ID 提供给 Skill,由智能机器人把消息发出去。

2、未知会话 ID 的监听捕获。适用于还不清楚目标会话 ID 的情况:先发起一次交互让 Skill 监听并捕获会话 ID,之后再用捕获到的 ID 完成推送。

适用场景与注意

适合需要经企业微信智能机器人主动发出通知、天气、提醒等消息的场景,尤其是 Agent 流程里触发一次性推送。

需要注意的几点:

1、凭证是动态提供且仅从环境变量读取,运行环境必须能访问这些环境变量,否则调用会失败。
2、该 Skill 标注了 requires_api_key=true,说明调用依赖密钥类凭证,需先完成凭证配置。
3、它的来源是 community,功能以官方简介为准;安装命令、字段细节本文未能核实,使用前建议先打开官方页面确认。

结尾

这个 Skill 的价值在于把企微智能机器人主动推送消息这件事收敛成一步:给 Bot ID 和 Secret(走环境变量),给消息内容和会话 ID,消息即发出;不知道会话 ID 时还能靠监听捕获。对通知、提醒类的小需求,比走自建应用更省事。

官方地址:https://api.skillhub.cn/user_c14d983d/wecom-aibot-send
页面地址:https://www.skillhub.cn/skills/user_c14d983d/wecom-aibot-send

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye