美洽客服软件安装指南及新用户操作流程

以下内容面向首次使用美洽的管理员与坐席，涵盖开通、安装集成、基础配置和新用户上手流程。因各版本界面可能更新，具体按钮位置与字段名称以官方后台为准。

一、准备工作与环境要求

• 账号与权限：至少1个管理员账号；可创建坐席账号若干。
• 网站与应用权限：可修改网站模板或通过Tag Manager部署代码；移动端需有iOS/Android项目权限。
• 浏览器与系统：最新版 Chrome/Edge/Safari/Firefox；坐席端建议使用桌面浏览器或官方App。
• 网络与安全：企业网络需放行美洽相关域名与WebSocket；全站HTTPS优先；建议启用双重验证与强密码。
• 资料与素材：公司Logo、品牌色、常见问题文案、快捷短语、欢迎语、隐私政策链接。

二、开通与基础配置（管理员）

1. 注册企业与创建工作区：根据指引完成手机号/邮箱校验与企业信息。
2. 获取关键凭据：在后台的渠道或集成页面获取企业ID/App Key，用于网站插件或SDK初始化。
3. 成员与权限
   • 新增坐席，分配角色（管理员/组长/坐席/访客仅查看等）。
   • 创建技能组/部门（如售前/售后/技术），设置入组坐席与优先级。
4. 业务规则
   • 设置工作时间、节假日、排班与排队上限。
   • 配置欢迎语、超时规则、满意度评价、会话结束策略。
5. 品牌与界面
   • 自定义访客端主题色、浮窗样式、入口文案、表单字段。
   • 配置隐私提示与数据同意选项（若涉及）。

三、集成方式总览（选其一或多种）

• 网站在线客服插件（最常用，嵌入JS代码或通过Tag Manager部署）。
• 移动应用SDK（iOS/Android），用于App内客服。
• 微信渠道（公众号/小程序）、企业微信、微博等社交渠道。
• 邮件与工单渠道、呼叫中心对接（如有开通）。
• 坐席端使用方式：网页控制台 + 官方iOS/Android坐席App。

四、网站插件安装步骤（管理员或前端）

1. 获取代码：在后台的 渠道/网站/在线客服 或 类似入口，生成网站嵌入代码（包含企业ID/App Key）。
2. 部署位置
   • 将代码放置在网站全局模板的之前，或使用Tag Manager发布到所有页面。
   • 单页应用（SPA）需在路由变化时上报页面信息或调用更新接口，确保来源页与分流规则生效。
3. 初始化与参数
   • 绑定访客身份：登录用户可传入用户ID、昵称、联系方式，自定义字段（会员等级、订单号、渠道等）。
   • 设置语言、窗口打开方式（悬浮/嵌入/独立页）、自动弹窗策略。
4. UI与适配
   • 检查z-index避免被其他悬浮元素遮挡；移动端与PC断点样式；深色模式可选。
   • 配置入口显隐与埋点事件（点击、会话开始等）。
5. 测试与上线
   • 开启测试环境或白名单IP，仅对内部可见；验证消息连通、分流、满意度与报表是否正常。
   • 发布到生产并清理CDN/浏览器缓存，确认所有主要页面加载组件。

五、移动端SDK集成（App开发）

1. 获取App Key：与网站通用或独立Key，视后台配置为准。
2. iOS
   • 通过包管理工具集成SDK（如CocoaPods），在App启动处初始化。
   • 配置相册/麦克风权限描述（Info.plist），如需语音/图片发送。
   • 推送配置：上传证书或配置APNs/厂商通道，订阅离线消息。
3. Android
   • 通过Gradle集成SDK，在Application初始化；添加必要权限（网络、存储、通知）。
   • 设置混淆规则，避免SDK类被混淆；适配分区存储与Android 13+通知权限。
4. 用户信息与事件
   • 绑定登录用户的唯一ID，传递自定义字段；在登出时解除绑定。
   • 处理链接、图片、文件消息；异常上报与日志开关。
5. 测试：弱网、前后台切换、冷启动、推送到达与跳转会话页。

六、微信/小程序等社交渠道接入（可选）

1. 在美洽后台的渠道接入处选择对应平台，完成绑定授权。
2. 按指引在微信公众平台配置服务器地址、Token、消息加解密方式；小程序需配置合法域名。
3. 设置自动回复、分流到技能组、欢迎语与关键字；灰度测试后正式放量。

七、坐席端安装与基础使用（坐席）

