feat: add send many account mode
This commit is contained in:
+51
-8
@@ -51,6 +51,33 @@ POST /api/v1/message/send
|
||||
@提醒功能仅在支持的渠道(钉钉、企业微信)中生效。
|
||||
:::
|
||||
|
||||
### 动态接收者参数(可选)🆕
|
||||
|
||||
| 参数 | 类型 | 必填 | 说明 |
|
||||
|------|------|------|------|
|
||||
| recipients | array | 否 | 动态接收者列表,如 `["user1@example.com", "user2@example.com"]` |
|
||||
|
||||
::: tip 群发模式
|
||||
动态接收者功能允许在 API 调用时指定接收者列表,实现群发功能。
|
||||
|
||||
**支持的渠道:**
|
||||
- ✅ **邮件** - 支持多个收件人,实现邮件群发
|
||||
- ✅ **微信公众号** - 支持多个 OpenID,实现公众号群发
|
||||
|
||||
**使用条件:**
|
||||
1. 任务实例必须配置为"动态接收者模式"
|
||||
2. 一个任务只能配置一个动态接收实例
|
||||
3. 动态接收实例不能与固定接收实例混合使用
|
||||
|
||||
**配置方式:**
|
||||
在任务编辑页面,添加实例时勾选"动态接收者模式",此时无需配置固定接收者。
|
||||
|
||||
**注意事项:**
|
||||
- 如果任务配置了动态接收实例,`recipients` 参数为必填
|
||||
- 不支持动态接收的渠道会忽略此参数
|
||||
- 建议控制接收者数量,避免触发渠道限流
|
||||
:::
|
||||
|
||||
## 请求示例
|
||||
|
||||
### 基本示例(纯文本)
|
||||
@@ -88,6 +115,22 @@ POST /api/v1/message/send
|
||||
}
|
||||
```
|
||||
|
||||
### 动态接收者示例(群发)🆕
|
||||
|
||||
```json
|
||||
{
|
||||
"token": "a3541c2f0d3e1b4a5c6d7e8f9a0b1c2d3e",
|
||||
"title": "系统维护通知",
|
||||
"text": "系统将于今晚22:00进行维护,预计持续2小时。",
|
||||
"html": "<h2>系统维护通知</h2><p>系统将于今晚<strong>22:00</strong>进行维护,预计持续<strong>2小时</strong>。</p>",
|
||||
"recipients": [
|
||||
"user1@example.com",
|
||||
"user2@example.com",
|
||||
"user3@example.com"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### cURL 示例
|
||||
|
||||
```bash
|
||||
@@ -258,14 +301,14 @@ V1 API 支持三种消息格式,系统会根据任务实例配置的格式类
|
||||
|
||||
## 支持的推送渠道
|
||||
|
||||
| 渠道 | 支持格式 | @提醒 | 说明 |
|
||||
|------|---------|------|------|
|
||||
| **邮件** | Text, HTML | ❌ | SMTP邮件发送,推荐使用 HTML 格式 |
|
||||
| **钉钉** | Text, Markdown | ✅ | 钉钉机器人,支持 Markdown 富文本 |
|
||||
| **企业微信** | Text, Markdown | ✅ | 企业微信机器人,支持 Markdown |
|
||||
| **微信公众号** | Text | ❌ | 微信测试公众号模板消息 |
|
||||
| **自定义Webhook** | Text, HTML, Markdown | ❌ | 自定义HTTP请求,格式取决于配置 |
|
||||
| **自托管消息** | Text, HTML, Markdown | ❌ | 站内消息,支持多种格式 |
|
||||
| 渠道 | 支持格式 | @提醒 | 动态接收者 | 说明 |
|
||||
|------|---------|------|-----------|------|
|
||||
| **邮件** | Text, HTML | ❌ | ✅ | SMTP邮件发送,支持群发多个收件人 |
|
||||
| **钉钉** | Text, Markdown | ✅ | ❌ | 钉钉机器人,支持 Markdown 富文本 |
|
||||
| **企业微信** | Text, Markdown | ✅ | ❌ | 企业微信机器人,支持 Markdown |
|
||||
| **微信公众号** | Text | ❌ | ✅ | 微信测试公众号,支持多个 OpenID 群发 |
|
||||
| **自定义Webhook** | Text, HTML, Markdown | ❌ | ❌ | 自定义HTTP请求,格式取决于配置 |
|
||||
| **自托管消息** | Text, HTML, Markdown | ❌ | ❌ | 站内消息,支持多种格式 |
|
||||
|
||||
## 使用流程
|
||||
|
||||
|
||||
Reference in New Issue
Block a user