- 数据统计
- 互动服务窗
- 获取年报数据
- 查询企业内部群信息GET
消息群发
POST
http://127.0.0.1/topapi/message/mass/send
最后修改时间：2022-08-30 09:19:24
责任人：未设置
说明#
服务地址：https://oapi.dingtalk.com
权限#
| 应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
|---|---|---|---|
| 企业内部应用 | 是 | 开发者后台申请 | 调试 |
| 第三方企业应用 | 否 | — | — |
| 第三方个人应用 | 否 | — | — |
错误码#
| 错误码 | 说明 | 排查方法 |
|---|---|---|
| 800003 | unionid不合法 | 传入有效的服务号unionid。 |
| 800013 | 群发消息太过频繁，请稍后再试 | 调整发送频次，稍后重试。 |
| 800014 | 群发消息次数超过今日限制 | 当天群发次数额度用完了，明天再来。 |
| 800017 | 向该用户发送单聊次数超过今日限制 | 单人定向推送时，单日限制100次。 |
| 800019 | 接收人列表为空 | 检查是否漏传了userid_list和dep_id_list。 |
| 800020 | 消息参数错误 | 检查消息内容msg_type、media_id、text_content、msg_body等字段的格式是否正确。 |
| 800022 | userId列表不合法 | 检查传入的userid_list是否有效。 |
| 800035 | uuid重复 | 检测到重复请求，该uuid已经用过了。 |
| 800038 | uuid不能为空 | 必填字段不能为空。 |
| 800039 | 用户列表长度超过限制 | 单次不能超过1000个。 |
| 800040 | 部门列表长度超过限制 | 单次不能超过1000个。 |
| 800055 | 服务号发消息qps超过限制 | 接口调用太快，稍后重试，注意重试时更换uuid。 |
| 800056 | 服务号发消息qpm超过限制 | 接口调用太快，稍后重试，注意重试时更换uuid。 |
| 800057 | 服务号今日发消息总人次超过限制：组织人数 * 50 | 当天群发人次额度用完了，明天再来。 |
请求参数
Query 参数
Body 参数application/json
示例
{
"is_to_all": false,
"dep_id_list": [
1958658,
2324553
],
"unionid": "IlrIsTHaiSYXluZP61h0zxgiEiE",
"is_preview": true,
"text_content": "hello",
"msg_body": {
"voice": {
"duration": 1,
"media_id": "@lALPDeC2uOPVEsvNAVjNAVg"
},
"oa": {
"head": {
"bgcolor": "11111111",
"text": "head text"
},
"pc_message_url": "https://dingtalk.com",
"body": {
"file_count": 2,
"image": "@lALPDeC2uOPVEsvNAVjNAVg",
"form": {
"value": "value1",
"key": "key1"
},
"author": "rick",
"rich": {
"unit": "kg",
"num": "10"
},
"title": "titile",
"content": "hello"
},
"message_url": "https://dingtalk.com"
},
"file": {
"media_id": "@lALPDeC2uOPVEsvNAVjNAVg"
},
"action_card": {
"single_url": "https://dingtalk.com",
"button_list": {
"action_url": "btn_action_url1",
"title": "btn_title1"
},
"btn_orientation": "0",
"single_title": "single title",
"markdown": "markdown text",
"title": "title"
},
"link": {
"text": "hello",
"pic_url": "@lALPDeC2uOPVEsvNAVjNAVg",
"title": "hello title",
"message_url": "https://dingtalk.com"
},
"markdown": {
"text": "markdown text",
"title": "title"
}
},
"media_id": "",
"msg_type": "action_card",
"uuid": "48566508-3fdsfsfdgdsd",
"userid_list": "10203029011219896,manager4220"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://127.0.0.1/topapi/message/mass/send?access_token=30c9a84136943eaxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"is_to_all": false,
"dep_id_list": [
1958658,
2324553
],
"unionid": "IlrIsTHaiSYXluZP61h0zxgiEiE",
"is_preview": true,
"text_content": "hello",
"msg_body": {
"voice": {
"duration": 1,
"media_id": "@lALPDeC2uOPVEsvNAVjNAVg"
},
"oa": {
"head": {
"bgcolor": "11111111",
"text": "head text"
},
"pc_message_url": "https://dingtalk.com",
"body": {
"file_count": 2,
"image": "@lALPDeC2uOPVEsvNAVjNAVg",
"form": {
"value": "value1",
"key": "key1"
},
"author": "rick",
"rich": {
"unit": "kg",
"num": "10"
},
"title": "titile",
"content": "hello"
},
"message_url": "https://dingtalk.com"
},
"file": {
"media_id": "@lALPDeC2uOPVEsvNAVjNAVg"
},
"action_card": {
"single_url": "https://dingtalk.com",
"button_list": {
"action_url": "btn_action_url1",
"title": "btn_title1"
},
"btn_orientation": "0",
"single_title": "single title",
"markdown": "markdown text",
"title": "title"
},
"link": {
"text": "hello",
"pic_url": "@lALPDeC2uOPVEsvNAVjNAVg",
"title": "hello title",
"message_url": "https://dingtalk.com"
},
"markdown": {
"text": "markdown text",
"title": "title"
}
},
"media_id": "",
"msg_type": "action_card",
"uuid": "48566508-3fdsfsfdgdsd",
"userid_list": "10203029011219896,manager4220"
}'返回响应
🟢200成功
application/json
Body
示例
{
"errmsg": "string",
"errcode": 0,
"task_id": "string",
"": "string"
}
修改于 2022-08-30 09:19:24