appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"发送待发送的群发任务。id 取自「查询待发群发」。
/qingluan/api/message/groupSendPending发送待发送的群发任务。id 取自「查询待发群发」。
⚠️ 超过一年的任务会被拒绝。
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type:application/json
请求参数。字段名区分大小写,请按文档原样传递。
appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"idint64必填对象 ID。发消息返回时即 serverMsgId(撤回要用);上传返回时即 fileId(发送/下载要用);列表项中为该条记录 ID
注意:应指向一条已存在的待发送记录(来源为 /api/message/getPendingGroupSendList)。该列表为空,无合法 id 可用,只能传 0 试探——因此本次失败不足以判定接口本身有问题。
117159486110430460contentListobject[]必填消息内容列表。元素为 {contentType, content, appInfo},其中 content 本身是数组,如 [{"type": 0, "text": "内容"}]。
数组元素 · object
contentTypeint64必填内容类型。0=文本 14=图片(完整枚举见平台「企微错误码」章节)
字段示例:0contentobject[]必填内容
消息/动态正文。纯文本类接口传字符串;媒体类传对象(把上传接口返回的 data 整体带上)
数组元素 · object
typeint64必填类型
内容片段类型:0 文本、3 表情;其他值以平台定义为准。
0textstring必填文本内容。
字段示例:"坎坎坷坷"appInfostring必填企微内部应用标识,透传字段,无需处理
字段示例:"CAQQiaO51AYY4Y+oq5SAgAMg56GIsQQ="conversationTypeint64必填会话类型
注意:传 1,取值语义未确认。参考:getGroupSendRecord 返回的历史记录中该字段为 0(对应私聊群发场景)。
0本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。
发送后通过拉取消息复核。超时或网络中断时,先确认结果,再决定是否重试,避免重复消息。
能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。
application/json
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码:0 表示成功,-1 表示失败;失败原因见 message。
0dataobject可选业务数据
接口无固定结构化返回数据;成功时通常为空对象或省略 data。
detailstring可选错误详情
错误详情;无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok;企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间,格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"受控接口,需通过控制台配置
appid 不存在或无权访问