疑難排解聊天 小工具 未出現在 網站 頁面上

設定即時即時聊天 天 聊天機器人器人時，聊天 小工具 可能不會出現在預期的 網站 頁面或預期的聯絡人身上。本文概述常見原因，並提供疑難排解步驟，協助您解決問題。 

請確保已安裝 追蹤 程式碼

如果您要將聊天 聊天流程 新增至HubSpot外部託管的 網站，則需要在頁面 上安裝HubSpot 追蹤 程式碼 。您可以在設定中存取 追蹤 程式碼：

請注意： 如果您的網站已安裝HubSpot 追蹤 程式碼 ，或者您的 網站 網站 託管在HubSpot上，則 無 需單獨安裝此 程式碼片段。

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「設定圖示」。
2. 在左側邊欄選單中，前往「 追蹤 & 資料分析 > 追蹤 程式碼」。
3. 若要複製代碼並 將其新增至您的 網站，請按一下「 複製」。或按一下「傳送 電子郵件給開發 人員」，然後輸入 電子郵件地址，將程式碼傳送給您的網頁開發人員或IT資源。

如果是手動新增 追蹤 程式碼，請確保未經修改就複製了確切的 常用回覆，並安裝在預期的頁首中。如果你使用標籤管理員，請確認HubSpot標籤正在測試的頁面上發佈和啟動。

檢查指令碼攔截程式或 Cookie 同意限制

如果聊天 小工具 仍未出現，請檢查 Cookie 同意橫幅、指令碼攔截程式或其他第三方或自訂JavaScript是否阻止載入HubSpot的 追蹤 指令碼。部分同意管理平臺會封鎖HubSpot指令碼，直到訪客接受Cookie為止，這可能會導致聊天 小工具 無法顯示。

與開發人員合作，確保在適當的時候允許HubSpot腳本 執行，並 確認沒有 第三方工具或瀏覽器擴充功能阻止 HubSpot 腳本載入。 

檢查HubSpot 追蹤 程式碼和聊天 小工具 腳本是否正確載入 

安裝 追蹤 程式碼後，請確認網頁載入的程式碼正確無誤。

追蹤 程式碼應顯示在頁面來源或具有id屬性的DOM中 hs-script-loader.

HubSpot使用特定的腳本 id 屬性來防止重複載入相同的腳本。不要在 網站 的其他地方使用HubSpot腳本ID。如果另一個頁面元素已經使用相同的ID ， HubSpot可能會確定腳本已經存在，而不會再次載入它。

若要確認正在載入聊天 小工具 腳本，請按照以下步驟操作：

1. 在瀏覽器中開啟 網站。
2. 開啟開發人員工具，然後檢查「 網路 」索引標籤。
3. 搜索 conversations-embed.js。此檔案由HubSpot 追蹤 程式碼載入，應來自包含的 網域 usemessages。
4. 確認指令碼具有 id 屬性 hubspot-messages-loader 並包含所需的資料屬性：
• data-hsjs-portal
• data-hsjs-hublet
• data-hsjs-env
5. 搜索 visitor.js。此腳本載入聊天 小工具 UI ，並由插入 conversations-embed.js。

如果 conversations-embed.js 或 visitor.js 未載入，請檢查瀏覽器主控臺是否有JavaScript錯誤、內容安全政策錯誤或其他可能導致HubSpot指令碼無法執行的頁面錯誤。

請注意： 如果 帳戶 中沒有開啟聊天流程，追蹤 程式碼可能不會包含載入conversations-embed.js的程式碼。開啟聊天流程 聊天流程，在更新的 追蹤 程式碼開始載入聊天 小工具 腳本之前，可能會有快取。

如果您的網站執行內容安全政策(CSP) ，請確保允許使用HubSpot指令碼網域。CSP相關錯誤通常會顯示在瀏覽器主控臺中，並指出哪個指令碼遭到封鎖，以及原因。深入瞭解HubSpot內容安全政策設定中的必要網域和指令。

開啟即時 聊天流程 話功能

若要確認即時對話已開 聊天流程，請按照以下步驟操作：

1. 在你的 HubSpot 帳戶中，瀏覽「服務」>「聊天流程」。
2. 在停用的聊天流程旁邊的「 狀態 」欄中，按一下以切換 狀態開關。
   

清除瀏覽器快取

開啟聊 聊天流程 流後，如果聊天流未出現在您的 網站  上，請確認您正在正確的即時 網域 或環境上進行測試。如果你最近曾對網站進行變更，請稍候幾分鐘或重新整理頁面。

然後，嘗試在無痕瀏覽器視窗中載入 網站。如果聊天 聊天流程 出現在無痕模式中， 請清除瀏覽器快取和Cookie ，以便在非無痕 聊天流程 瀏覽器視窗中查看聊天流程。

查看你的定位和排除規則

建立聊天流程 聊天流程，您可以在 目標設定中指定聊天 小工具 應顯示在哪些頁面上。您也可以根據 訪客的已知資訊來設定目標。在聊天流程的 「目標」索引標籤 上查看您的目標 規則 ，以確保標準與您在 網站 頁面上看到的內容相符。

