配置概述
要使用企业微信集成功能,您需要在企业微信管理后台创建自建应用并获取以下配置信息:
Corp ID
企业唯一标识
Agent ID
应用唯一标识
Corp Secret
应用访问凭证
1
登录企业微信管理后台必需
使用企业管理员账号登录企业微信管理后台
2
获取企业ID (Corp ID)必需
在 我的企业 -> 企业信息 中找到企业ID
详细步骤:
- 登录企业微信管理后台
- 点击左侧菜单 '我的企业'
- 在企业信息页面找到 '企业ID'
- 复制企业ID到环境变量 WECHAT_CORP_ID
3
创建自建应用必需
在应用管理中创建新的自建应用
详细步骤:
- 点击左侧菜单 '应用管理'
- 点击 '自建' 标签
- 点击 '创建应用' 按钮
- 填写应用名称:产品序列号管理系统
- 上传应用logo(可选)
- 选择可见范围(建议选择相关部门)
- 点击 '创建应用'
4
获取应用配置必需
获取AgentId和Secret
详细步骤:
- 进入刚创建的应用详情页
- 复制 'AgentId' 到环境变量 WECHAT_AGENT_ID
- 复制 'Secret' 到环境变量 WECHAT_CORP_SECRET
- 注意:Secret只显示一次,请妥善保存
5
配置可信域名必需
设置JS-SDK的可信域名
详细步骤:
- 在应用详情页找到 '企业微信授权登录'
- 点击 '设置' 按钮
- 在 '可信域名' 中添加您的域名
- 例如:your-domain.com 或 localhost:3000(开发环境)
- 保存设置
6
域名验证必需
验证网站域名所有权
详细步骤:
- 在企业微信管理后台找到 '可信域名' 设置
- 添加您的域名(例如:your-domain.com)
- 下载验证文件并上传到网站根目录
- 验证文件已自动配置:WW_verify_TfNzShYsXsu0tjwh.txt
- 点击 '验证' 按钮完成域名验证
7
配置应用主页可选
设置应用的访问地址
详细步骤:
- 在应用详情页找到 '工作台应用主页'
- 设置主页地址为:https://your-domain.com/mobile
- 这样用户可以直接从企业微信工作台访问移动端
环境变量配置
获取到配置信息后,请在项目根目录的 .env.local 文件中添加以下配置:
WECHAT_CORP_ID=ww1234567890abcdef
WECHAT_AGENT_ID=1000001
WECHAT_CORP_SECRET=your_secret_here
WECHAT_VERIFY_TOKEN=TfNzShYsXsu0tjwh