# 消息推送

**Repository Path**: Wuzk_97/message-push

## Basic Information

- **Project Name**: 消息推送
- **Description**: 集成各类消息推送
- **Primary Language**: Python
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-09
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 消息推送服务

支持飞书、钉钉、企业微信、Telegram、Slack 的消息推送中间层服务。

## 一、部署配置启动

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 配置

```bash
cp .env.example .env
```

编辑 `.env` 文件，填入配置（至少配置一个即可）：

| 平台 | 配置项 |
|------|--------|
| 飞书 | `FEISHU_WEBHOOK_URL`、`FEISHU_SECRET` |
| 钉钉 | `DINGTALK_WEBHOOK_URL`、`DINGTALK_SECRET` |
| 企业微信 | `WECOM_WEBHOOK_URL` |
| Telegram | `TELEGRAM_WEBHOOK_URL`（格式：`bot<token>:<chat_id>`） |
| Slack | `SLACK_WEBHOOK_URL` |

### 3. 启动服务

```bash
python app.py
```

或：

```bash
uvicorn app:app --host 0.0.0.0 --port 5000 --reload
```

## 二、项目结构

```
message-push/
├── app.py                  # 主入口
├── requirements.txt        # 依赖
├── .env.example           # 环境变量示例
├── README.md              # 本文档
├── 接口文档.md             # 详细API文档
└── src/                   # 源码目录
    ├── config/            # 配置管理
    │   └── settings.py
    ├── models/            # 数据模型
    │   └── schemas.py
    ├── senders/           # 消息发送器
    │   ├── base.py        # 发送器基类
    │   ├── factory.py     # 发送器工厂
    │   ├── feishu.py      # 飞书
    │   ├── dingtalk.py    # 钉钉
    │   ├── wecom.py       # 企业微信
    │   ├── telegram.py    # Telegram
    │   └── slack.py       # Slack
    └── api/               # API路由
        └── routes.py
```

## 三、接口列表

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/send` | 发送飞书消息 |
| POST | `/api/dingtalk/send` | 发送钉钉消息 |
| POST | `/api/wecom/send` | 发送企业微信消息 |
| POST | `/api/telegram/send` | 发送 Telegram 消息 |
| POST | `/api/slack/send` | 发送 Slack 消息 |
| GET | `/api/health` | 健康检查 |
| GET | `/` | 服务信息 |

### 请求示例

```json
{
    "title": "告警通知",
    "content": "**支持 Markdown 格式**",
    "status": "error"
}
```

### curl 测试

```bash
curl -X POST http://localhost:5000/api/send \
  -H "Content-Type: application/json" \
  -d '{"title": "告警", "content": "**CPU过高**", "status": "error"}'
```