请注意：：本文仅为方便您阅读而提供。

解决聊天窗口小部件未显示在网站页面上的问题

上次更新时间： 2026年3月27日

可与以下任何订阅一起使用，除非另有说明：

所有产品和计划

当您设置即时聊天或基于规则的聊天机器人时，聊天小工具可能不会出现在预期的网站页面上，也不会显示给预期的联系人。本文概述了常见原因，并提供了故障排除步骤，以帮助您解决问题。

确保已安装跟踪代码

如果您要在 HubSpot 外部托管的网站上添加聊天流，您需要在页面上安装 HubSpot 跟踪代码。您可以在设置中访问跟踪代码：

请注意：如果您的网站上已经安装了 HubSpot 跟踪代码，或者您的网站是托管在 HubSpot 上的，则无需单独安装此代码片段。

在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
在左侧边栏菜单中，导航至 跟踪 & Analytics > 跟踪代码 。
要复制代码并将其添加到网站上，请单击 " 复制"。或单击 " 通过电子邮件发送给开发人员 "，然后输入 电子邮件地址 ，将代码发送给网络开发人员或 IT 资源。

如果聊天窗口小部件仍未显示，请检查是否有 Cookie 同意横幅、脚本阻止程序或其他第三方或自定义 JavaScript 阻止 HubSpot 的跟踪脚本加载。有些同意管理平台会阻止 HubSpot 脚本，直到游客接受 Cookie，这样就会阻止聊天窗口小部件的显示。

与你的开发人员合作，确保允许 HubSpot 脚本在适当的时候运行，并验证没有第三方工具或浏览器扩展阻止 HubSpot 脚本加载。

打开聊天流

确认聊天流已打开：

在 HubSpot 帐户中，导航到服务 > 聊天流。
在非活动聊天流旁边的 状态栏 中，单击以打开状态开关。

清除浏览器缓存

如果打开聊天流后它没有出现在您的网站上，请确认您在正确的实时域或环境中进行了测试。如果您最近对网站进行了更改，请等待几分钟或刷新页面。

然后，尝试在隐身浏览器窗口中加载您的网站。如果聊天流在隐身状态下显示，请清除浏览器缓存和 cookie ，以便在非隐身浏览器窗口中查看聊天流。

审查目标定位规则

建立聊天流程时，您可以在目标定位设置中指定聊天窗口小部件应显示在哪些页面上。您还可以根据访客的已知信息确定目标。在聊天流程的 " 目标 "选项卡上查看您的定位规则，确保标准与您希望在网站页面上看到的内容一致。

指定正确的域和子域

首先，请确认您希望看到聊天流的页面已包含在目标定位规则中。如果您希望聊天流显示在特定域的页面上，请确保输入正确的域。例如，如果您的定位规则是 Website | contains | www.coffeeshop.com，聊天流将显示在 www 子域上托管的任何页面上，包括 www.coffeeshop.com、www.coffeshop.com/contact 和 www.coffeeshop.com/pricing。

但是，除非您在目标定位规则中添加博客子域，否则聊天流不会出现在 blog.coffeeshop.com 上。

或者，您也可以在目标定位规则中指定根域。在此示例中，如果您使用目标定位规则 Website | contains | coffeeshop.com，聊天流将出现在具有此根域的任何页面上。

检查排除规则

如果聊天流未按预期显示，请确保页面 URL 未包含在排除规则中。导航到聊天流程，然后在目标选项卡上查看并根据需要删除任何排除规则。

核实访客信息和行为

如果您根据游客信息和行为定位聊天流程，请确保联系人符合目标标准。例如，如果您的聊天流程只显示给点击了网站上特定 CTA 的联系人，请导航到联系人记录并筛选联系人的 CTA 活动。如果联系人没有点击所选的 CTA，他们将看不到聊天流程。

如果他们确实点击了 CTA，请查看本指南中的其他故障排除步骤，或了解更多有关跟踪 Cookie 如何影响聊天流是否显示的信息。

检查单页应用程序（SPA）

如果您的网站是单页面应用程序或 SPA，您的定位规则可能无法按预期运行，因为当您导航到其他页面时，SPA 的网站内容是动态更新的，而不是重新加载。HubSpot 无法检测新的页面 URL，这会导致页面上出现错误的聊天流程，或根本无法显示。如果您要在单页面应用程序中使用即时聊天或机器人，建议您与开发人员合作，使用聊天部件 SDK 来定位您的页面。使用 .widget-refresh 方法在不同页面指定不同的聊天流程。了解更多信息，请访问 HubSpot 的开发人员文档。

检查聊天可用性设置

如果您的聊天流仍未显示在页面上，请检查聊天频道的可用性设置。您可以通过编辑可用性设置来控制何时隐藏聊天小工具，包括没有团队成员在线或工作时间以外的情况：

