企微智能機器人消息推送:經企業微信智能機器人主動發消息

前言

在企業微信裏做通知類功能時,常見的做法是走自建應用的應用消息接口。這條路需要先創建應用、配置可信 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

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

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

小夜