把自己的业务系统嵌进对话工作台

客服一边聊天一边查订单，不用在两个系统之间来回切。

配好之后是这个样子

这是客服正在接待一位客户时的界面。右边这一栏就是你自己的业务系统，嵌在工作台里，客服不用切换软件。

注意右栏顶部那几行 —— 客户姓名、手机号、客户编号，都是合从自动传给它的。客服切换到下一个对话时，这块内容跟着换成新客户的，页面不会刷新、不用重新查。

再往下的两个按钮，是这个页面反过来操作对话的能力：

• 回填到客服输入框 —— 把查到的内容（比如订单状态）填进输入框，客服看一眼、改一改再发出去。
• 发送到当前对话 —— 直接以客服的身份把内容发给客户。除了文字，还能发订单、物流、优惠券等卡片消息，比一段文字更清楚。

图里是官方示例页面，你可以一键添加它先看看真实效果。

要做到这样，需要两步

1. 技术同事做一个网页，按合从的协议接收客户信息、调用上面那两个能力。做法见开发一个扩展页面。
2. 你在设置里把网址填进来，就是本文下面要讲的部分。

只填一个普通网址也可以，客服右栏照样能打开它 —— 只是不会知道当前在接待谁，也不能往对话里发东西。

开始之前

• 你需要创始人或管理员权限。这项配置自定义角色无法开通 —— 把外部网址嵌进全体客服的工作台，属于团队级的信任决策。
• 准备一个 https 开头的网址，域名要是完整的公网域名。http 地址和 localhost 这类没有域名后缀的地址填不进去。
• 想让页面识别当前客户，把开发一个扩展页面交给你的技术同事。

先用示例页面看看效果

如果还没有自己的页面，可以先加官方示例页试试。它会把当前对话的客户信息显示出来，也能测试往对话里发消息。

1. 在 设置 页面的左侧菜单中，选择 客户 区域下的 扩展页面。

   

2. 在空白提示里选择 添加示例页面。

系统会自动加一个名为 示例页面 的条目，不用你填任何东西。去对话界面打开它，就能看到实际效果。看完可以直接删掉。

添加你自己的页面

1. 在 扩展页面 页面中，选择 添加页面。

   

2. 填写 名称。这个名称会显示在客服的对话右栏，1 到 20 个字符，例如「订单系统」。

3. 填写 网址，必须是 https 地址。

   

4. 保存。

管理已添加的页面

列表中每一行都可以：

• 停用 —— 行内的开关关掉后，这个页面不再出现在客服的对话右栏，配置保留着，随时可以再打开。
• 编辑 —— 改名称或网址。
• 删除 —— 删除后客服的对话右栏不再显示它，此操作不可撤销。

每个团队最多添加 5 个 扩展页面。停用的页面同样占名额，想腾出位置要删掉。

页面在客服端的排列顺序就是添加的先后顺序，界面上不能调整。想换顺序只能删掉重新添加。

改完网址，客服要切一下才能看到

客服端的配置是打开右栏时读取的。你改了网址之后，客服需要把右栏切到 客户信息 再切回 扩展页面 才会生效，不需要重新登录。

客服在哪里用

客服打开任意一个对话，在右栏的图标栏中选择 扩展页面，就能看到你配置的页面。

• 添加了多个页面时，右栏顶部有一个下拉框可以切换。
• 右栏空间不够时，可以切换到全屏查看，退出全屏回到右栏。
• 扩展页面对全部客服可见，不能只对某些人开放。
• 客服的浏览器窗口太窄时（小于 1024 像素）右栏整体不显示，扩展页面也就看不到。

完成后你会看到

配置好的页面出现在列表中。客服刷新工作台后，对话右栏就会出现它。

常见问题

扩展页面显示加载失败

症状：客服打开对话右栏，扩展页面区域显示加载失败，有一个重试按钮。

成因：常见的有三种 —— 网址本身打不开；网址不是 https；或者你的服务器设置了禁止被其他网站嵌入（响应头里的 X-Frame-Options 或 Content-Security-Policy 限制了 iframe 嵌入）。

解决：先在浏览器里直接打开这个网址确认能访问。如果能访问但嵌进来就失败，让技术同事检查服务器是否允许被合从工作台嵌入。

页面能打开，但显示不出客户信息

症状：扩展页面正常显示，但拿不到当前客户是谁，切换对话也没反应。

成因：这个页面没有按对接协议实现。合从是通过浏览器的消息机制把客户信息推给页面的，页面需要主动接收。

解决：把开发一个扩展页面交给技术同事，按里面的协议实现接收逻辑。也可以先添加官方示例页面对照效果。

网址填不进去，提示格式错误

症状：保存时提示网址需为有效的 https 地址。

成因：填的是 http 地址，或者域名不完整。内网地址、localhost 这类没有域名后缀的地址不能用。

解决：改用 https 地址，并确认是完整的公网域名。

提示「操作过于频繁，请稍后重试」

症状：添加页面时提示操作过于频繁。

成因：同一团队短时间内有并发的添加操作，系统为了保证不超出数量上限做了串行处理。

解决：稍等几秒重试即可。

客服说右栏根本没有扩展页面这个入口

症状：管理员已经配置好了，客服却找不到入口。

成因：常见的有三种 —— 客服的浏览器窗口小于 1024 像素，右栏整体不显示；配置的页面全部被停用了；或者客服打开工作台的时间早于配置。

解决：让客服把窗口拉宽、在设置里确认页面处于启用状态，然后把右栏切走再切回。

下一步

• 开发一个扩展页面 —— 给技术同事看的对接协议