Sender 的回复目标。你需要指定目标 IM、群或用户。群推送传 groupCode;私聊推送传 userID。
函数总览
push(imType, groupCode, userID, title, content, options?, timeout?)
string
必填
目标 IM 类型,例如
qq、weixin、qx,以已启用适配器为准。string
必填
群 ID / 群号。群推送必填;私聊传空字符串。
string
必填
用户 ID。私聊推送必填;群推送可传空字符串。
string
必填
推送标题或备注。文本推送中如果
content 为空,会用 title 作为文本。string
必填
文本内容。运行时也兼容
text / message 字段,但 helper 固定传 content。object
可选扩展字段。
middleware.js 会把该对象浅合并到顶层请求体。string
目标账号 ID。也可写作
accountID 或 accountId。显式传入时优先级最高。number
默认值:"5000"
请求超时时间,单位毫秒。
推送账号选择
以下规则适用于push(...)、pushImage(...)、pushVoice(...)、pushVideo(...)、pushFile(...) 和 pushMixed(...)。
选择规则:
- 如果
options中有account_id,使用它。 - 如果是消息触发,并且目标 IM 与当前会话 IM 一致,默认使用当前会话账号。
- 如果是 cron / fake,使用目标 IM 的默认账号。
- 如果跨 IM 推送,使用目标 IM 的默认账号。
- 如果目标 IM 没有默认账号,运行时会选择第一个在线可发送账号;没有可发送账号时返回
0或抛出适配器离线错误。
媒体推送
返回值
主动推送函数返回数字,表示运行时认为发送成功的目标数。1:通常表示已提交给一个目标。0:通常表示没有可用适配器、目标无效或未发送。- 适配器请求失败时可能抛出
Error。
mixed items
pushMixed(...) 的 items 与 replyMixed(...) 相同:支持 text、markdown、image、voice、video、file。
下一步
运行上下文
查看消息、cron、路由和跨 IM 的上下文差异。
媒体文件
查看媒体来源、下载和用户上传文件处理。