排除 HubSpot 销售 Office 365 加载项的故障

以下信息可帮助解决HubSpot Sales Office 365插件的某些问题。

请注意：若您使用的是 HubSpot SalesOutlook 桌面插件，请参阅此文章。

无法安装 Office 365 插件

若安装插件时遇到问题，请确保满足以下要求：

• 请使用受支持的 Outlook 版本。以下版本的 Outlook未获得完整支持：
  • 从 Microsoft 应用商店安装的 Outlook与 HubSpot Sales Office 365 插件不兼容。请确认您的 Outlook 版本为点击即用版。
  • GoDaddy版Office 365与HubSpotSales Office 365插件不兼容，因GoDaddy当前不支持第三方应用。

• 需具备Microsoft Store访问权限。
• 需获得邮箱管理员授予的必要权限，方可在收件箱中使用第三方加载项。
• 若使用多个收件箱，请在每个收件箱中安装该插件。 
• 连接您的收件箱。

Outlook桌面版中加载项呈灰色不可用

若使用 Outlook for PC 或 Outlook for Mac，当阅读窗格处于关闭或隐藏状态时，加载项将显示为灰色。请参照此 Microsoft 文章（适用于 Outlook for PC）或此 Microsoft 文章（适用于 Outlook for Mac）确保阅读窗格已启用。

若 Office 365 增益集在 Outlook for PC 的主收件匣功能区和邮件功能区均呈灰色不可用状态，则表明 Outlook 程序本身存在问题。请尝试关闭 Outlook 后重新启动。

若该加载项在 Outlook 主收件箱功能区处于活动状态，但在邮件功能区显示为灰色，请尝试以下步骤： 

1. 检查邮件是否已加密。此操作可能需要联系您的IT团队。
2. 若邮件未加密，请尝试修复 Outlook：
   • 在Windows中打开开始菜单。
   • 搜索并选择“卸载程序”或“添加或删除程序”。
   • 定位并点击Outlook或Microsoft Office 程序，然后点击“修改”或“更改”。
   • 在弹出的对话框中，系统将提示您选择修复模式。请选择"在线修复"，然后点击"修复"。

Outlook网页版中加载项隐藏问题

在 Outlook 网页版撰写邮件时，点击主功能区中的"应用"，然后选择"HubSpot Sales"。了解如何自定义菜单操作，使该加载项始终显示在工具栏中。 

收件箱连接循环卡顿

若加载项提示连接收件箱却陷入循环，可能是您的收件箱为别名账户。虽然Office支持别名登录，但仅能将主邮箱账户连接至HubSpot。

安装 Office 365 附加组件并被要求登录时，必须使用您的主要电子邮件地址登录。 例如：若您拥有tom@acme.com的别名邮箱，但主邮箱地址为tom.anderson@acme.com，则应使用tom.anderson@acme.com进行连接。若不确定主邮箱地址，请咨询您的IT团队。

确认主要电子邮件地址后：

1. 按照以下说明 修改Outlook 中的个人资料，并将当前电子邮件地址更新为您的主要电子邮件地址。
2. 将您的主要电子邮件地址连接到加载项，而不是别名。

当主邮箱地址成功关联后，Outlook将允许您继续使用别名，收件箱连接循环问题即可解决。

登录循环问题

若在Outlook网页版使用Office 365插件时反复被要求登录HubSpot账户，请检查浏览器设置确保未阻止第三方Cookie。 

1. 请查阅以下针对您浏览器的具体文档：
   • Chrome
   • Firefox
   • Safari
2. 若您在PC端使用Outlook，请检查 设备上的Internet 选项 。 

无法保持插件登录状态 

若 Office 365 增益集反复要求登录，可延长闲置会话超时时长。 

• 若"非活动会话超时时间"设置为一天，用户连续24小时无操作将被强制注销。超级管理员或具备安全中心访问权限 的用户可 自定义该超时时间，从而延长用户在注销前的非活动时长。
• 非活动会话超时时长将优先于登录时勾选“记住我”选项。 

