您可以通過在 Widget 腳本中使用 data 標籤來自定義即時聊天 Widget。 您可以在從管理應用程式（如 Copilot Service 管理中心）複製的聊天小組件腳本中使用以下標記。 詳細資訊： 在您的網站或門戶中嵌入聊天小部件
| 屬性名稱 | 說明 | 範例 |
|---|---|---|
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 的瀏覽器
- 在 Microsoft Edge 中，在地址欄中輸入“edge://flags/#third-party-storage-partitioning”。 在 Google Chrome 中，在位址欄中輸入“chrome://flags/#third-party-storage-partitioning”。
- 在顯示的頁面上，將 Third-party Storage Partitioning 標誌設置為 Disabled。
火狐瀏覽器
- 在 Firefox 中，在地址欄中輸入 “about：preferences#privacy”。
- 在顯示的頁面上，選擇 自定義，然後對於 Cookie，選擇 跨網站跟蹤 Cookie。
Safari 瀏覽器
在設置對話框中，選擇 Feature Flags，然後清除 BroadcastChannel Origin Partitioning 的選擇。