企业微信 / 钉钉 工作台自建应用接入指南

前置开始前的必要条件

• 域名已解析到服务器（本系统已部署在 115.29.163.53，域名 buyan520.cn 已 ICP 备案）。
• 服务器已开启 443 端口，并在【系统设置-工作台应用配置】填写 SSL 私钥/证书路径（或前置反向代理已配置 HTTPS）。
• 你拥有企业微信「管理员」权限、钉钉「开发者/管理员」权限。

企微一、企业微信工作台接入（6 步）

1. 拿到 CorpId。电脑浏览器登录 企业微信管理后台 → 左侧「我的企业」→ 底部「企业信息」→ 复制 CorpId。
   截图点：「我的企业 → 企业信息」页面，红框标出 CorpId 一行。
2. 创建自建应用。顶部「应用管理」→「应用」→ 最下方「自建」→「创建应用」→ 上传 Logo、填应用名称（如「卜言资管系统」）、选择可见范围 → 创建后进入应用详情，复制 AgentId 与 Secret（Secret 需点击「查看」并扫码）。
   截图点：应用详情页，红框标出 AgentId 与 Secret。
3. 设置主页地址。应用详情 →「应用主页」→ 填写 https://buyan520.cn/business/（业务系统）。如需默认进财务系统则填 https://buyan520.cn/finance/。
   截图点：「应用主页」编辑框，填入域名地址。
4. 配置可信域名。应用详情 →「网页授权及 JS-SDK」→「设置可信域名」→ 填写 buyan520.cn → 企业微信会要求下载一个校验文件（文件名形如 WW_verify_xxxx.txt）。
   截图点：「可信域名」设置弹窗，红框标出下载校验文件的按钮。
5. 回填到本系统。打开本管理系统（业务系统）→ 顶部「⚙ 设置」→「企业微信 / 钉钉 工作台应用」→ 填写：对外域名 https://buyan520.cn、CorpId、AgentId、Secret、可信域名校验文件名（如 WW_verify_xxxx.txt）、校验文件内容（原样粘贴文件里的字符串）、打开企业微信跳转地址。点「保存工作台应用配置」。
   截图点：本系统设置页该区块，红框标出各输入框。
6. 验证。手机打开企业微信 →「工作台」→ 找到刚建的应用 → 点开即可进入本系统登录页。在设置页点「检查配置」可确认已填齐。
   截图点：手机企微「工作台」里出现应用图标。

钉钉二、钉钉工作台接入（6 步）

1. 进入开发者后台。浏览器登录 钉钉管理后台 →「应用开发」→「企业内部开发」→「创建应用」→ 填名称、图标、描述 → 创建后复制 AppKey 与 AppSecret。
   截图点：应用基础信息页，红框标出 AppKey / AppSecret。
2. 设置首页地址。应用 →「开发管理」→「应用首页地址」填 https://buyan520.cn/business/；「服务器出口 IP」可填服务器公网 IP（115.29.163.53）。
   截图点：「开发管理」页首页地址输入框。
3. 配置可信域名 / 校验文件。钉钉也会要求校验域名归属（部分版本需下载校验文件放到域名根路径）。本系统已支持：把钉钉给的校验文件名与内容填到设置页「可信域名校验文件名 / 内容」，系统会自动原样返回。
   截图点：钉钉「安全设置 / 分享设置」里校验文件下载处。
4. 发布应用。应用 →「版本管理与发布」→ 配置可使用范围（全员 / 指定部门）→ 发布。
   截图点：「版本管理与发布」页面发布按钮。
5. 回填到本系统。本系统「⚙ 设置」→「企业微信 / 钉钉 工作台应用」→ 填写钉钉 AppKey、AppSecret、对外域名、可信域名校验文件、打开钉钉跳转地址（默认 https://im.dingtalk.com/）。点「保存工作台应用配置」。
6. 验证。手机钉钉 →「工作台」→ 找到应用 → 点开进入本系统。点「检查配置」确认填齐。

对照三、两套平台字段对照

FAQ四、常见问题