若在闲置会话超时前被强制注销，可能是浏览器Cookie设置导致。

1. 请确保已允许第三方Cookie。
2. 若使用Microsoft等第三方登录方式，关闭Outlook后Cookie将失效，需重新登录。建议改用邮箱密码登录，并在登录时勾选"记住我"选项。 

加载项窗格无法加载 

若设备运行 macOS Catalina及Safari 13 ，使用 Outlook 网页版或桌面版时 Office 365 插件侧边窗格可能无法加载。此问题由 Safari 安全设置引发，可按以下步骤更新设置：

1. 在您的设备上打开 Safari。 
2. 在屏幕顶部的菜单栏中，点击Safari >偏好设置。 
3. 点击“隐私”选项卡。 
4. 取消勾选“防止跨站点跟踪”复选框。

此邮件无法获取跟踪数据

使用 Office 365 附加组件时，邮件未被追踪可能由多种情况导致。若已启用邮件追踪功能，但已记录邮件显示"此邮件的追踪数据不可用"提示，请检查以下步骤： 

• 确保您的收件箱已连接。HubSpot Sales Office 365 插件需要连接的收件箱。 
• 发送邮件前请勾选"跟踪邮件打开情况"选项。需为每封需跟踪的邮件单独勾选此框，或开启默认跟踪功能。了解如何自定义日志和跟踪偏好设置。 
• 确保邮件格式设置为HTML。纯文本格式发送的邮件无法追踪。了解如何在Outlook中更改邮件格式。 
• 发送邮件时请保持加载项任务窗格处于打开状态。加载项必须处于打开状态才能追踪邮件。了解如何将加载项固定在收件箱中，或打开加载项：
  • 若使用PC或Mac端的Outlook桌面版账户，请在Outlook邮件功能区点击"销售工具"。若该图标呈灰色不可用，请重启Outlook。 
  • 若使用 Outlook 网页版或 Outlook.com 账户，请新建邮件并在主功能区点击"应用"，随后 选择"HubSpot Sales"。

跟踪功能已关闭 

因与其他加载项或安全软件冲突导致跟踪功能关闭。请关闭Outlook中所有已安装的加载项，并暂时停用任何安全程序，观察跟踪功能是否恢复。 

Azure Active Directory 配置错误

您可能收到错误提示："无法访问此应用程序，因为其配置错误。请联系您的 IT 部门并提供以下信息：应用程序 'HubSpot Sales' 的登录 URL 未定义"。这表明您公司邮箱提供商的 Azure Active Directory 配置存在问题。 

此消息并非由 HubSpot 发送，而是源自您的 Azure Active Directory 配置。您需要与 IT 资源合作解决此问题。在此情况下，HubSpot 建议您的 IT 团队或 Office 365 管理员授予 HubSpot 访问权限。如果他们正在集中部署该加载项，请参阅微软的此帮助文档。 

调试日志

在与 HubSpot 支持团队排查 Office 365 插件故障时，您可能需要提供调试日志。插件安装后会在报告日志中存储信息。若插件运行异常，这些日志可帮助支持团队深入分析插件运行状况。 

1. 在 Outlook 中撰写新邮件。
2. 导航至 HubSpot Sales 附加组件：
   • Windows 或 Mac 版 Outlook（经典界面）：在主功能区点击“销售工具”。
   • 适用于 Windows 或 Mac 的 Outlook（新版）：在主功能区中，点击三个水平点图标并选择HubSpot Sales。
   • Outlook网页版：在主功能区点击应用程序，选择HubSpot Sales。
3. 在任务窗格中向下滚动至“更多”部分，点击“加载项设置”。
4. 点击帮助与疑难排除。
5. 点击展开“需要更多帮助？”并选择“发送调试日志”。这将自动在邮件撰写窗口填充调试日志内容，并在收件人字段默认填入支持邮箱地址。
6. 若需将日志发送给您的支持专员，请在收件人字段输入其邮箱地址，然后点击 发送。