wecomcli-message
查询当前可以发送消息的聊天会话范围,并向会话列表中的单聊或群聊发送文本、Markdown、图片、文件、语音、视频消息。用户要求“给某人发消息”“在某个群里通知”“给最近会话发消息”或“把图片/文件/语音/视频发到企业微信”时使用。
By wecomteam · 4,141 installs
npx skills add wecomteam/wecom-cli --skill wecomcli-message
Source repository · Upstream listing
企业微信发送消息
执行任何 wecom cli 命令前,必须先读取并完成 wecomcli shared 技能的公共前置检查。
1. 可以向授权人发送消息。
2. 可以向授权人以外的、机器人最近有消息往来的聊天会话(单聊和群聊)发送消息。
适用范围
适用
适用于给授权人发消息,使用 wecom cli identity whoami 获取授权人ID,可作为 chat id 使用,无需调用 sessions list 。
适用于查询当前有权限发送消息的聊天会话范围并给这些范围中的成员或群聊发送 Markdown 消息、图片、文件、AMR 语音或视频
不适用
发送对象不是授权人且不在本次 sessions list 返回结果中 → 告知用户当前只能向最近活跃的会话或授权人发送
技能依赖
调用依赖技能前,必须先完整读取对应 SKILL.md 。
依赖技能 触发场景 数据流向
wecomcli media 发送图片、文件、语音或视频时只有本地文件路径,没有可直接复用的 media id 包含媒体上传接口,如没有已有的 media id ,必须先阅读该技能获取 media id ,上传时传入的 type 应和发送时的 msg type 对齐
获取能发送消息的会话列表
命令
返回
字段 类型 说明
sessions array 会话列表,按最后一条消息时间从新到旧排序,具体数量以实际回包为准
sessions[].chat id string 会话 ID
sessions[].chat name string 群名称或单聊名称
sessions[].chat type string single 单聊或 group 群聊
sessions[].last msg time string 最后一条消息时间,格式 YYYY MM DD HH:MM:SS
sessions count integer sessions 数组元素数量
chat id 来源
向授权人以外的用户发送消息,调用 wecom cli message aibot send 前,需要先调用一次 sessions list ,然后从本次返回的 sessions[] 中选定目标项,把该项的 chat id 原样复制到 send.chat id 。
以下值都不能直接作为 send.chat id :
用户输入的 ID
之前轮次或历史上下文保存的 chat id
wecomcli contact 返回的 userid
根据姓名、群名或其他字段自行构造的值
这些值最多只能作为匹配线索;最终发送参数必须重新取自本次 sessions list 的匹配项。
目标会话匹配
聊天名称 :在本次 sessions[] 中按非空 chat name 精确匹配;不能精确匹配需要向用户反问确认发送目标,唯一命中时从匹配项复制 chat id 。
最近第一个/最近某个会话 :按 sessions[] 原始顺序选择用户明确指定的项。
用户提供 ID :只能与本次 sessions[].chat id 做完全相等校验;命中后仍从匹配项复制 chat id ,不能直接复用用户输入值。
匹配结果处理:
唯一匹配时继续发送。
多个聊天会话候选时,按返回顺序展示聊天名和最后消息时间,让用户选择。
用户完成选择后,必须重新调用 sessions list ,再用选定对象匹配当次返回值。
无匹配时停止发送,如实告知目标不在最近 10 个会话中;不要接受外部 chat id 绕过限制。
sessions count=0 时停止发送,告知当前没有可发送的最近会话。
展示会话列表时保持接口原始顺序;展示名称和时间,不展示内部 chat id 。
发送消息
前置条件
调用本接口前必须完成以下步骤:
1. 根据发送对象选择调用 wecom cli message aibot sessions list 获取 chat id 或 wecom cli identity whoami 获取授权人ID。
2. 在本次列表中唯一匹配目标。
3. 如果发送授权人以外的对象,从列表中匹配项原样复制 sessions[].chat id 。
4. 目标是媒体消息时,再准备对应的 media id 。
在目标会话匹配成功前,不上传媒体,也不调用 send 。
命令
公共参数
字段 类型 必填 说明
: :
chat id string 是 必须取自 wecom cli identity whoami 或当前发送流程中刚调用的 sessions list 返回的目标 sessions[].chat id
msg type string 是 markdown / image / file / voice / video
markdown object 条件必填 仅 msg type="markdown" 时传
image object 条件必填 仅 msg type="image" 时传
file object 条件必填 仅 msg type="file" 时传
voice object 条件必填 仅 msg type="voice" 时传
video object 条件必填 仅 msg type="video" 时传
每次请求必须且只能携带一个与 msg type 同名的内容对象。不要传空对象,也不要同时传多个消息对象。
Markdown 消息
markdown.content 必填,最长 20480 UTF 8 字节。普通文本也按 Markdown 发送。
图片消息
image.media id 必填,必须由媒体上传接口以 type=image 上传获得。
文件消息
file.media id 必填,必须由媒体上传接口以 type=file 上传获得;文件名取上传时的原始文件名。
语音消息
voice.media id 必填,必须由媒体上传接口以 type=voice 上传获得;源文件仅支持 AMR 格式,不能只改扩展名冒充 AMR。
视频消息
字段 必填 说明
: :
video.media id 是 由媒体上传接口以 type=video 上传获得
video.title 否 最长 128 UTF 8 字节;省略时使用上传时的原始文件名
video.description 否 最长 512 UTF 8 字节;省略时不展示描述
用户没有提供视频标题或描述时直接省略对应字段,不传空字符串,也不追问非必填字段。
关键约束
用户明确要求发送且目标与内容完整时直接执行,不重复追问确认;缺少目标、内容或本地文件时只追问缺失项。
连续发送多条时,不用每次 send 前都重新调用 sessions list 或 wecom cli identity whoami ,但连续发送中途上下文发生压缩时重新调用确保 chat id 正确。
chat id 、 userid 、 media id 都是内部调用值,禁止面向用户展示。
Markdown 正文、视频标题和描述限制按 UTF 8 字节数计算;超限时不静默截断,请用户缩短或明确同意拆分。
发送成功后只说明目标和消息类型,不编造消息 ID。
接口失败时如实转达错误,不使用 curl / Python 等方式绕过 wecom cli 。