排除 HubSpot 销售 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 Office365插件将自动安装。更多详情请参阅此HubSpot社区帖文：

Outlook桌面插件安装故障排除若

• '尝试在 Outlook 中安装 HubSpot Sales 时发生错误。'
• '因安装程序通用错误，无法安装 Microsoft Office 解决方案'
• '此应用程序的自定义功能将无法正常工作...'
• '值超出预期范围。'
• '无法安装此应用程序，因为已存在具有相同标识的应用程序。'
• '无法启动应用程序。请联系应用程序供应商。'
• '进程无法访问文件，因为该文件正在被另一个进程使用。'
• 若安装了HubSpot Sales后Outlook频繁崩溃，我该如何处理？ 
• 若 Outlook 收件箱中不再显示 HubSpot，该如何处理？
• '无法解析属性'type'的值。'
• '仍未加载？可能是网络连接速度过慢或使用了不受支持的浏览器。'
• '您未登录状态下无法追踪邮件。是否要发送无追踪功能的邮件？'
• '邮件追踪出现问题。请确认网络连接正常并登录HubSpot账户。'

若未在Outlook中看到加载项，请了解如何在收件箱中启用Outlook的HubSpot销售功能。

更新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，然后按回车键。
2. 系统将打开包含调试日志的窗口。请将这些日志作为附件添加至您的支持工单。

通过Outlook账户访问调试日志

1. 在Outlook收件箱功能区点击HubSpot Sales，选择设置。 
2. 在设置对话框顶部点击"帮助 "，随后 选择"发送日志"。

3. 系统将打开邮件撰写窗口，收件人字段已默认填入HubSpot Outlook分发邮箱。请将其替换为您对接的技术支持专员邮箱地址，点击发送。