zhensolid/obsidian

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. 企业微信管理后台 — 创建自建应用

2. 创建子域名并配置服务器

DNS 解析（用户在域名管理后台操作）：

登录域名 DNS 管理（如阿里云 DNS）
添加 A 记录：api.zilanlife.com → 47.109.158.218

阿里云2 服务器 Nginx 配置（Hermes 代理执行）：

# 创建 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. 验证域名归属

回到企业微信应用详情页 → 可信域名 → 输入 api.zilanlife.com
下载验证文件 WW_verify_j5y70gNGnVqhnH4d.txt
将文件上传到服务器根目录（见上方命令）
确认 http://api.zilanlife.com/WW_verify_j5y70gNGnVqhnH4d.txt 可访问
点击验证通过

应用详情页 → 「企业可信 IP」→ 添加 59.51.140.250

⚠️ 必须在配置可信域名之后才能操作。

4. 配置可见范围

应用详情页 → 可见范围 → 选择需要接收消息的部门/成员

API 调用流程

获取 Access Token

GET https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={CorpID}&corpsecret={Secret}
# 返回: {"access_token": "...", "expires_in": 7200}

Token 有效期 7200 秒（2 小时），需缓存复用。

发送文本消息

POST https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={TOKEN}

{
    "touser": "UserID",
    "msgtype": "text",
    "agentid": 1000008,
    "text": {"content": "消息内容"}
}

获取通讯录用户

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

企业微信通知.md 3.4 KB Istoric Crud