官网想加在线客服,多数团队卡在同一个问题上:是不是要让技术把网站改一遍。实际情况通常比想象中轻。要做的是在页面里加一段客服系统提供的脚本,网站原来的页面结构、商品、表单和后台都不动;真正决定工作量的是网站由谁维护、能不能改到公共模板,以及要不要把访客身份和订单信息带进客服系统。

一、先回答"要不要改代码":加一段脚本,不改网站业务

1.1 接入的本质是把外部脚本挂到页面上

在线客服的聊天窗口、图标和会话能力运行在客服系统一侧,网站承担的是加载这段脚本并把入口展示出来。官网页面加上客服系统提供的代码链接后,访客点击图标就能与坐席或机器人对话,网站原有功能不参与这条链路。合力亿捷官网帮助文档对这一层的描述是"在网页 HTML 中添加带有在线客服功能的代码链接即可实现聊天功能",产品页的表述是"复制粘贴一行代码即可嵌入"。

1.2 三档工作量,按站点类型分

自主开发的网站,代码加在公共头部或公共底部模板里,一次生效、全站页面统一加载,不必逐页粘贴。这档工作需要能改模板的前端或运维人员,改动本身是新增一段脚本。

用 WordPress、凡科这类建站平台或 CMS 搭的站点,不需要碰源码。后台通常有"自定义代码""全局代码嵌入"一类的入口,把代码粘进去保存发布即可;部分平台还提供客服插件,按向导填参数就能挂上。

源码改不了的站点,例如部分平台型商城或托管站点,用 H5 链接接入:把聊天入口做成一个链接,放在页面按钮、导航菜单、短信或公众号菜单里,同样能进入客服会话。这类站点不嵌入脚本,也就没有代码改动。

1.3 第二层改动只在要把数据带进客服系统时出现

只接一个聊天窗口,做到 1.2 就够了。如果希望访客一进会话,坐席就能看到他是谁、浏览过什么、有没有订单,就需要把网站的用户数据和订单数据接到客服系统,做接口对接、开通跨域访问权限、配置字段映射。

这一层由企业 IT 和客服系统实施方共同完成,工作量取决于对方系统开放了哪些接口、字段范围多大,和"加一行代码"不在一个量级。

二、四种接入方式怎么选:由站点条件决定,不由技术偏好决定

2.1 JS/API 代码接入

这种方式适用于能编辑页面或模板的网站,聊天窗口嵌在页面内,PC 站和移动站分别适配。它的可控性最高,入口样式、弹出规则、访客信息传递都可以配置,也是官网场景最常见的选择。

2.2 H5 链接接入

H5 链接不依赖页面源码,把客服入口做成一个链接即可。适合改不了代码的站点,也适合只希望在特定位置放入口的场景,例如短信里的咨询链接、公众号菜单、活动落地页按钮。

2.3 SDK 接入

SDK 用于企业自研的 App。开发把客服 SDK 集成进 App,调用 App 自身的窗口和 UI 收发消息,支持集成华为鸿蒙及企业自有 SDK。官网场景一般用不到这一档。

2.4 第三方平台授权接入

在钉钉、企业微信、微信、飞书、抖音等平台内开通客服应用,走的是平台授权,不涉及官网代码。店铺、账号主页这类阵地属于这一档,官网不在其中。

四种方式不是并列的技术选项,选择顺序由站点条件决定:能改页面或模板就用 JS 代码接入,改不了源码就用 H5 链接,有自研 App 才需要 SDK,平台内阵地走授权。

b6d01ce5-90dc-4426-8964-6165d8b39e0b.png

三、代码放上去之后:入口怎么配才能真的接待

代码生效只说明窗口能打开。访客点进来之后由谁接、什么时候接、机器人先答还是人工先接,取决于后台配置。

3.1 先建入口,再拿聊天窗地址

在客服系统后台的"配置—在线—聊天入口"新增一个入口,选择渠道类型后系统会自动生成聊天窗地址。入口名称、窗口标题、欢迎语属于必填或常用项,工单开关、短信提醒、关键词拦截按需要开启。

访客端的窗口通知支持多条展示,最多可配置 5 条,用于排班提醒、活动告知这类信息。

3.2 日程与流转决定"谁接、什么时候接"

每个入口都带日程设置。系统默认周一至周日 00:00 到 23:59 全天接待,流转对象可选技能组、机器人、导航菜单,或直接指定坐席和技能组;节假日可以单独设一套日程。

这里有一个容易被跳过的前置条件:入口配置之前,要先建好在线技能组和接待坐席;需要机器人接待的,还要先配好机器人和转人工策略。缺这一步,入口能保存,会话进来却没有落点。

