深浅色
第一次配置（企微接入）
系统装好了、能打开了，但里面还是空的——因为还没跟企业微信接上。
这一篇讲第一次打开系统之后，管理员要做完哪几件事。
这一篇是给管理员看的
普通员工不用管这些。等管理员配完，你直接登录用就行。
一共四步
- 用管理员账号登录，改掉初始密码
- 打开「首次配置向导」，跟着走一遍
- 填企业微信的 CorpID 和 AgentID，验证连接
- 逐项确认哪些能力真的能用了
第一步：登录并改密码
安装的时候系统会生成一个管理员账号和一个初始密码。初始密码只显示一次，安装完要立刻存到安全的地方。
用这个账号登录，系统会强制你改密码。
第二步：打开首次配置向导
菜单位置：设置 → 首次配置向导
这个向导会一项一项带你检查，每一项有三种状态：
| 状态 | 意思 |
|---|---|
| 已完成 | 这项配好了 |
| 待检查 | 还没检查过，点一下检查 |
| 需要处理 | 这项有问题，得先解决 |
向导里会显示这些检查项：
| 检查项 | 检查什么 |
|---|---|
| 域名和访问路径 | 系统能不能正常访问 |
| 管理员登录 | 你的登录状态是否正常 |
| 存储 | 上传的文件有没有地方存 |
| 企业微信 | 有没有跟企微接上 |
| AI（可选） | AI 功能配没配 |
| 身份系统（可选） | 有没有接公司的统一登录 |
标着"可选"的可以先跳过
AI 和身份系统这两项标着"可选"。没有的话先跳过，不影响系统跑起来。以后要用再回来配。
必需项没过，向导不会让你"完成"
如果还有必需配置没通过，点「完成」会提示"还有必需配置未通过，暂时不能完成"。这是故意的——没配完就完成，后面用起来会到处报错。
如果保存失败，页面会提示"步骤进度暂时没有保存，请稍后重试"。这不是系统坏了，是后端一时没响应，等一会儿再点一次。
第三步：填企业微信参数
菜单位置：设置 → 系统配置
这里要填两个东西：
| 要填的 | 是什么 | 从哪拿 |
|---|---|---|
| CorpID | 你公司的企业微信 ID | 企业微信管理后台 → 我的企业 → 企业信息 |
| AgentID | 自建应用的 ID | 企业微信管理后台 → 应用管理 → 自建应用 |
还有一个 SDK 路径，这个一般不用改，安装时已经配好了。
有几个东西在网页上填不了
这是故意的，也是这套系统安全设计的一部分：
| 东西 | 为什么不能在网页上填 |
|---|---|
| Secret（应用密钥） | 泄露了别人就能冒充你的应用发消息 |
| Token / EncodingAESKey | 用来验证消息真的来自企业微信 |
| 会话存档密钥 | 用来解密聊天记录 |
| 私钥 | 用来签名 |
这些只能由服务器管理员直接写进服务器上的配置文件，网页不接收、不回显、也不显示。所以你在页面上永远看不到它们。
具体怎么配，看企业微信接入。
验证连接
填完 CorpID 和 AgentID，点验证。会有两种结果：
| 结果 | 意思 | 怎么办 |
|---|---|---|
| 验证通过 | 企业微信接上了 | 继续下一步 |
| 验证失败 | 参数不对，或者企微那边权限没给够 | 表单会保留你填的内容并说明原因，照着改 |
验证失败时表单不会被清空
系统故意保留你填的内容，就是不想让你重填一遍。看清楚提示写的什么原因，改完再试。
第四步：逐项确认能力
这一步最容易被忽略，但很重要。
企业微信连接成功，不等于所有功能都能用了。
企业微信里有一堆不同的权限，要一项一项开。比如：
| 能力 | 没开通会怎样 |
|---|---|
| 客户 | 客户列表是空的 |
| 客群 | 客群列表是空的 |
| 标签 | 标签相关的按钮点了报错 |
| 群发 | 发消息的功能用不了 |
| 客服 | 客服页面用不了 |
| 会话存档 | 整个"会话"板块都是空的 |
菜单位置：设置 → 能力状态
这一页会列出所有能力，以及每个能力现在是"可用"还是"不可用"。不可用的时候还会告诉你为什么。
发现某个能力不可用，先看这里的说明，再去企业微信后台开对应的权限。
配完之后
到这里，系统就算配好了。接下来：
常见问题
Q：向导里提示"请检查管理员登录状态和后端服务"？
可能是登录过期了，重新登录一次再试。还不行就是后端服务没起来，找服务器管理员。
Q：CorpID 和 AgentID 填了一个行不行？
不行。这两个必须同时填，只填一个会提示"企业 ID 和应用 ID 需要同时填写"。
Q：验证失败会清空我填的内容吗？
不会。系统会保留你填的内容并说明失败原因。
Q：能不能先跳过企业微信，直接用？
可以打开，但客户、客群、群发、会话这些都是空的，等于只能看看界面。