跳到内容

收件箱和日历连接错误的故障排除

上次更新时间: 二月 12, 2025

除非另有说明,否则适用于以下任何订阅

所有产品和计划

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

Office 365 收件箱和日历错误

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

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

如果您是IT管理员,请注意HubSpot使用Microsoft Graph API与您的收件箱和日历集成。HubSpot 需要以下权限才能连接:

Mail.ReadWrite
邮件发送
Calendars.Read
Calendars.ReadWrite
离线访问
电子邮件
用户名
用户.读取

未找到 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.comMX 查询显示没有已知的电子邮件提供商。

如果出现此错误,则需要使用其他电子邮件提供商进行连接。例如,如果运行的是 Exchange 服务器,可以 通过 IMAPExchange 进行连接。

连接的 Office 365 收件箱显示为 outlook_[string_of_characters]@outlook.com

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

需要交互错误

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

需要管理员批准

如果 IT 管理员配置了将应用程序安装到本地 Azure Active Directory 环境的限制,则会出现此错误。

要解决此错误以便继续连接 HubSpot 的 Office 365 集成,您的管理员可以采取以下方法之一:

  • 更新用户同意设置: 按照Microsoft Azure 文档中的这些步骤打开 "允许 用户 同意来自已验证发布者的应用程序,用于选定权限(推荐) "设置。由于 HubSpot 是经过验证的发布商,一旦管理员打开此设置,您账户中的用户将能够连接收件箱,而无需任何进一步干预。
  • 启用管理员同意工作流: 按照Microsoft Azure 文档中概述的这些说明,打开 "用户可以请求管理员同意他们无法同意的应用程序"设置。打开此设置后,管理员将收到电子邮件通知,提示他们批准用户安装第三方应用程序的请求。管理员还可以在 "管理员同意请求 "页面上查看和批准待决 请求
  • 同意租户的权限:使用Microsoft 身份平台 管理员同意端点
    • 将租户 ID 复制并粘贴到下面的 URL 中,然后在 Web 浏览器中导航到生成的 URL。这将生成请求权限 提示,其中包含同意 Office 365 租户使用应用程序的选项。
    • 同意使用应用程序后,您可能会遇到一个错误。可以忽略此错误。
    • 同意后,管理员将需要从企业应用程序手动添加用户到HubSpot 销售应用程序。
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

Google 高级保护

如果您的Google账户加入了Google高级保护计划,则默认情况下会自动阻止需要对Gmail和Google Drive进行高级访问的应用程序。要使HubSpot的Gmail集成正常工作,需要有代表您读写电子邮件的权限,而Google将其归类为高风险访问。

要解决这个问题并将收件箱连接到 HubSpot,你可以联系你的 Google Workspace 管理员,让他们将 HubSpot 添加到你组织的 Workspace 设置中的受信任应用程序列表。在此 Google 帮助中心文章中了解如何设置受信任的应用程序列表。

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

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助