---
tags: [企业微信, 集成, 配置]
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` |

## 配置步骤

### 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}

{
    "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 → 企业微信 端到端