vault backup: 2026-07-30 13:34:35

企业微信通知.md

@@ -30,6 +30,8 @@ date: 2026-07-29
 
 **DNS（用户操作）**：A 记录 `api.zilanlife.com` → `47.109.158.218`
 
+⚠️ `api.zilanlife.com` 走 Nginx 80 端口（HTTP），不需要额外开放端口。`/wecom/callback` 路径反代到内网 `127.0.0.1:18790`。
+
 **Nginx（Hermes 在 aliyun2 执行）**：
 ```bash
 cat > /www/server/panel/vhost/nginx/api.zilanlife.com.conf << 'EOF'
@@ -182,7 +184,73 @@ GET https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token={TOKEN}&dep
 
 ---
 
-## 六、已验证功能
+## 七、消息模板
+
+### 签单前复盘表 — 设计师通知
+
+**数据来源**：销帮帮 formId=7539701，2026年，模板创建（text_12=ef4570ef...），排除关联客户已删除的记录
+
+**业务术语**：
+- `模板创建` = 销帮帮 text_12 值为模板创建 UUID
+- 对外展示为「未填写」（业务语境：记录已创建但未完善）
+
+**卡片格式**（手机端适配，分割线不超过 5 个 ━）：
+
+```
+📊 {设计师名} — 2026年签单前复盘表
+━━━━━
+📝 未填写  {N} 条
+━━━━━
+请在规定范围时间内登录销帮帮填写完毕！
+```
+
+**示例**：
+```
+📊 陈叶婷 — 2026年签单前复盘表
+━━━━━
+📝 未填写  5 条
+━━━━━
+请在规定范围时间内登录销帮帮填写完毕！
+```
+
+**流程**：
+1. 销帮帮 API 拉取 formId=7539701，筛选 text_12=模板创建
+2. 过滤 addTime >= 2026-01-01
+3. customer/detail 校验每条 text_2，排除 code=100404
+4. 按 ownerId 分组统计，id2name 查姓名
+5. **姓名映射**（销帮帮→企微）后查 userid，逐人发送
+
+**API 调取条件**：
+```json
+{
+  "corpid": "xbb8abca6c277b846dab5e0c8a52fe9506e",
+  "formId": 7539701,
+  "conditions": [
+    {"attr": "text_12", "value": ["ef4570ef-5460-7b62-b888-b3295f475e51"], "symbol": "equal"}
+  ],
+  "pageSize": 100, "page": 1
+}
+```
+然后客户端过滤 `addTime >= 2026-01-01`，再逐条 `customer/detail` 排除 `code=100404`。
+
+**发送规则**：
+- 按设计师分组，每人一条卡片（只含自己的数量）
+- 姓名映射转换后查企微 userid
+- 赵耀跳过（企微无此人）
+- 每条间隔 ≥ 0.5 秒（避免企微频率限制）
+
+**姓名映射**：
+
+| 销帮帮 | 企业微信 | userid |
+|--------|----------|--------|
+| 胡华玉 | 胡玉 | WeiXiaoXiangYang |
+| 陈明先 | 陈想 | ChenXiang |
+| 王飞 | 王习僧 | b5ed7c2b0034f08e6ae8e87d758b39a6 |
+| 赵耀 | ❌ 不存在 | — |
+
+---
+
+## 八、已验证功能
 
 - ✅ Token 获取
 - ✅ 通讯录读取（155 人）