在 HubSpot 帐户中，单击顶部导航栏中的 settings “设置”图标。
在左侧边栏菜单中，导航至 收件箱 & Help Desk：
- 要编辑连接到对话收件箱的聊天频道，选择 收件箱 。
- 要编辑连接到帮助台的聊天频道，请选择帮助台。然后，在 " 票单来源和路由"下单击 " 通道"。
- 将鼠标悬停在聊天频道上，然后单击 " 编辑"。
导航至 可用性 选项卡。选择一个选项：

- 基于用户可用性： 如果您的分配规则中至少有一名指定的团队成员可用，游客就可以与您的团队聊天。
- 基于聊天工作时间： 设置您的团队何时可以聊天，让游客知道何时可以收到回复。
  - 使用下拉菜单设置团队的工作时间。单击 + 添加时间 ，添加其他日期和时间范围。
  - 聊天全天候可用：如果您的团队总是可以聊天，请选择此复选框。

在可用性行为部分，根据团队的可用性配置聊天体验，让游客知道何时可以收到回复。选择一个选项：

需要订阅当您的团队达到最大容量时，需要使用 Service Hub Enterprise 订阅来设置访客体验。
- 要设置游客在团队达到最大容量时的体验，请单击 " 如果所有团队成员都达到最大容量，则 "下拉菜单，然后选择显示等待消息、隐藏聊天启动器或什么都不做。了解有关为用户配置聊天容量限制的更多信息。

- 要设置游客在团队工作时间以外的体验，请单击 " 工作时间以外 "选项卡，然后单击 " 设置离线行为 "下拉菜单，选择在游客在工作时间以外访问网站时显示返回时间、显示离开消息或隐藏聊天启动器。

单击保存。

如果您正在使用包含机器人的聊天流，如果您没有自定义机器人的可用性首选项，聊天流可能仍然会出现。了解如何根据团队的可用性编辑聊天流程的显示时间。

检查聊天流优先级

如果页面上有多个聊天流，您可以决定游客访问网站时 HubSpot 应优先处理哪个聊天流。如果没有出现预期的聊天流，请检查聊天流与页面上其他聊天流相比的优先级。

了解为什么会出现不同的聊天流程

如果游客在您的一个页面上开始了一个主题，然后导航到另一个页面，在那里应该出现不同的聊天流程，那么对话将在原始主题中继续。因此，其他聊天流将不会出现。例如

聊天流 A 应该出现在 www.coffeeshop.com上。
聊天流 B 应该出现在 blog.coffeeshop.com上。
一位游客开始与聊天流 A 聊天，然后浏览了 blog.coffeeshop.com。
聊天流程 B 将不会出现，游客可以继续使用聊天流程 A 开始的主题。

如果按照上述步骤操作后，您的聊天窗口小部件仍未出现在符合目标条件的联系人中，这很可能是由于跟踪 cookie 的原因。要让游客看到您的聊天窗口小部件，必须在联系人数据库中将跟踪 cookie 与游客的联系人记录关联起来。如果联系人记录没有跟踪 cookie，那么您的聊天窗口小部件就不会显示给与联系人记录相关联的游客。

访问者在成为联系人之前，会通过跟踪 cookie 进行匿名跟踪。然后，HubSpot 可以通过两种方式将跟踪 cookie 上的网站活动与联系人记录联系起来：

访客填写 HubSpot 表单。
访客点击 HubSpot 营销电子邮件，进入 HubSpot 页面或安装了 HubSpot 跟踪代码的非 HubSpot 页面。

此外，您还可以使用跟踪代码 API 跟踪网站访客。

在访客执行上述转换之前，HubSpot 不知道访客是谁，也不知道访客的联系记录属于哪些列表。因此，如果您的联系人尚未转化，即使他们是您数据库中的联系人或您的目标列表成员，他们也不会看到您的聊天窗口小部件。

请注意： 即使游客执行了上述两个操作之一来获取跟踪 cookie，如果游客删除了浏览器 cookie，或在不同的浏览器、隐身窗口或移动设备上访问了您的网站，那么就无法检测到他们的跟踪 cookie，您的聊天窗口小部件也不会出现。

以下是一些常见的方法，可以让联系人在不通过表单或点击营销电子邮件链接的情况下存在于您的数据库中：

联系人已导入。
联系人是手动添加的。
联系人是通过记录的销售电子邮件创建的。

一旦数据库中的联系人被跟踪 cookie 跟踪，HubSpot 就会将其视为已知联系人。如果他们符合您的受众标准，您的聊天小工具就会在他们访问您的网站时出现。

请注意：，在某些情况下，某些弹出窗口拦截器可能会阻止聊天窗口小部件的加载。如果您关闭了浏览器中安装的任何弹出窗口阻止程序，但聊天窗口小部件仍然出现，那么很可能是该扩展阻止了聊天窗口小部件的加载。

这篇文章有帮助吗？

此表单仅供记载反馈。了解如何获取 HubSpot 帮助。