## 文档概述 「企业微信配置」是 MuuCmf T6 后台管理系统中用于对接企业微信(WeCom)自建应用的配置模块。 本模块以**表单形式**提供企业基本信息(企业名称、企业简介)与接口配置(企业ID、应用Secret、应用ID、Token、EncodingAESKey、服务器地址)。管理员按企业微信后台的信息填写并保存后,MuuCmf 系统即可与企业微信自建应用建立连接,实现企业微信内的**消息接收与回复**、**成员身份识别与登录**等能力。 **核心用途:** - **完成企业微信对接**:通过企业ID、应用Secret、应用ID 获取接口凭证(access_token),使系统可调用企业微信接口; - **接收企业微信消息**:将系统生成的服务器地址填入企业微信后台,实现消息与事件回调; - **校验消息来源**:Token 与 EncodingAESKey 用于验证回调请求合法性、解密消息内容; - **支撑企业微信内使用**:完成对接后,可在企业微信工作台中使用站点功能、实现成员免密登录。 --- ## 1. 功能说明 「企业微信配置」用于将 MuuCmf 系统与企业微信的**自建应用**对接。配置内容分为两部分: - **基本信息**:企业名称、企业简介,用于系统内标识与展示该企业主体; - **接口配置**:企业ID(CorpID)、应用Secret、应用ID(AgentId)、Token、EncodingAESKey、服务器地址,用于接口通信、消息回调校验与消息解密。 其中,企业ID 用于标识企业主体,应用Secret 配合企业ID 换取 access_token,应用ID(AgentId)用于指定具体自建应用;Token 用于校验回调来源,必须与企业微信后台配置完全一致;EncodingAESKey 用于消息体加解密;服务器地址需填入企业微信后台的「接收消息服务器配置」,才能收到消息与事件。 ## 2. 功能入口 左侧导航:**渠道 → 企业微信 → 企业微信配置** 进入方式:点击顶部「渠道」菜单 → 左侧「企业微信」展开 → 选择「企业微信配置」子项,右侧主区域即显示企业微信配置表单页面。  ## 3. 页面组成 企业微信配置页面为表单式配置界面,自上而下分为三部分: | 区域 | 内容 | | --- | --- | | 基本信息 | 企业名称、企业简介 | | 接口配置 | 企业ID、应用Secret、应用ID、Token、EncodingAESKey、服务器地址(含「复制」按钮),每项下方附填写提示 | | 操作区 | 页面底部「保存配置」「重置」按钮 | ## 4. 配置项说明 ### 4.1 基本信息 | 配置项 | 用途说明 | 填写说明 | | --- | --- | --- | | 企业名称 | 企业主体的显示名称(必填,带 * 标记) | 填写企业全称,如「北京火木科技有限公司」,长度上限 100 字 | | 企业简介 | 企业的简要介绍 | 填写企业简介,长度上限 200 字 | ### 4.2 接口配置 | 配置项 | 用途说明 | 填写说明 | | --- | --- | --- | | 企业ID | 企业微信的企业唯一标识(必填) | 填写企业微信后台的 CorpID,形如 `ww` 开头的一串字符,长度上限 50;页面提示「企业微信后台的企业ID」 | | 应用Secret | 自建应用的密钥(必填) | 填写自建应用的 Secret,长度上限 50 左右;密码形式输入,点击右侧眼睛图标可查看明文;页面提示「应用的Secret,可在企业微信后台获取」 | | 应用ID | 自建应用的 AgentId(必填) | 填写自建应用的 AgentId(纯数字,如 1000007),长度上限 20;页面提示「应用的AgentId,可在企业微信后台获取」 | | Token | 回调校验令牌(必填) | 自定义一串字符,长度上限 50;**必须与企业微信后台「接收消息服务器配置」中的 Token 完全一致** | | EncodingAESKey | 消息加解密密钥(可选填) | 长度上限 100;由企业微信后台生成,选择安全模式时需与后台保持一致 | | 服务器地址 | 系统提供给企业微信回调的 URL | 系统自动生成(形如 `https://你的域名/api/wechat_work/callback?shopid=0`),点击「复制」后填入企业微信后台「接收消息服务器配置」的 URL | --- ## 5. 企业微信接入步骤 ### 5.1 前置准备 1. 拥有一个**已认证的企业微信**(管理员账号可登录企业微信管理后台 `work.weixin.qq.com`); 2. 确认企业微信已创建**自建应用**(「应用管理 → 应用 → 自建 → 创建应用」),并已设置可见范围; 3. 确认 MuuCmf 站点部署在**已备案的 HTTPS 域名**下,且该域名可从公网访问(企业微信回调要求可访问); 4. 确认服务器出口 IP 已企业微信允许访问,避免接口调用被限制。 ### 5.2 获取企业微信参数 | 参数 | 获取位置 | 操作说明 | | --- | --- | --- | | 企业ID(CorpID) | 企业微信管理后台 → 我的企业 → 企业信息 → 企业ID | 复制 CorpID(ww 开头) | | 应用Secret | 应用管理 → 应用 → 自建 → 选中目标应用 → Secret | 点击「查看」,复制应用的 Secret | | 应用ID(AgentId) | 同上 → AgentId | 复制数字形式的 AgentId | | Token | 应用管理 → 应用 → 自建 → 接收消息 → 设置API接收 | 自定义填写 Token(只允许字母和数字,长度≤32 字符左右),**记住该值** | | EncodingAESKey | 同上 | 由企业微信后台「随机获取」,选择安全模式时必须记录 | ### 5.3 在后台填写 1. 进入「渠道 → 企业微信 → 企业微信配置」; 2. 在「基本信息」中填写企业名称、企业简介; 3. 在「接口配置」中填写企业ID、应用Secret、应用ID; 4. 填写 Token(与 5.2 中在企业微信后台填写的一致); 5. 如选择安全模式,填写 EncodingAESKey;否则可留空; 6. 在「服务器地址」处点击「复制」,取得系统生成的回调地址; 7. 点击页面底部「保存配置」提交。 ### 5.4 在企业微信后台配置接收消息服务器 1. 登录企业微信管理后台,进入「应用管理 → 应用 → 自建 → 选中目标应用」; 2. 在「接收消息」区域点击「设置API接收」; 3. **URL**:粘贴 5.3 第 6 步复制的「服务器地址」; 4. **Token**:填写与后台完全一致的 Token; 5. **EncodingAESKey**:点击「随机获取」生成(若已在后台填写过,需保持两者一致); 6. 点击「保存」,企业微信会向该 URL 发起校验请求,校验通过即提示保存成功; 7. 如提示「回调地址校验失败」,请核对 URL 是否可公网访问、Token 是否一致、后台是否已保存配置。 ### 5.5 配置企业可信域名(使用企业微信内网页功能时) 1. 企业微信管理后台 →「应用管理 → 应用 → 自建 → 选中目标应用」→「网页授权及JS-SDK」; 2. 点击「设置可信域名」,填写站点域名(如 `www.muucmf.cc`,不带 http://); 3. 下载校验文件(形如 `WW_verify_xxxxxxxx.txt`),上传至站点**根目录**,确保可通过 `https://你的域名/WW_verify_xxxxxxxx.txt` 访问; 4. 返回后台点击「确定」,提示验证通过即完成可信域名配置; 5. 若需在企业微信内使用 JS-SDK 能力,还需在企业微信后台「企业可信IP」中添加服务器出口 IP。 ### 5.6 验证接入 1. 在企业微信后台确认「接收消息」已保存成功; 2. 在企业微信客户端中,向该自建应用发送一条消息; 3. 回到 MuuCmf 后台或对应业务页面,确认系统已收到该消息/已产生对应记录; 4. 若在企业微信工作台打开站点页面,确认能正常获取成员身份并登录; 5. 如失败,重点排查:企业ID/应用Secret/应用ID 是否准确、Token 与 EncodingAESKey 是否与后台一致、服务器地址是否可访问、可信域名校验文件是否可读取。 --- ## 6. 操作方法(通用) ### 6.1 保存配置 填写完成后点击页面底部「保存配置」按钮提交,配置即时生效。 ### 6.2 重置 点击「重置」按钮,可将表单内容恢复为默认/上次保存状态,用于重新填写。 ### 6.3 复制服务器地址 点击「服务器地址」输入框右侧的「复制」按钮,即可复制完整回调地址,粘贴到企业微信后台,避免手工输入出错。 ### 6.4 查看与应用 Secret 应用Secret 默认以密文显示,点击右侧眼睛图标可切换明文查看;如需更换,直接粘贴新的 Secret 后保存。 --- ## 7. 使用建议 1. 企业ID、应用Secret、应用ID 三者缺一不可,任一填写错误都会导致无法获取 access_token,消息与登录功能全部失效; 2. Token 必须与企业微信后台配置完全一致(区分大小写),否则「设置API接收」校验不通过; 3. EncodingAESKey 由企业微信后台生成,两端必须一致;若不使用加密模式,可留空; 4. 服务器地址由系统自动生成,请使用「复制」按钮获取,不要手动改动其中的路径或参数; 5. 企业微信回调要求域名可公网访问且为 HTTPS,站点需已备案;内网环境需通过可信域名/可信 IP 配置放行; 6. 应用Secret 属高敏感凭证,泄露后应立即在企业微信后台重置,并同步更新 MuuCmf 后台配置; 7. 接入完成后,建议在企业微信客户端中实际发送消息、打开工作台页面各验证一次,确认回调与登录均正常。 --- ## 附录:配置项与企业微信后台对应表 | 后台配置项 | 企业微信后台位置 | | --- | --- | | 企业ID | 我的企业 → 企业信息 → 企业ID(CorpID) | | 应用Secret | 应用管理 → 应用 → 自建应用 → Secret | | 应用ID(AgentId) | 应用管理 → 应用 → 自建应用 → AgentId | | Token | 应用管理 → 应用 → 自建应用 → 接收消息 → 设置API接收 → Token | | EncodingAESKey | 同上 → EncodingAESKey | | 服务器地址 | 填写至 接收消息 → 设置API接收 → URL | | 可信域名 | 应用管理 → 应用 → 自建应用 → 网页授权及JS-SDK → 可信域名 | | 企业可信IP | 应用管理 → 应用 → 自建应用 → 企业可信IP | 按以上步骤操作,即可完成 MuuCmf T6 后台企业微信配置的接入。