返回首页

企业微信配置指南

配置概述

要使用企业微信集成功能,您需要在企业微信管理后台创建自建应用并获取以下配置信息:

Corp ID

企业唯一标识

Agent ID

应用唯一标识

Corp Secret

应用访问凭证

1
登录企业微信管理后台
必需

使用企业管理员账号登录企业微信管理后台

2
获取企业ID (Corp ID)
必需

在 我的企业 -> 企业信息 中找到企业ID

详细步骤:

  1. 登录企业微信管理后台
  2. 点击左侧菜单 '我的企业'
  3. 在企业信息页面找到 '企业ID'
  4. 复制企业ID到环境变量 WECHAT_CORP_ID
3
创建自建应用
必需

在应用管理中创建新的自建应用

详细步骤:

  1. 点击左侧菜单 '应用管理'
  2. 点击 '自建' 标签
  3. 点击 '创建应用' 按钮
  4. 填写应用名称:产品序列号管理系统
  5. 上传应用logo(可选)
  6. 选择可见范围(建议选择相关部门)
  7. 点击 '创建应用'
4
获取应用配置
必需

获取AgentId和Secret

详细步骤:

  1. 进入刚创建的应用详情页
  2. 复制 'AgentId' 到环境变量 WECHAT_AGENT_ID
  3. 复制 'Secret' 到环境变量 WECHAT_CORP_SECRET
  4. 注意:Secret只显示一次,请妥善保存
5
配置可信域名
必需

设置JS-SDK的可信域名

详细步骤:

  1. 在应用详情页找到 '企业微信授权登录'
  2. 点击 '设置' 按钮
  3. 在 '可信域名' 中添加您的域名
  4. 例如:your-domain.com 或 localhost:3000(开发环境)
  5. 保存设置
6
域名验证
必需

验证网站域名所有权

详细步骤:

  1. 在企业微信管理后台找到 '可信域名' 设置
  2. 添加您的域名(例如:your-domain.com)
  3. 下载验证文件并上传到网站根目录
  4. 验证文件已自动配置:WW_verify_TfNzShYsXsu0tjwh.txt
  5. 点击 '验证' 按钮完成域名验证
7
配置应用主页
可选

设置应用的访问地址

详细步骤:

  1. 在应用详情页找到 '工作台应用主页'
  2. 设置主页地址为:https://your-domain.com/mobile
  3. 这样用户可以直接从企业微信工作台访问移动端
环境变量配置

获取到配置信息后,请在项目根目录的 .env.local 文件中添加以下配置:

WECHAT_CORP_ID=ww1234567890abcdef
WECHAT_AGENT_ID=1000001
WECHAT_CORP_SECRET=your_secret_here
WECHAT_VERIFY_TOKEN=TfNzShYsXsu0tjwh
测试配置

配置完成后,您可以通过以下方式测试配置是否正确:

访问移动端页面,检查企业微信配置是否加载成功
在企业微信中访问应用,测试扫码功能
检查控制台是否有相关错误信息