疑難排解 HubSpot Sales Outlook 桌面插件

以下資訊涵蓋與 Outlook 桌面加載項相關的安裝、更新、追蹤與通知問題，以及取得除錯日誌的方法。

本文適用於處於維護模式的 HubSpot Sales Outlook 桌面加載項。若您使用的是HubSpot Sales Office 365 加載項，請參閱如何使用 Office 365 加載項進行疑難排解。 

請注意：由於微軟在新版 Outlook for Windows 中進行重大變更，HubSpot 將不再積極開發或改進HubSpot Sales Outlook 桌面加載項。雖然該加載項仍可在舊版 Outlook for Windows 中使用並持續獲得支援，但強烈建議您改為啟用HubSpot Sales Office 365 加載項。 若您正在使用 Outlook 桌面版附加元件，切換至新版 Outlook for Windows 時，HubSpot Sales Office 365附加元件將自動安裝。更多資訊請參閱此 HubSpot 社群貼文：

Outlook 桌面版附加元件安裝疑難排解若

• '嘗試在 Outlook 中安裝 HubSpot Sales 時發生錯誤。'
• 「因安裝程式發生一般性錯誤，無法安裝 Microsoft Office 解決方案」
• 「此應用程式的自訂功能將無法運作...」
• '數值超出預期範圍'
• 「無法安裝此應用程式，因為已存在具有相同識別碼的應用程式。」
• 「無法啟動應用程式。請聯絡應用程式供應商。」
• 「程序無法存取檔案，因為該檔案正被其他程序使用。」
• 若安裝 HubSpot Sales 後 Outlook 發生當機，該如何處理？ 
• 若 Outlook 收件匣中不再顯示 HubSpot，該如何處理？
• 「無法解析屬性『type』的值。」
• 「仍無法載入？可能是網路連線速度過慢，或您使用了不支援的瀏覽器。」
• 「您未登入狀態下無法追蹤郵件。是否仍要發送無追蹤功能的郵件？」
• 「追蹤此郵件時發生問題。請確認您已連線至網際網路並登入 HubSpot。」

若您在 Outlook 中未看見此增益集，請進一步了解如何在 Outlook 收件匣中啟用 HubSpot Sales。

更新 Outlook

請確保您的 Outlook 已更新至點擊即用版本。點擊即用版Outlook 與此增益集相容，而從 Microsoft Store 安裝的 Outlook 則不相容。瞭解如何檢查 Outlook 版本並 進行更新。

設定防火牆設定

防火牆需允許透過 HTTPS 與 *.hubspot.com 進行通訊。任何更新皆需與 dl.getsidekick.com 建立通訊。

追蹤與通知問題

電子郵件未被追蹤

向hello@getsidekick.com 發送測試郵件後，您可能收到郵件未被追蹤的回覆：

1. 請確認已安裝HubSpot Sales Outlook 桌面加載項。
2. 發送郵件前請確認「追蹤郵件」方塊已勾選。
   • 若未勾選此選項，用於追蹤郵件開啟狀態的追蹤像素將不會被插入郵件中。
   • 要檢查已發送郵件是否插入追蹤像素，請開啟郵件原始碼內容，尋找類似以下的程式碼：

img src=3D"http://t.sidekickopen69.com/e1t/o/5/f18dQhb0S7ks8dDMPbW2n0
x6l2B=9gXrN7sKj6v5 dlMTVfn3cs3M2y_-W2B89RP1pctGFW8mdf1T1k1H6H0?si=3D56803726671216=64&pi=3D01cd79e8 c6c3-455d-d1aa-5175f2b770de&ti=3Dundefined" style=3D"display:none!important" height=3D"1" width=3D"1"

3. 以純文字模式寄送的電子郵件無法追蹤。若發現郵件以純文字形式寄出，請切換至 HTML 模式：
   • 在 Outlook 中撰寫新郵件。
   • 於「訊息選項」標籤頁的「格式」群組中，點選「HTML」或「自訂格式」。
4. 若 Outlook 透過CID 附加 HubSpot 追蹤像素，該郵件將無法被追蹤。CID會將像素圖片附加至您發送的郵件中，並使用標準 HTML 圖片標籤在聯絡人開啟郵件時將圖片嵌入郵件。因此追蹤像素實際上並未插入郵件正文，該郵件亦無法被追蹤。 
5. 嘗試先解除安裝，再重新安裝此增益集。

完成上述步驟後，請再次將測試追蹤郵件寄送至hello@getsidekick.com以接收通知。

常見追蹤錯誤訊息

若您未登入帳戶，可能會遇到以下錯誤訊息：

由於您未登入帳戶，無法追蹤您的郵件。是否要發送無追蹤功能的郵件？

解決此錯誤的方法：

1. 請點擊收件匣功能區中的「HubSpot Sales」，再點擊「登出」以退出 Outlook 桌面版附加元件。
2. 重新登入 Outlook 桌面加載項。 
3. 若錯誤仍持續發生，請依循以下疑難排解步驟操作。 

您亦可能遇到以下通用錯誤訊息：

追蹤此電子郵件時發生問題。請確認您已連線至網際網路並登入 HubSpot。 

解決此錯誤的方法： 

1. 請點擊收件匣功能區中的「HubSpot Sales」，再點擊「登出」以退出 Outlook 桌面加載項。
2. 重新登入 Outlook 桌面加載項。 
3. 請遵循以下疑難排解步驟： 
4. 將裝置從網路斷開連接，然後重新連接。 
5. 檢查裝置上是否安裝了任何阻擋桌面附加元件的安全程式。 

通知未顯示

• 即時通知是透過 HubSpot Sales Chrome 擴充功能傳送。若您使用 Outlook 桌面附加元件發送追蹤郵件卻未收到 HubSpot Sales 即時通知，請確認 Chrome 瀏覽器已安裝 HubSpot Sales Chrome 擴充功能並在背景執行。
• 使用桌面附加元件發送追蹤郵件時，請確認已登入正確的 HubSpot Sales 帳戶。瞭解如何變更郵件擴充功能所連結的帳戶。 

登入或載入問題

若無法登入附加元件或附加元件無法正常載入，請先解除安裝再重新安裝。 

除錯記錄

當您與 HubSpot 支援團隊合作排除桌面附加元件故障時，可能需要提供除錯記錄。安裝 Outlook 擴充功能後，系統會將資訊儲存於電腦的報告記錄檔中。這些記錄檔於每日使用擴充功能時自動儲存，檔案名稱即為使用日期。 若擴充功能運作異常，這些記錄可協助支援團隊深入分析附加元件在您電腦上的運作狀況。

收集除錯記錄有兩種方式：透過電腦的「開始」功能表，或透過您的 Outlook 帳戶。

從電腦「開始」功能表存取除錯記錄

1. 在Windows開始功能表中複製貼上%appdata%\Sidekick\Logs，然後按下Enter 鍵。
2. 系統將開啟顯示除錯日誌的視窗。請將這些日誌檔案附加至您的技術支援單中。

透過 Outlook 帳戶存取除錯日誌

1. 在 Outlook 收件匣功能區點擊HubSpot Sales，選擇設定。 
2. 於設定對話方塊頂端點擊「說明」，接著 選擇「傳送日誌」。

3. 系統將開啟郵件撰寫視窗，收件人欄位預設為 HubSpot Outlook 分發郵件地址。請將此地址替換為您合作的支援專員電子郵件，然後點擊「發送」。