使用数据标记自定义实时聊天小组件

您可以通过在 Widget 脚本中使用 data 标签来自定义实时聊天 Widget。 您可以在从管理应用程序(如 Copilot Service 管理中心)复制的聊天小组件脚本中使用以下标记。 详细信息: 在您的网站或门户中嵌入聊天小部件

属性名称 DESCRIPTION 示例:
data-hide-chat-button 在实施聊天小组件时,您可以添加与您的移动应用程序体验一致的聊天按钮,而不是使用默认聊天按钮。 在这种情况下,请使用此数据标签来隐藏实时聊天小部件中可用的默认 open chat (打开聊天) 按钮。 <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-chat-button="true"></script>
data-hide-minimize-button 在实施聊天小部件时,您可以禁用默认聊天中的最小化按钮。 使用此数据标签可隐藏实时聊天小部件中提供的默认最小化聊天按钮。 <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-minimize-button="true"></script>
data-disable-telemetry 默认情况下,所有小组件的遥测数据收集都处于开启状态。 如果要禁用遥测数据收集,请将此数据标签的值设置为 true 。 详细信息: 实时聊天小组件遥测 <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-disable-telemetry="true"></script>
data-render-mobile 在移动模式下打开聊天小部件。 在移动设备上使用时,聊天小组件没有标头。 详细信息: 自定义移动应用程序的实时聊天小组件 <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-render-mobile="true" ></script>
data-color-override 使用此数据标签可覆盖默认的聊天小部件主题颜色。 此覆盖优先于管理应用程序上的任何颜色主题设置。 下面是一个示例,其中 Widget 主题颜色更改为蓝色。<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-color-override="#0000FF"></script>
data-font-family-override 默认字体系列为 Segoe UI。 使用此数据标签可使用其他本机支持的字体覆盖默认字体系列。 示例 1:要覆盖默认的 Segoe UI 字体并将字体系列设置为 Arial,请执行以下作:
<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-font-family-override="Arial, Segoe UI"></script>

示例 2:要添加自定义字体系列,如 Monotype Corsiva:
<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-font-family-override="Monotype Corsiva"></script>
data-open-in-window 使用此数据标签在新窗口中打开聊天小部件。 您可以将此标签设置为 true or false (默认值)。 默认情况下,聊天小组件会在同一浏览器窗口中打开。 如果设置为 true,则聊天小组件将在选中时在新的浏览器窗口中打开。 <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-open-in-window="true"></script>
data-suggested-action-layout 使用此数据标签可垂直显示建议的作。 默认情况下,建议的作水平显示。 要垂直显示建议的作,请将此数据标记的值设置为 stacked <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-suggested-action-layout="stacked"></script>
data-enable-lcw-autofill 使用此数据标签可使聊天小组件在嵌入模式下自动填充浏览器窗口。 <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-enable-lcw-autofill="true"></script>
data-custom-close-button-text 使用此数据标签可自定义聊天小部件的关闭按钮。 输入是一个文本字符串,它代替了默认的 'X' 关闭按钮。 <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-custom-close-button-text="End Chat"></script>
data-enable-sso-magic-code 使用此数据标签可在用户登录后自动向用户发送幻码,无论是在聊天中还是通过客户端以静默方式。 此功能类似于多重身份验证,有助于防止网络钓鱼攻击。 您可以将此标记设置为 true (default value) 或 false。 如果设置为 false,则在登录后,代码会自动通过客户端以静默方式发送。 如果设置为 true,则会向用户显示一个魔术代码,以便在登录后手动进入聊天。 有关更多信息,请参阅本文中的 浏览器的其他设置 部分。 在此示例中,Magic Code 在登录后自动通过客户端传递,无需用户输入。
<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-enable-sso-magic-code="false"></script>

浏览器的其他设置

执行此处概述的特定于浏览器的步骤以自动传递 magic 代码。

基于 Chromium 的浏览器

  1. 在 Microsoft Edge 中,在地址栏中输入“edge://flags/#third-party-storage-partitioning”。 在 Google Chrome 中,在地址栏中输入“chrome://flags/#third-party-storage-partitioning”。
  2. 在显示的页面上,将 Third-party Storage Partitioning 标志设置为 Disabled

Firefox

  1. 在 Firefox 中,在地址栏中输入 “about:preferences#privacy”。
  2. 在显示的页面上,选择 自定义,然后对于 Cookie,选择 跨站点跟踪 Cookie

Safari

在设置对话框中,选择 Feature Flags,然后清除 BroadcastChannel Origin Partitioning 的选择。

后续步骤

开发自定义实时聊天小组件

主动开始聊天
实时聊天小部件遥测
为移动应用自定义实时聊天小组件
实时聊天 SDK 参考