vault backup: 2026-07-29 14:26:01

企业微信通知.md

@@ -1,5 +1,5 @@
 ---
-tags: [企业微信, 通知, 集成]
+tags: [企业微信, 集成, 配置]
 date: 2026-07-29
 ---
 
@@ -10,19 +10,109 @@ date: 2026-07-29
 | 企业 ID (CorpID) | `wwa979fc0ebcce602a` |
 | 应用 ID (AgentID) | `1000008` |
 | 应用 Secret | `3QIxJQfqFgACBBcybmyc_I-mOoFvicH-Y6hdQ09ldLk` |
+| 服务端 IP | `59.51.140.250`（Hermes 代理服务器 IP） |
+| 可信域名 | `api.zilanlife.com` |
 
-## API 端点
+## 配置步骤
 
-- Token: `GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=<ID>&corpsecret=<SECRET>`
-- 发消息: `POST https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=<TOKEN>`
+### 1. 企业微信管理后台 — 创建自建应用
 
-## 消息类型
+登录 [work.weixin.qq.com](https://work.weixin.qq.com) → 应用管理 → 创建应用
+
+### 2. 创建子域名并配置服务器
+
+**DNS 解析（用户在域名管理后台操作）**：
+1. 登录域名 DNS 管理（如阿里云 DNS）
+2. 添加 A 记录：`api.zilanlife.com` → `47.109.158.218`
+
+**阿里云2 服务器 Nginx 配置（Hermes 代理执行）**：
+```bash
+# 创建 Nginx 站点配置
+cat > /www/server/panel/vhost/nginx/api.zilanlife.com.conf << 'EOF'
+server {
+    listen 80;
+    server_name api.zilanlife.com;
+    root /www/wwwroot/api.zilanlife.com;
+    index index.html;
+}
+EOF
+
+# 创建站点根目录
+mkdir -p /www/wwwroot/api.zilanlife.com
+
+# 放置验证文件（内容来自微信后台下载）
+echo 'j5y70gNGnVqhnH4d' > /www/wwwroot/api.zilanlife.com/WW_verify_j5y70gNGnVqhnH4d.txt
+
+# 重载 Nginx
+nginx -t && nginx -s reload
+```
+
+⚠️ 注意：文件直接放在 `/www/wwwroot/api.zilanlife.com/` 根目录，宝塔会自动加载 `/www/server/panel/vhost/nginx/` 下的 `.conf` 文件。
+
+### 3. 验证域名归属
+
+1. 回到企业微信应用详情页 → 可信域名 → 输入 `api.zilanlife.com`
+2. 下载验证文件 `WW_verify_j5y70gNGnVqhnH4d.txt`
+3. 将文件上传到服务器根目录（见上方命令）
+4. 确认 `http://api.zilanlife.com/WW_verify_j5y70gNGnVqhnH4d.txt` 可访问
+5. 点击验证通过
+
+应用详情页 → 「企业可信 IP」→ 添加 `59.51.140.250`
+
+⚠️ 必须在配置可信域名之后才能操作。
+
+### 4. 配置可见范围
+
+应用详情页 → 可见范围 → 选择需要接收消息的部门/成员
+
+## API 调用流程
+
+### 获取 Access Token
+
+```python
+GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={CorpID}&corpsecret={Secret}
+# 返回: {"access_token": "...", "expires_in": 7200}
+```
+
+Token 有效期 7200 秒（2 小时），需缓存复用。
+
+### 发送文本消息
+
+```python
+POST https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={TOKEN}
 
-```json
 {
-  "touser": "UserId",
-  "msgtype": "text",
-  "agentid": 1000008,
-  "text": {"content": "消息内容"}
+    "touser": "UserID",
+    "msgtype": "text",
+    "agentid": 1000008,
+    "text": {"content": "消息内容"}
 }
 ```
+
+### 获取通讯录用户
+
+```python
+GET https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token={TOKEN}&department_id=1&fetch_child=1
+```
+
+返回 `userlist` 数组，每个用户包含 `userid` 和 `name`。
+
+### 注意事项
+
+- `userid` 是企业微信自动生成的，如 `WuXingdeYeKong`，不一定是姓名拼音
+- 通讯录共 155 人
+- 设计师姓名和企业微信姓名需手动匹配（销帮帮用中文名，企微用英文 userid）
+
+## 诗词 API
+
+- 端点：`http://47.109.158.218:1279/api/v1/poems/random`
+- 搜索：`http://47.109.158.218:1279/api/v1/poems/search?q=关键词`
+- ⚠️ 搜索是按内容不是按作者，搜"李白"返回提及李白的诗，不是李白写的
+- 要找特定作者的诗词：用 random 随机抽取直到命中
+
+## 已测试功能
+
+- ✅ Token 获取
+- ✅ 通讯录读取（155人）
+- ✅ 发送消息到个人（申亮 = WuXingdeYeKong）
+- ✅ 诗词 API → 企业微信 端到端