SuperAPI AI 工具集

wecomcli-message

办公与效率

查看项目

更新于 10-16 09:29

技能介绍

用途:查询当前可发送消息的聊天会话范围,并向授权人或机器人最近有消息往来的单聊、群聊发送消息。适用于“给某人发消息”“在某个群里通知”“给最近会话发消息”或发送图片、文件、语音、视频到企业微信的场景。

使用方式:这是插件提供的 tool,不是终端命令,须通过调用该 tool 完成,参数用 args 传入,禁止用 exec、shell 等命令行方式使用。首次调用前须按 wecomcli-preflight 技能做前置条件检查,确保工具已在白名单。发消息给授权人时,用 wecom-cli identity whoami 获取授权人 ID 作 chat_id,无需调 sessions list。发消息给授权人以外的会话时,先调用 wecom-cli message aibot sessions list,从本次返回的 sessions[] 唯一匹配目标,把该 chat_id 复制到 send.chat_id;用户输入的 ID、历史 chat_id、contact 返回的 userid 都不能直接作为 send.chat_id,只能作匹配线索。无匹配或 sessions_count=0 时停止发送并如实告知。媒体消息需先按 wecomcli-media 技能上传取得 media_id,type 与 msg_type 对齐。

发送接口:wecom-cli message aibot send --json '<JSON 参数>'。公共参数 chat_id、msg_type 必填,msg_type 为 markdown/image/file/voice/video,每次必须且只能携带一个与 msg_type 同名的内容对象。Markdown content 最长 20480 UTF-8 字节;image/file/voice/video 需对应 media_id,语音源文件仅支持 AMR。

限制:chat_id、userid、media_id 为内部值,禁止向用户展示;字节限制超限不静默截断;失败时如实转达错误,不得用 curl、Python 绕过。连发多条无需每次重新查会话,但上下文压缩后需重新获取 chat_id。发送成功只说明目标和类型,不编造消息 ID。