排查收件箱和日历连接错误

当您将 Gmail 收件箱或 Office 365 收件箱及日历 连接到HubSpot 时，在连接过程中可能会遇到错误。了解这些常见错误的根本原因以及如何进行故障排除。

Office 365 收件箱和日历错误

如果您在将 Office 365 收件箱或日历连接到 HubSpot 时遇到问题，请查看以下错误信息。

连接 Office 365 收件箱或日历所需的权限

如果您是 IT 管理员，请注意：HubSpot 使用Microsoft Graph API与您的收件箱和日历进行集成。HubSpot 需要以下权限范围才能建立连接：

Mail.ReadWrite
Mail.Send
Calendars.Read
Calendars.ReadWrite
offline_access
email
openid
User.Read

未找到 Office 365 收件箱和日历

此错误表示您的 Office 365 帐户中没有您尝试连接的电子邮件地址对应的邮箱。例如，您可能有一个用于 Word 或 Excel 等其他产品的 Office 365 帐户，但您的电子邮件由其他邮件服务提供商托管。您需要选择正确的提供商来连接您的日历或电子邮件。

不可用 - 邮箱未启用 API 访问权限

您将在 HubSpot 账户中看到此错误，错误代码为 OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX。此错误可能由以下两种情况之一引起：

• 此错误可能表明您正在从outlook.com/hotmail或其他服务迁移至Office 365账户。此迁移过程可能需要一定时间，若在迁移期间尝试连接，则会出现此错误。
• 此错误也可能意味着您的域名同时采用了本地 Exchange和 Office 365的混合部署模式。这意味着您拥有 Office 365 账户，但您的邮箱并非由微软直接管理。因此，HubSpot 无法访问您邮箱的 REST API。 HubSpot需要通过 REST API连接到 Office 365 账户。验证您的邮箱是否托管在 Office 365 上的方法之一，是通过MX Toolbox（一个显示MX 记录的外部网站）查询您的邮箱域名。例如，此 MX 查询显示域名 sidekick.engineering由 Office 365 托管，但mac.com的MX 查询结果显示没有已知的邮件提供商。

若遇到此错误，您需要使用其他电子邮件提供商进行连接。例如，您可以通过 IMAP 连接，或者如果您正在运行 Exchange 服务器，则可通过 Exchange 连接

。

收件箱已断开连接：Outlook 邮箱未启用 REST API 访问权限

“此 Outlook 邮箱未启用 REST API 访问权限”错误通常发生在 Microsoft 365 阻止 HubSpot 通过 Microsoft Graph REST API 访问邮箱时。 发生此情况时，通过Microsoft Outlook 连接方式连接的收件箱可能会反复断开连接，即使短时间内能重新连接也是如此。此错误通常表明存在 Microsoft 365 配置或许可证问题。

要排查并解决此错误，请与您的 IT 管理员合作，在您的 Microsoft 365 环境中检查以下内容： 

• 验证邮箱托管情况： 确认邮箱托管在 Exchange Online 中。
  • 确认该邮箱不是混合部署、本地部署或处于部分迁移状态。
  • 验证邮箱在当前租户中是否已完全同步。

• 检查许可证： 确认该邮箱拥有包含 Exchange Online 的有效 Microsoft 365 许可证。
  • 如果许可证已被撤销或已过期，请重新分配或更新该许可证。

• 检查租户迁移情况： 确认迁移已完成，且邮箱属性已同步。
  • 重新授权已连接的应用，包括HubSpot Sales 应用。
  • 检查 Microsoft Entra ID 权限，并确认 HubSpot 在新租户中拥有 Graph API 权限。

• 重置或重新授予应用程序权限：在 Microsoft Entra ID 中，确保 HubSpot 具有访问 Graph API 的权限。
  • 如果 API 访问在迁移或许可证变更期间中断，请在 Microsoft Entra ID 中重新授予 Graph API 权限。

在检查完您的 Microsoft 365 帐户配置后，请使用 Microsoft Outlook 连接方式将收件箱重新连接到 HubSpot。建议在接下来的 24–48 小时内监控收件箱连接状态。如果问题仍然存在，请检查您的 Microsoft 365 审核日志，查看是否有被阻止的 Graph API 请求。

OData 访问已禁用

如果您收到“OData 访问已禁用”错误，则表明您的 Microsoft 365 帐户正在阻止与 HubSpot 的连接。当 Microsoft 365 帐户中的策略或配置限制了Microsoft Graph API访问时，就会发生这种情况。

