Name: 光年微信客服
Author: 光年AI

一、这个系统能做什么

光年微信客服用来在一个网页里统一管理微信客服。你可以：

接收客户从微信发来的消息；
回复文字、图片和文件；
查看客户的历史对话和未读消息；
管理对外展示的微信客服账号；
为团队成员创建客服坐席账号；
设置客户进入会话时的欢迎语；
通过光年 AI 客户端自动生成客服回复。

二、先认识两种“客服账号”

这是使用时最容易混淆的地方：

名称	给谁用	用途
微信客服账号	微信客户	对外展示名称和头像，生成“接待链接”，让客户进入咨询
客服坐席	企业员工	用账号和密码登录本系统，查看并回复客户消息

简单来说：客户通过“微信客服账号”找到企业，员工通过“客服坐席”登录工作台。

三、使用前需要准备什么

普通坐席只需要：

系统访问地址；
管理员分配的登录账号和密码；
一个现代浏览器，建议使用 Chrome、Edge 或 Safari 的较新版本。

第一位企业管理员还需要：

可用的企业微信企业账号；
在企业微信中完成微信客服授权的权限；
如果要使用 AI 自动回复，需要从光年 AI 客户端打开本系统，并且客户端中已有可用的 AI 连接。

如果点击“开始授权”时无法进入企业微信页面，请联系系统部署人员确认服务商应用和回调地址已配置完成。

四、管理员首次使用

第 1 步：创建企业

在浏览器打开系统地址。
选择“创建企业”。
填写企业名称、你的称呼、管理员账号和密码。
点击“创建并进入工作台”。

创建企业的这个账号会自动成为企业管理员。以后再使用时，在“登录”页填写账号和密码即可。

登录账号在整个系统中不能重复，英文大小写不作区分。例如 Kefu01 和 kefu01 会被当作同一个账号。

第 2 步：授权微信客服

点击页面右上角的“配置”。
进入“微信接入”。
点击“开始授权”。
在新打开的企业微信页面中选择企业并确认授权。
看到“微信客服授权成功”后，回到系统。

如果点击后没有出现新窗口，请允许浏览器为本站打开弹窗，然后重试。

第 3 步：准备微信客服账号

授权成功后，“微信接入”页会显示“微信客服账号”列表。

企业微信中已经有客服账号：点击“刷新账号”同步到本系统。
还没有客服账号：点击“创建账号”，填写名称并上传头像。

新建微信客服账号时：

名称最长 16 个字符；
必须上传 JPG 或 PNG 头像；
头像不能超过 2 MB。

点击某个微信客服账号右侧的“接待链接”，可以打开客户咨询入口。管理员可用个人微信打开该入口并发送一条消息，用来验证完整接待流程。

第 4 步：创建客服坐席

打开“配置” → “客服坐席”。
点击“创建坐席”。
填写坐席名称、登录账号和初始密码。
点击“创建账号”。
将系统地址、登录账号和初始密码单独发给该坐席。

管理员可以点击坐席右侧的编辑图标，修改显示名称、登录账号或重置密码。编辑时密码留空表示不修改密码。

删除坐席后，该账号不能再登录，但历史消息不会被删除。

第 5 步：发起一次测试咨询

在“微信接入”中打开某个账号的“接待链接”。
用个人微信以客户身份发送一条消息。
回到系统，点击“返回会话”。
从左侧会话列表选择该客户。
输入回复，按 Enter 发送。

如果能在微信中收到回复，说明授权、回调、消息同步和发送链路已经正常工作。

五、坐席日常接待客户

登录和查找会话

打开系统地址。
在“登录”页输入管理员分配的账号和密码。
左侧列表会按最近消息显示客户会话。绿色数字表示当前坐席还没读过的消息数量。
可以在搜索框中按客户名称或客户编号搜索。
点击一条会话查看历史消息。向上滚动时，系统会继续加载更早的消息。

当前版本不提供会话领取、分配或转接功能。同一企业的管理员和坐席都能看到全部客户会话，多人同时值班时需要团队自行协调，避免重复回复同一位客户。

回复文字

在底部输入框填写回复内容；
按 Enter 发送；
按 Shift + Enter 换行；
单条文字消息不能超过 2048 字节。中文通常会占多个字节，内容较长时建议分成多条发送。

发送图片或文件

点击输入框左侧的回形针图标。
选择一个文件。
等待上传和发送完成。

文件限制：

JPG、PNG 图片不能超过 2 MB；
其他普通文件不能超过 20 MB；
图片的扩展名、文件类型和实际内容需要一致。

发送失败时重试

人工发送失败的文字、图片或文件会显示“发送失败”和“重试”按钮。点击“重试”后，系统会用原内容再次发送。

AI 自动回复失败时不提供人工重试按钮。

为什么输入框会禁用

微信客服只允许在客户最近一次主动发送消息后的 48 小时内回复。出现下列情况时，系统会禁用输入框并显示原因：

客户还没有主动发过消息；
客户最近一次主动发消息已经超过 48 小时。

这时需要等客户再次主动发来消息，不能由坐席强制发送。

六、设置欢迎语

