服务管理手册

外观

网页插件不显示怎么办 ​

概述 ​

本页用于定位该线上客服故障的常见原因，并提供按顺序执行的排查方法。

核心概念 ​

排查维度说明
配置状态确认相关渠道、插件或规则已启用并保存。
权限与关联确认当前账号、客服人员和渠道之间的角色或关联关系正确。
测试验证使用可复现的测试消息、页面或会话验证问题是否已解决。

解决官网网页嵌入 script 脚本后，页面右下角不展现客服小图标的问题。

故障现象 ​

在官网 HTML 中粘贴了插件脚本，重新发布后，右下角无任何悬浮按钮，且无报错提示。

排查步骤 ​

第一步：校对 webImId 参数 ​

  1. 在官网 HTML 脚本中，检查嵌入的代码段： <script id="fs-im-script" src="...creat.js?&webImId=<your-id>"></script>
  2. 确认 webImId 的 19 位数字与您在线客服后台该插件的专属 ID 完全一致。

第二步：检查浏览器控制台错误 ​

  1. 在测试官网页面按 F12 打开浏览器开发者工具，切换至 Console (控制台)。
  2. 观察是否存在 Cross-Origin Read Blocking (CORB) 跨域拦截报错，或 404 Not Found 资源加载失败报错。
  3. 若存在跨域限制，需在客服后台的渠道配置中，确认已将您的官网域名录入到“可信域名Allowlist（允许清单）”中。

第三步：核算 autoOpen 时限 ​

  1. 若配置了 autoOpen 自动弹出参数，检查其数值（毫秒）。若数值过大，图标可能会在设定的延时之后才会渲染呈现。

相关主题 ​