要解决此错误，请与您的 IT 管理员合作，检查并更新 Microsoft 365 帐户中的以下配置：

• 应用程序访问策略：如果您的访问策略限制了 HubSpot 访问特定邮箱，请更新该策略以授予访问权限或移除限制。
• 用户代理白名单：如果您的 Microsoft 365 账户实施了白名单机制，请确保将 HubSpot 的用户代理纳入其中。根据需要添加或调整白名单条目，以允许访问 Microsoft Graph API。

已连接的 Office 365 收件箱显示为 outlook_[字符串]@outlook.

com 连接 Office 365 收件箱时，您可能会看到outlook_[字符串]@outlook.com而不是您的电子邮件地址。这是因为 HubSpot 不支持使用非 Microsoft 域的主别名。这可能会导致从已连接的收件箱发送或同步电子邮件时出现问题。 了解有关此问题的更多信息以及Microsoft 推荐的解决方案。

“需要交互”错误

如果您在连接 Office 365 收件箱时看到“需要交互”错误，这意味着您的用户需要在 Azure AD 中访问 HubSpot Sales 应用程序。您可能需要与您的电子邮件管理员合作以获取访问权限。了解有关在 Azure AD 中将用户分配给应用程序的更多信息。 

需要管理员批准

当您的 IT 管理员在 Microsoft Azure Active Directory 环境中限制了应用程序安装时，会出现此错误。该批准请求来自 Microsoft，而非 HubSpot。

为解决此错误以便您继续连接 HubSpot 的 Office 365 集成，您的管理员可采取以下任一方法：

• 更新用户同意设置：请按照 Microsoft Azure 文档中的以下步骤，启用“允许”用户 同意”设置。 由于 HubSpot 是经过验证的发布者， 一旦管理员启用此设置， 您账户中的用户即可无需任何进一步操作地连接收件箱。
• 启用管理员同意工作流： 请按照 Microsoft Azure 文档中的说明，启用“用户可针对无法自行同意的应用请求管理员同意”设置。启用此设置后，管理员将收到电子邮件通知，提示其批准用户安装第三方应用的请求。管理员还可以在“管理员同意请求”页面上查看并批准待处理的请求。
• 为租户授予权限：使用Microsoft 身份平台 的管理员同意端点：
  • 将租户 ID 复制并粘贴到下面的 URL 中，然后在网页浏览器中访问生成的 URL。这将生成一个“请求权限”提示，其中包含为 Office 365 租户同意该应用的选项。
  • 一旦您同意授权该应用，可能会遇到一个错误提示。此错误可以忽略。

• • 授予此同意后，您的管理员需要从“企业应用程序”中手动将用户添加到HubSpot Sales应用。

https://login.microsoftonline.com/{TENANT_ID}/v2.0/adminconsent?client_id=450987b3-a09a-4f14-9b2c-4f301d1e15f5&scope=https://graph.microsoft.com/User.Read+https://graph.microsoft.com/Calendars.Read+https://graph.microsoft.com/Mail.Send+https://graph.microsoft.com/calendars.readwrite+https://graph.microsoft.com/mail.readwrite+https://graph.microsoft.com/offline_access+https://graph.microsoft.com/openid+https://graph.microsoft.com/email+https://graph.microsoft.com/profile&redirect_uri=https://app.hubspot.com/oauthor/v1/office365/verify&state=12345

需要批准

与“需要管理员批准”错误类似，“需要批准”错误发生在您的 IT 管理员已在本地 Azure Active Directory 环境中配置了应用程序安装限制，但同时启用了管理员同意工作流的情况下。

要解决此错误，请在提供的文本框中输入理由，向您的 IT 管理员发送请求。您的管理员必须批准该请求，才能安装第三方应用。 管理员还可以在“管理员同意请求”页面上查看并批准待处理的请求。

Google 高级

保护计划 如果您的 Google 账户已加入Google 的“高级保护计划”，则默认情况下，需要对 Gmail 和 Google 云端硬盘进行提升权限访问的应用程序会被自动阻止。为了使 HubSpot 的 Gmail 集成正常工作，需要获取代表您读取和写入电子邮件的权限，而 Google 将此归类为高风险访问。

要解决此问题并将您的收件箱连接到 HubSpot，您可以联系您的 Google Workspace 管理员，请其将 HubSpot 添加到您所在组织 Workspace 设置中的“受信任应用”列表中。请参阅这篇 Google 帮助中心文章，了解如何设置“受信任应用”列表。

了解有关Google 高级保护计划的更多信息。