HubSpot Sales Office 365 插件的故障排除

了解如何排查HubSpot Sales Office 365 插件的问题。

如果您正在使用HubSpot Sales Outlook 桌面插件，请了解如何排查 HubSpot Sales Outlook 桌面插件的问题。

无法安装 Office 365 插件

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

• 请使用受支持的 Outlook 版本。以下 Outlook 版本不受完全支持：
  • 从 Microsoft Store 安装的 Outlook与 HubSpot Sales Office 365 加载项不兼容。请检查您的 Outlook 版本，确保其为“点击运行”版本。
  • GoDaddy 提供的 Office 365与 HubSpot Sales Office 365 插件不兼容，因为 GoDaddy 目前不支持第三方应用。

• 请确保能够访问 Microsoft 应用商店。
• 请确保已获得电子邮件管理员授予的必要权限，以便在收件箱中使用第三方加载项。
• 如果您使用多个收件箱，请在每个收件箱中安装该插件。 
• 连接您的收件箱。

Outlook 桌面版中插件显示为灰色

如果您使用的是 Windows 版 Outlook 或 Mac 版 Outlook，如果阅读窗格已关闭或被隐藏，插件可能会显示为灰色。了解如何在 Outlook 中打开阅读窗格。 

如果 Windows 版 Outlook 中的 Office 365 插件在 Outlook 主收件箱功能区和邮件功能区中均呈灰色，则说明 Outlook 程序本身存在问题。请尝试关闭 Outlook 并重新打开。

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

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

安装后加载项被隐藏 

请确保您使用的是受支持的 Outlook 版本，并且可以访问 Microsoft 商店。 

安装完成后，访问该插件的步骤会因您使用的 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 选项 ”。 

无法保持插件登录状态 

您的 HubSpot Sales Office 365 登录会话取决于您账户的会话超时时长。如果您 反复被提示登录 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：在主功能区中，点击“销售工具”。
   • Mac 版新 Outlook：在主功能区中，点击三个水平点，然后选择“HubSpot Sales”。
   • Windows 版新 Outlook 或 Outlook 网页版：在主功能区中，单击“应用”，然后选择“HubSpot Sales”。
3. 在任务窗格中，向下滚动至“更多”部分，然后点击“插件设置”。
4. 点击“帮助与故障排除”。
5. 点击展开“需要更多帮助？”，然后选择“发送调试日志”。此操作会将调试日志内容填入邮件撰写窗口，并在“收件人”字段中自动填入默认邮箱地址。
6. 若要将日志发送给您正在对接的技术支持专员，请在“收件人”字段中输入其电子邮件地址，然后点击 “发送”。