3.3 界面与访客端内容

访客看到的窗口样式在入口里配置,包括语言、欢迎词、皮肤主题、字体大小开关。"访客常见问题与公告"打开后,访客端右侧栏才会显示公司名片和常见问题;不开,这块内容是空的。

3.4 模拟测试与链接复用

入口配好后可以先做模拟测试,直接进入访客会话页看实际效果,不满意再回来改。聊天窗地址可以复制出来嵌入其他系统,同一个入口不必重复搭建。

入口支持启用和停用,停用后访客打开会看到"当前聊天已停用"的提示。多个产品线、多个语种的官网可以建多个入口,分别绑定技能组和样式。

四、上线联调与排障:窗口不显示,多半不是代码写错

4.1 全站页面与终端核对

代码加在公共模板上,仍要逐页确认:首页、产品页、详情页、联系页是否都出现入口。PC 站和移动站分别测一遍;独立的移动站点如果没共用同一套模板,需要单独嵌入适配移动端的代码。

4.2 三类常见原因

客服按钮不显示,常见原因是代码没有粘到正确位置、被网站的安全策略拦截、或者浏览器和网站缓存没有清。

窗口点了打不开,先看代码是否被截断或改写过,再看浏览器控制台有没有报错,以及是否与网站已有脚本或插件冲突。

移动端位置错乱或消息发不出,多与响应式适配、后台消息限制和网络状态有关,逐项排除比反复改代码有效。

4.3 需要开发配合的联调项与上线节奏

涉及访客身份、订单信息透传的,联调要覆盖接口连通、跨域权限、字段映射和异常兜底。这部分通常需要企业开发参与,测试环境先跑通再上生产。

上线节奏建议先灰度:先在一个栏目或一部分流量上开放入口,观察加载、会话分配和留言是否正常,再全量放开。

五、合力亿捷这边实际要做什么

官网用合力亿捷的网站接入代码,就是一段由客服系统生成的脚本,加到官网页面上。网站页面共用一套模板的,加一次就全站生效;不方便改页面的,也可以只取一个聊天链接,放在按钮或导航菜单里,访客点开同样能对话。

窗口出现之后的事情都在客服系统后台完成:建一个聊天入口,写欢迎语,按日程排好班次,指定由哪个技能组接待(后台就叫技能组),决定机器人先答还是人工先接,再选窗口的颜色和常见问题,都是点选配置,不需要网站开发再改一次代码。

如果希望访客点进来时,坐席就知道他是谁、看过哪些页面、有没有订单,需要把企业的客户和订单系统和客服系统连起来。这一步通常要企业技术和实施方一起做数据对接;不做也不影响窗口接待,只是坐席看到的访客信息会少一些。

交付上,SaaS 版 1 个坐席起购;标准场景基于已有的行业流程模板最快 7 天上线,流程长、要连多个系统的项目由客户成功经理、设计工程师和运营工程师跟进。上线后主要看三件事:答得准不准、事情有没有办完、多少会话转给了人工。

窗口由那段代码带出来,接得顺不顺还是取决于排班、知识和转人工规则有没有提前配好。

常见问题

1. 完全不改网站代码,能用在官网上吗?

取决于站点能不能放链接。H5 链接接入不需要修改页面源码,把入口做成链接放在按钮、菜单或短信里即可;但要在官网页面里出现悬浮图标或聊天窗口,仍需要在页面加载客服系统的脚本。

2. 加代码会不会和网站现有程序冲突?

冲突主要发生在脚本层,与已有的 JS、插件或安全策略相互影响。排查方式是先看浏览器控制台报错,再逐项停用可疑插件对比;测试环境先验证,可以避免把问题带到生产站点。

3. 需要专职技术人员吗?

看接入深度。建站平台加代码,网站管理员按后台指引粘贴即可;自主开发站需要能改公共模板的人;涉及订单、会员数据透传的,需要开发配合接口联调。

4. 加完代码就能自动接待了吗?

不能。代码只让窗口出现,还要配入口、技能组、坐席、日程,以及机器人和转人工策略。这些配置决定访客进来之后由谁接、多久接、机器人答到什么程度转人工。

5. 从加代码到正式上线大概多久?

加代码本身是小时级的事,时间主要花在入口配置、知识整理和接口联调上。合力亿捷的标准场景基于行业流程模板最快 7 天上线,前提是场景标准、不需要复杂系统对接;需要连接多个业务系统的项目周期会更长。




文中接入方式、入口配置与排障项依据合力亿捷官网帮助文档与产品页的公开说明整理。不同建站平台的后台入口名称可能存在差异,具体以实际平台为准。