批量发送消息
POST
/message/v4/batch_send/
注意事项：
{
"open_ids": [
"ou_a18fe85d22e7633852d8104226e99eac",
"ou_9204a37300b3700d61effaa439f34295"
],
"department_ids": [
"od-5b91c9affb665451a16b90b4be367efa"
],
"msg_type": "post",
"content": {
"post":{
"zh_cn": {
"title": "我是一个标题",
"content": [
[{
"tag": "text",
"text": "第一行"
},
{
"tag": "a",
"href": "http://www.feishu.cn",
"text": "飞书"
}
]
]
},
"en_us": {
"title": "I am a title",
"content": [
[{
"tag": "text",
"text": "first line"
},
{
"tag": "a",
"href": "http://www.feishu.cn",
"text": "feishu"
}
]
]
}
}
}
} {
"open_ids": [
"ou_a18fe85d22e7633852d8104226e99eac",
"ou_9204a37300b3700d61effaa439f34295"
],
"department_ids": [
"od-5b91c9affb665451a16b90b4be367efa"
],
"msg_type": "image",
"content": {
"image_key": "img_v2_8e5a80ec-4d94-4bb2-84d5-e25d6c28dacj"
}
} {
"open_ids": [
"ou_a18fe85d22e7633852d8104226e99eac",
"ou_9204a37300b3700d61effaa439f34295"
],
"department_ids": [
"od-5b91c9affb665451a16b90b4be367efa"
],
"msg_type": "share_chat",
"content": {
"share_chat_id": "oc_84983ff6516d731e5b5f68d4ea2e1da5"
}
} {
"open_ids": [
"ou_a18fe85d22e7633852d8104226e99eac",
"ou_9204a37300b3700d61effaa439f34295"
],
"department_ids": [
"od-5b91c9affb665451a16b90b4be367efa"
],
"msg_type": "interactive",
"card": {
"config": {
"wide_screen_mode": true
},
"elements": [
{
"tag": "div",
"fields": [
{
"is_short": true,
"text": {
"tag": "lark_md",
"content": "**🗳工单来源：**\n报事报修"
}
},
{
"is_short": true,
"text": {
"tag": "lark_md",
"content": "**📝工单类型：**\n客服工单"
}
}
]
}
],
"header": {
"template": "turquoise",
"title": {
"content": "📚晒挚爱好书，赢读书礼金",
"tag": "plain_text"
}
}
}
} 错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 10002 | Create or send message fail. | 创建或发送消息失败，请参考请求返回的error信息检查消息格式。 |
| 400 | 10003 | Invalid parameter. | 请求参数缺失或者有误，更多错误信息请参考请求返回的error message。 |
| 400 | 11101 | Open_id not exist. | Open User ID非法。 |
| 400 | 11203 | Send employee ids permission denied. | 发送 employee id 信息失败，请确保在开发者后台已经设置了获取Employee ID的选项。 |
| 400 | 11204 | Send department list permission denied. | 发送部门列表失败，请确保在开发者后台已经设置了获取Department ID的选项。 |
| 400 | 11205 | App do not have bot. | 应用没有开启机器人能力，请确保在应用后台开通了机器人能力。 |
| 400 | 11207 | App is not usage. | 应用在当前租户下不可用，请在开 发者后台检查应用的状态。 |
| 400 | 11209 | App not exist. | 应用不存在。 |
| 400 | 11210 | App usage info not exist. | 应用在当前租户下未安装，不可使用，联系租户管理员，确认应用安装状态。 |
| 400 | 11223 | Do not have im write permission. | 当前操作者没有发送消息的权限，请开通权限后发起请求。 |
| 400 | 11227 | Image key not exist. | Image Key非法。 |
| 400 | 11231 | Chat not found. | 请求的会话不存在。 |
| 400 | 11235 | This group is set to only admin can mention @All. | 当前会话禁止@所有人操作。 |
| 400 | 11246 | Create message content fail. | 创建消息内容失败，更多错误信息请参考请求返回的error message。 |
| 400 | 11247 | Internal send message trigger rate limit. | 请求触发频控，请参考频控策略。 |
| 400 | 11312 | Bot messages do not pass the audit. | 消息内容不合法，请检查消息内容。 |
请求参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/message/v4/batch_send/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"department_ids": [
"3dceba33a33226",
"d502aaa9514059"
],
"open_ids": [
"ou_18eac85d35a26f989317ad4f02e8bbbb",
"ou_461cf042d9eedaa60d445f26dc747d5e"
],
"user_ids": [
"7cdcc7c2",
"ca51d83b"
],
"union_ids": [
"on_cad4860e7af114fb4ff6c5d496d1dd76",
"on_gdcq860e7af114fb4ff6c5d496dabcet"
],
"msg_type": "text",
"content": {
"text": "test content"
}
}'响应示例响应示例
{
"code": 0,
"msg": "ok",
"data": {
"invalid_department_ids": [
"d502aaa9514059"
],
"invalid_open_ids": [
"ou_456e168d61cec276083b357f7bd3f1491",
"ou_f8cbdb26fb2e4eda075e003381a102a41"
],
"invalid_user_ids": [
"7cdcc7c22"
],
"invalid_union_ids": [
"on_cad4860e7af114fb4ff6c5d496d1dd76",
"on_gdcq860e7af114fb4ff6c5d496dabcet"
],
"message_id": "bm-d4be107c616aed9c1da8ed8068570a9f"
}
}
扫码加入交流群修改于 2025-10-20 10:10:02