1. 登录与状态
   • 使用管理员邀请的账号登录网页控制台或官方App。
   • 切换在线/忙碌/离线；在线方可接待新会话。
2. 会话处理
   • 会话列表查看新消息；访客侧栏可见来源页、轨迹、自定义字段与历史记录。
   • 回复工具：快捷短语、表情、截图/文件、知识库引用、表单请求（收集姓名/电话等）。
   • 转接与协作：按技能组或指定坐席转接；内部备注仅对坐席可见。
   • 标签与工单：为会话或用户打标签；创建/关联工单并指派跟进人。
   • 结束会话：选择结束原因，触发满意度评价（如开启）。
3. 质量与效率
   • 使用搜索快捷键/知识库；关注首次响应时长、解决时长与排队体验。
   • 总结备注，帮助后续复盘与训练知识库。

八、自动化与机器人（管理员）

• 分流规则：按来源URL、页面标题、地区/语言、会员等级、设备类型路由到不同技能组。
• 触发器与自动消息：首次访问欢迎语、排队超时提醒、无人在线时留言表单。
• 知识库与机器人：导入FAQ，设置命中阈值与转人工条件；定期审视未命中问题补充条目。
• SLA与提醒：设置响应/解决目标；逾期提醒到组长或升级处理。

九、数据与集成

• 实时看板：在线坐席、排队人数、会话量峰谷。
• 报表：会话量、首次响应时长、解决率、满意度、渠道与页面维度；支持导出CSV。
• Webhook/API：会话创建/结束回调、消息回调、用户资料同步至CRM；配置API密钥与IP白名单。
• 第三方集成：与工单、CRM、CDP、BI对接，打通用户旅程与复购分析。

十、常见问题排查

• 组件未显示：未发布至生产、缓存未刷新、Tag Manager触发条件不匹配。
• HTTPS混合内容：页面为HTTPS而脚本为HTTP会被拦截；统一HTTPS。
• 广告拦截或CSP限制：确认浏览器插件或站点CSP未阻断客服域名与WebSocket。
• 分流不生效：SPA未上报路由变化；自定义字段未在初始化前设置。
• SDK初始化失败：App Key错误、网络权限未开、证书或厂商推送未配置。
• 图片/文件上传失败：大小/类型限制或防火墙策略导致；检查后台上限与网关策略。
• 微信接入失败：公众号权限、服务器回调URL/Token不一致，或IP白名单未放行。

十一、上线前检查清单

• 代码已部署到所有目标页面/版本；移动端SDK已通过回归测试。
• 技能组、排班与队列上限配置完成；无人在线时的留言流程已验证。
• 欢迎语、快捷短语、知识库上线；满意度与结束原因配置正确。
• 数据与Webhook打通；关键KPI仪表盘可用。
• 坐席培训完成：转接、标签、工单、知识库使用与语气规范。
• 应急与回滚预案：故障联系人、停用开关与公告流程。

十二、新用户（坐席）首日上手流程

1. 接收邀请并激活账号，设置强密码与双重验证。
2. 完善个人资料与头像，确认所属技能组与工作时间。
3. 登录网页控制台或App，熟悉界面：会话列表、访客信息、快捷短语、知识库。
4. 进入在线状态，使用同事模拟访客发起测试会话，练习：
   • 开场问候与需求澄清
   • 使用知识库或快捷语回答
   • 添加标签与备注，必要时创建工单或转接
   • 结束会话并查看满意度流程
5. 正式接待真实访客，关注排队与首次响应时长；遇到不确定问题及时转接或升级。
6. 班后复盘：查看个人数据，整理新增问题，反馈给管理员补充知识库与快捷语。

十三、安全与合规建议

• 最小权限：按需分配角色；敏感报表与导出需审批。
• 审计与日志：开启操作日志与关键事件通知。
• 数据治理：设置数据留存周期与脱敏策略；明确用户隐私告知与同意。
• 备份与容灾：了解供应商SLA与多活/容灾方案；内部制定中断应对流程。

十四、获取帮助

• 官方帮助中心与开发者文档：在美洽后台的帮助或文档入口获取最新指引与SDK示例。
• 技术支持：通过官方支持渠道提交工单或咨询，附上问题时间、页面URL、控制台报错与网络HAR日志有助快速定位。

如需，我可以根据你的实际站点技术栈（如React/Vue、是否使用Tag Manager）、接入渠道（网站/小程序/APP）和团队规模，为你输出一份更贴合的配置清单与部署步骤。