只有企业管理员可以修改欢迎语和使用规则。

创建欢迎语

打开“配置” → “自动回复”。
在“欢迎语”区域点击“新建”。
填写一个便于管理员识别的名称。
选择欢迎语类型：
- “文本”：发送一段普通文字；
- “菜单”：可以组合回复选项、网页链接、小程序入口或文本项。
填写内容并保存。

菜单欢迎语最多可以添加 10 个菜单项。编辑器右下角会显示当前字节数和最大值，请确保内容没有超限。

启用官方欢迎语

在“使用规则”中找到“官方欢迎语”。
打开“启用”开关。
在“选择欢迎语”中选中刚才创建的内容。
点击页面底部的“保存规则”。

欢迎语只会在微信客服通知“客户进入会话”并提供欢迎码时发送，不是对每条客户消息都回复。

已经被“官方欢迎语”规则选中的欢迎语不能删除。如果需要删除，请先关闭该规则或选择另一条欢迎语并保存。

七、设置 AI 自动回复

AI 回复由光年 AI 客户端实际执行，不是由服务器单独执行。因此，直接在普通浏览器打开本系统时，会看到“AI 回复需要从光年 AI 客户端打开本系统后才能使用”的提示。

配置步骤

从光年 AI 客户端打开本系统。
打开“配置” → “自动回复”。
找到“AI 回复”，点击 AI 配置旁的“新建”。
填写配置名称，选择客户端 AI 连接、模型和思考等级。
在“系统提示词”中写明 AI 的身份、语气、业务知识和禁止事项。
保存并选中该 AI 配置。
设置“参考最近对话”的数量，可填 1–100。数量越大，AI 能看到的近期上下文越多。
打开“启用”开关。
点击“保存规则”。

可以先使用下面这个简单的系统提示词，再按业务需要修改：

你是我们企业的微信客服助手。请使用简洁、友好、专业的中文回复客户。
不确定的信息不要编造，应说明需要人工确认。
不要承诺未经确认的价格、优惠、时效或售后方案。

启用后的注意事项

至少需要有一个已登录的企业成员，从光年 AI 客户端保持本系统页面打开，AI 任务才会被处理。
关闭页面或断开客户端连接后，新的 AI 回复会等待，直到页面再次在光年 AI 客户端中打开。
AI 配置和当前选中项由光年 AI 客户端管理，不会作为企业规则保存到本系统服务器。建议固定一个已配置好的客户端页面处理 AI 回复，不要让多台选中不同 AI 配置的客户端同时值守。
AI 回复可能出错，建议先用测试微信号验证语气和业务规则，再正式启用。
AI 返回的每条文字同样不能超过 2048 字节。

八、权限说明

操作	企业管理员	客服坐席
查看会话和历史消息	可以	可以
人工回复客户	可以	可以
查看微信客服账号和打开接待链接	可以	可以
微信客服授权	可以	不可以
创建、修改、删除、同步微信客服账号	可以	不可以
创建、修改、删除客服坐席	可以	不可以
创建、修改、删除欢迎语	可以	不可以
修改欢迎语和 AI 自动回复规则	可以	不可以

所有账号都只能看到自己所属企业的坐席、配置、客户和消息。

九、常见问题

列表中一直没有客户会话

请按以下顺序确认：

“配置” → “微信接入”是否显示“已连接”；
是否已经有至少一个微信客服账号；
客户是否通过该账号的“接待链接”主动发送过消息；
稍等片刻后再查看会话列表。

如果仍然没有会话，请将发消息的时间、微信客服账号名称和页面提示提供给系统运维人员。

看得到消息，但不能回复

先看输入框上方的黄色提示。如果提示客户尚未主动发消息，或已超过 48 小时，需要等客户再次发消息。

点击授权或接待链接没反应

检查浏览器地址栏附近是否出现“弹窗已拦截”提示，允许本站打开弹窗后重试。

文字能发送，但图片或文件不能发送

先确认文件大小和图片格式符合前面的限制。如果符合限制仍然失败，请把失败时间、文件类型、大小和页面错误提示发给系统运维人员。

AI 回复已启用，但没有自动回复

请确认：

页面是从光年 AI 客户端打开的，不是普通浏览器；
至少有一个已登录的企业成员保持该页面打开；
已选择可用的 AI 配置，对应连接不是“未就绪”；
“AI 回复”的“启用”开关已打开，并且已点击“保存规则”；
页面右下角是否显示“AI 回复未运行”或“AI 回复失败”的错误提示。

忘记密码怎么办

当前系统没有自助找回密码功能。坐席忘记密码时，由企业管理员在“客服坐席”中编辑该账号并重置密码。如果管理员忘记密码，需联系系统运维人员处理。

十、重要提醒

不要把登录密码、企业微信授权信息或 AI 连接凭证发给无关人员。
删除“微信客服账号”会同时从微信客服中永久删除该账号；历史消息会保留，但该账号不能继续收发消息。
删除“客服坐席”只会删除员工的登录账号，不会删除历史消息。
准备启用 AI 自动回复前，请先用测试账号验证效果，并在系统提示词中明确业务边界。

装上就能干活的 AI 小程序