指定正確的 網域 和 子網域

首先，請確認您預期會看到聊天流程的頁面 聊天流程 包含在您的目標規則中。如果你希望聊天流程顯示在特定 網域 頁面上，請務必輸入正確的 網域。例如，如果您的目標規則是 網站|包含| www.coffeeshop.com ，聊天流程 聊天流程 顯示在 www子網域網域上託管的任何頁面上， 包括www.coffeeshop.com、www.coffeshop.com/連絡人人和 www.coffeeshop.com/pricing。

不過，除非你將 聊天流程 誌 子網域 新增 至定位規則，否則聊天流程 不會 出現在blog.coffeeshop.com上。

或者，您可以在目標規則中指定 根網域 。在此範例中，如果您使用目標規則 網站 | contains | coffeeshop.com ，聊天流程 聊天流程 顯示在具有此 根網域 任何頁面上。

確認用於設定目標的頁面網址

當聊天 小工具 載入時，它會將頁面URL傳送到HubSpot ，以確定是否應該 聊天流程 據您的定位規則顯示聊天流程。

若要查看使用的網址，請按照以下步驟操作：

1. 在瀏覽器中開啟 網站。
2. 使用滑鼠右鍵按一下頁面上的任何位置，然後選擇 檢查，或按 Ctrl + Shift + I （ Windows ）或 Cmd + Option + I （ Mac ）以開啟開發人員工具。
3. 按一下「 網路 」分頁。
4. 重新整理頁面。
5. 尋找與聊天 小工具 相關的請求(例如，包含 conversations 或的請求 messages)。
6. 按一下預約，然後查看標 題 分頁。
7. 尋找 X-Hubspot-Messages-Uri 標題並檢閱其值。

確認此標題中的網址與您的聊天流程目 聊天流程 規則相符。例如， https://www.hubspot.com 如果規則 https://hubspot.com 不包含子網 www 子網域，則包含的目標規則將與以開頭的URL不匹配。

如果您的網站使用反向代理，請確保代理在將請求轉發到HubSpot時保留 X-Hubspot-Messages-Uri 標頭。如果沒有此標題，聊天 小工具 可能無法按預期載入。

查看排除規則

如果聊 聊天流程 流程未如預期顯示，請確保排除規則中未包含頁面網址。前往您的聊天流程 聊天流程 然後在 「目標」分頁上，根據需要查看並刪除任何排除規則。

驗證訪客資訊和行為

如果您是 根據訪客資訊和行為設定對話流程，請確保客 連絡人 案件符合目標標準。舉例來說，如果您的聊天流程只會顯示在點擊您 網站 上特定行動 CTA 的 連絡人 服案件， 連絡人記錄 ，並 篩選該 連絡人 服案件的行動 CTA 活動。如果 連絡人 案件尚未點擊所選 CTA，則不會看到對話 聊天流程。

如果他們確實點擊了 CTA，請查看本指南中的其他疑難排解步驟，或進一步了解 追蹤 Cookie 如何影響聊天 聊天流程 的顯示。

檢查單頁應用程式(SPA)

如果您的 網站 是單頁應用程式或SPA ，由於SPA的 網站 站內容會在您瀏覽其他頁面時動態更新，而不是重新載入，因此您的定位規則可能無法正常運作。HubSpot無法偵測到新頁面網址，這可能會導致 聊天流程 誤的聊天流程出現在頁面上，或根本無法顯示。如果您在單頁應用程式上使用即時 即時聊天 或 機器人 ，建議您與開發人員合作，使用 聊天 小工具 SDK 定位頁面。使用.widget-refresh方法在不同頁面上指定不同的聊天流程。詳情請參閱HubSpot 開發人員文件。

查看聊天可訂狀態設定

如果你的聊 聊天流程 流程仍未顯示在頁面上，請檢查聊天頻道的可訂狀態設定。你可以編輯可供 預訂狀況設定，控制何時隱藏即時通訊 小工具，包括沒有團隊成員上線或非營業時間：

1. 在你的 HubSpot 帳戶中，點擊頂端導覽列中的「設定圖示」。
2. 在左側邊欄選單中，前往 收件匣 & 服務臺：
   • 若要編輯連結至 對話收件匣 件匣的聊天頻道， 請選取「 收件匣」。
   • 要編輯連接到服務 支援服務 的聊天頻道， 請選擇服務臺。然後，在「聯絡 服務票證 來源和轉交」下方，按一下「 頻道」。
   • 將遊標移至聊天頻道，然後點擊 「編輯」。
3. 前往 「可訂狀態」分頁。選擇一個選項：

• • 根據用戶的可用性： 如果在您的指 派規則 中至少有一個團隊成員可用，訪客可以與您的團隊聊天。
  • 根據對談營業時間：設定您的團隊何時可以進行對談，並讓訪客知道他們何時可以收到回覆。
    
    • 使用下拉式選單設定團隊的營業時間。按一下「+新增營業時間 」，即可新增其他日期和時間範圍。
    • 24小時全天候對談：如果您的團隊隨時可進行對談，請勾選此核取方塊。

