旺客 AI 客服快速上手：从安装客户端到店铺正式接待

适合第一次使用旺客 AI 客服的店铺管理员。完整走完通常需要 15～30 分钟；开始前请准备一个可登录的旺客主体账号，以及至少一个电商平台客服账号。

1. 开始前准备

请先确认以下内容：

• 你能登录旺客 AI 客服工作台，并且当前账号已加入正确的主体。
• 电脑为 Windows 系统，可以正常安装飞鸽、千牛或拼多多商家客户端。
• 你拥有店铺客服账号的登录权限。
• 如果电脑开启了安全软件，请允许旺客 AI 客户端和电商客服客户端运行。

一个店铺可以有多个客服账号并分布在多台电脑上，套餐仍按店铺维度计数。同一家店铺不能同时绑定到两个不同主体。

2. 安装并启动旺客 AI 客户端

1. 登录工作台，下载最新正式版旺客 AI 客户端。
2. 完成安装后，从桌面启动客户端。
3. Windows 弹出 UAC 管理员授权时选择“是”。客户端需要管理员权限完成客服平台接入和本地文件更新。
4. 登录与网页工作台相同的旺客账号，并确认右上角显示“已连接”。

首次启动某个平台服务时，客户端可能需要准备运行文件。页面会显示“启动中”，通常需要 3～6 分钟；后续启动会更快。准备期间请保持旺客 AI 客户端开启。

3. 连接电商客服平台

在旺客 AI 客户端左侧选择要接入的平台，然后点击“启动服务”。

飞鸽

1. 先安装并打开最新版飞鸽客户端。
2. 在旺客 AI 客户端选择“飞鸽”，点击“启动服务”。
3. 服务启动后，旺客会自动打开或连接飞鸽。
4. 在飞鸽登录店铺客服账号，回到旺客客户端点击“刷新”。

千牛

1. 打开千牛工作台并登录客服账号。
2. 在旺客 AI 客户端选择“千牛”，点击“启动服务”。
3. 等待在线店铺出现，再检查客服账号状态。

拼多多

1. 打开拼多多商家工作台并登录客服账号。
2. 在旺客 AI 客户端选择“拼多多”，点击“启动服务”。
3. 等待店铺和客服账号同步完成。

成功后，平台页面的“在线店铺”区域会显示店铺名称、在线客服数和连接状态。

4. 处理店铺绑定与主体冲突

店铺第一次连接时会绑定到当前旺客主体。若看到“店铺绑定冲突”，说明该店铺已经归属于另一个主体，系统会阻止当前主体接入，避免回复时取错小助手或店铺配置。

解决方法：

1. 查看冲突提示中的店铺 ID 和原绑定主体。
2. 使用原主体的任一主体账号登录工作台。
3. 打开“店铺管理”，找到对应店铺并解除绑定。
4. 退出原平台客服账号，等待 20～30 秒让离线状态同步。
5. 在新主体重新登录该客服账号，然后点击“刷新”。

解除店铺绑定时，系统会同时清理旧主体下的店铺与小助手关联，避免切换主体后仍显示旧主体的小助手。

5. 创建并配置小助手

1. 在工作台打开“小助手”，选择“新建小助手”。
2. 填写名称和职责，例如“售前选品助手”或“售后退款助手”。
3. 选择可用的大模型，并编写清晰的角色说明和回复边界。
4. 按业务需要添加技能，例如商品查询、订单查询、物流查询和售后处理。
5. 将商品资料、服务规则、活动说明等文件放入知识库并关联给小助手。
6. 保存后先在调试会话中提问，确认回答内容、语气和工具调用都符合预期。

建议先覆盖高频且规则明确的问题。退款承诺、改价、赔付等高风险操作应保留人工确认。

6. 给店铺绑定小助手

1. 打开“店铺管理”。
2. 选择已经在线的店铺。
3. 在“小助手”下拉框选择刚创建并测试通过的小助手。
4. 保存绑定关系。
5. 回到旺客 AI 客户端刷新，确认店铺显示“已获准”或正常接待状态。

如果下拉框中找不到新建的小助手，请先确认当前工作台主体与店铺绑定主体一致，然后刷新页面。跨主体的小助手不会出现在选择列表中。

7. 同步商品并完成上线测试

1. 在在线店铺卡片点击“同步在售商品”。
2. 等待同步完成，检查商品数量和最近同步时间。
3. 使用测试买家账号发起会话，依次验证商品、订单、物流、售后和转人工场景。
4. 在工作台“会话”中检查收到的消息、AI 回复和技能执行结果。
5. 确认无误后再逐步扩大到更多客服账号或店铺。

正式上线前至少验证：

• 店铺、客服账号和主体归属正确。
• 绑定的是本主体下预期的小助手。
• 商品库已完成最近一次同步。
• 高频问题能稳定回答，未知问题会明确提示或转人工。
• 订单、物流、售后技能只读取当前店铺的数据。

8. 常见问题排查

点击启动后长时间停在“启动中”

首次准备超过 6 分钟仍无变化时，先保持页面不关闭并查看客户端日志。确认网络可访问更新服务、电商客服客户端已经安装，并检查安全软件是否拦截下载或解压。

提示 requested operation requires elevation

这表示 Windows 拒绝以普通权限启动需要管理员权限的程序。请退出旺客 AI 客户端，重新从桌面启动，并在 UAC 授权窗口选择“是”。

提示 Access is denied 或无法替换目录

通常是旧的飞鸽、千牛或拼多多进程仍占用文件。请完全退出对应客服客户端及其后台进程，再重新点击启动；仍失败时重启电脑后重试。

服务已启动但在线店铺为 0

请确认对应电商客服客户端已经登录店铺账号，然后回到旺客客户端点击“刷新”。仅打开登录页或控制台、尚未登录客服账号时，不会产生在线店铺。

退出冲突账号后提示仍未消失

平台离线状态存在短暂延迟。退出客服账号后等待 20～30 秒，再点击“刷新”；客户端确认账号已离线后会自动清理临时冲突提示。

仍然无法解决

请记录发生时间、平台名称、店铺 ID、旺客客户端版本和完整错误提示，并将客户端当天日志发送给技术支持。日志中可能包含业务环境信息，请通过官方支持渠道传输。

9. 日常使用建议

• 客服平台或旺客客户端升级后，先用一个测试账号验证连接和回复。
• 商品、活动和售后规则变化后及时同步商品并更新知识库。
• 定期抽查会话记录，将未命中的高频问题补充到提示词、技能或知识库。
• 客服账号更换主体前，先在原主体解除店铺绑定，再到新主体登录。
• 不再使用的电脑应退出客服账号和旺客账号，避免留下无效在线状态。

完成以上步骤后，店铺即可由旺客 AI 客服开始接待。你可以返回帮助中心继续查看各平台接入和问题排查文档。