4. 在「 可訂狀態行為 」部分，根據團隊的可訂狀態設定即時對話體驗，並讓訪客知道他們何時可以收到回覆。選擇一個選項：

• • 若要在團隊可供預訂時設定訪客體驗，請點擊「可供 預訂 」分頁。點擊「 顯示一般回覆時間 」下拉式選單，讓訪客知道他們何時可以收到回覆。
  • 若要在團隊上班時間外出時設定訪客體驗，請按一下「 外出 」分頁。單擊 顯示離開消息下拉菜單，然後選擇離開模式 小工具 行為。
    
    
    

  需要訂閱 當您的團隊人數 達到上限時，需要 訂閱 Service Hub Enterprise才能設定訪客體驗。

  • 若要在團隊成員人數達到上限時設定訪客體驗，請點擊「 如果所有團隊成員人數達到上限」，然後點擊下拉式選單，然後選擇顯示等候訊息、隱藏聊天啟動器或什麼都不做。深入瞭解如何 為使用者設定聊天容量限制。

• • 若要在團隊工作時間以外設定訪客體驗，請點擊「非工作時間」分頁，然後 點擊「 設定離線行為 」下拉式選單，並選擇在訪客非 工作時間造訪您的網站時顯示返回時間、顯示離開訊息或隱藏聊天啟動器。

5. 按一下儲存。

如果你使用的聊天流程包含智能 聊天流程 助手，而你並未自訂智能小助手的供應情況偏好設定，系統仍可能會顯示聊天流程。瞭解如何 根據團隊的可訂狀態編輯聊天流程的顯示時間。

檢查聊天流程 聊天流程 先順序

當頁面上出現多 聊天流程 聊天流程時，你可以決定訪客造訪你的網站時，哪一個HubSpot應該優先處理。如果預期的對話 聊天流程 未出現，請檢查對 聊天流程 流程與頁面上其他對話流程相比的優先順序 。

瞭解為什麼會出現不同的 聊天流程 話流程

如果訪客在你的其中一個頁面上建立了一個討論串，然後瀏覽到另一個應顯示不同聊天流程的頁面，對話將繼續在 原始 討論串中進行。因此，其他聊天 聊天流程 將不會出現。例如：

• 聊天流程 天流程A應該出現在www.coffeeshop.com 上。
• 聊天流程 天流程B應該出現在blog.coffeeshop.com 上。
• 訪客使用Chatflow A進行即 聊天流程 對話，然後瀏覽至 blog.coffeeshop.com。
• 聊天流程 話流程B 不會 出現，訪客可以繼續使用對話流程A開始的對話串。

瞭解 追蹤 Cookie

如果在完成上述步驟後，符合目標條 小工具，這很可能是因為 追蹤 Cookie所致。為了讓訪客看到您的聊天 小工具，必須在您的聯絡人資料庫中將 追蹤 Cookie 與訪客的 連絡人記錄 相關 連絡人資料庫。如果客 連絡人記錄 沒有 追蹤 Cookie，則您的聊天 小工具 不會出現在與客服案件 連絡人記錄 的訪客身上。

訪客如何取得追 追蹤 Cookie ？

在成為聯絡人之前，系統會使用 追蹤 Cookie 對訪客進行匿名追蹤。然後， HubSpot可以透過兩種方式 關聯 追蹤 Cookie 上的 網站 活動 與其 連絡人記錄 相關聯：

• 訪客填寫HubSpot 表單。
• 訪客點擊HubSpot行銷電子郵件，將他們導向HubSpot頁面或安裝了 HubSpot 追蹤 代碼的非HubSpot 頁面。

此外，您可以使用 追蹤 程式碼 API 來追蹤網站的訪客。

在訪客執行上述其中一個轉換之前， HubSpot不知道訪客是誰，也不知道訪客的 連絡人記錄 屬於哪個清單。因此，如果您的 連絡人 案件尚未轉換，即使對方是您資料庫中的 連絡人 服案件或目標 清單 中的成員，他們也不會看到您的聊天 小工具。

請注意： 即使訪問者已執行上述兩個操作之一以獲取 追蹤 Cookie，如果訪問者此後刪除了瀏覽器Cookie或通過其他瀏覽器、無痕視窗或移動設備訪問了您的網站，則無法偵測到他們的 追蹤 Cookie，您的聊天 小工具 也不會為他們顯示。

為什麼我的客服案件沒有 追蹤 Cookie ？

以下是無需轉換表單或點擊行銷電子郵件連結即可在資料庫中存在聯絡人的幾 表單 常見方式：

• 連絡人 人已 匯入。
• 連絡人 人是 手動新增的。
• 連絡人 人是根據 記錄的銷售電子郵件建立的。

使用追蹤 Cookie 追蹤資料庫中的 連絡人 案件後， HubSpot會將其視為已知 連絡人 案件。如果對方符合你的 受眾 標準，當他們造訪你的網站時，即時通訊 小工具 就會顯示出來。

請注意： 在某些情況下，某些瀏覽器擴充功能(例如 彈出式、廣告或指令碼攔截程式)可能會導致聊天 小工具 無法載入。如果 小工具 在停用這些擴充功能後出現，其中一個小工具可能會封鎖它。