疑難排解收件匣和行事曆連線錯誤

當您將 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
離線存取
電子郵件
openid
使用者.讀取

未找到 Office 365 收件匣和行事曆

此錯誤表示您的 Office 365 帳戶中沒有您試圖連線的電子郵件地址的信箱。例如，您可能有一個 Office 365 帳戶，用於 Word 或 Excel 等其他產品，但您的電子郵件託管在不同的電子郵件提供商。您需要選擇正確的提供商來連接行事曆或電子郵件。

不可用 - 未啟用郵箱的 API 存取功能

您會在 HubSpot 帳戶中看到此錯誤為 OFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOX。導致此錯誤的原因有二：

• 此錯誤可能表示您正在從 outlook.com/hotmail 或其他服務轉移到 Office 365 帳戶。此遷移可能需要一些時間，如果您在遷移過程中嘗試連線，則會出現此錯誤。
• 此錯誤也可能表示您的網域使用的是內部 Exchange與 Office 365混合設定。這表示您有一個 Office 365 帳戶，但您沒有由 Microsoft 直接管理的信箱。因此，HubSpot 無法存取您信箱的 REST API。HubSpot需要 REST API才能連接到 Office 365 帳戶。驗證您的電子郵件收件箱是否託管在 Office 365 上的方法之一是在MX Toolbox 中查詢您的電子郵件網域，這是一個顯示MX 記錄的外部網站。例如，此 MX 查詢顯示網域sidekick.engineering由 Office 365 所託管，但此 mac.com的MX 查詢則顯示沒有已知的電子郵件提供商。

如果您看到此錯誤，您需要使用不同的電子郵件提供商進行連接。例如，如果您正在執行 Exchange 伺服器，您可以透過 IMAP或Exchange 連線。

收件箱斷線：Outlook 信箱未啟用 REST API 存取功能

當 Microsoft 365 阻止 HubSpot 透過 Microsoft Graph REST API 存取信箱時，就會發生Outlook 信箱未啟用 RESTAPI 存取的情況。發生這種情況時，透過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 的存取已停用

如果您收到 "Access to OData is Disabled"（访问 OData 已禁用）错误，则表明您的 Microsoft 365 帐户正在阻止与 HubSpot 的连接。當您 Microsoft 365 帳戶中的政策或組態限制Microsoft Graph API存取時，就會發生這種情況。

若要解決此錯誤，請與您的 IT 管理員合作，檢視並更新 Microsoft 365 帳戶中的下列設定：

• 應用程式存取政策：如果您的存取政策限制 HubSpot 存取特定的信箱，請更新政策以授予存取權或移除限制。
• 使用者代理允許清單：如果您的 Microsoft 365 帳戶強制執行允許清單，請確保包含 HubSpot 的使用者代理。根據需要新增或調整允許清單項目，以允許 Microsoft Graph API 存取。

已連線的 Office 365 收件匣顯示為 outlook_[string_of_characters]@outlook.com。

當您連接Office 365收件匣時，您可能會看到outlook_[string_of_characters]@outlook.com顯示，而不是您的電子郵件地址。這是因為 HubSpot 不支援使用非 Microsoft 網域的主要別名。這可能會導致從已連接的收件箱發送或同步電子郵件的問題。了解更多關於此問題和Microsoft 建議的解決方案。

需要互動錯誤

如果您在連接 Office 365 收件箱時看到「需要互動」錯誤，這表示您的使用者需要存取 Azure AD 中的 HubSpot Sales 應用程式。您可能需要與電子郵件管理員合作才能取得存取權。進一步瞭解如何在 Azure AD 中將使用者指派給應用程式。

需要管理員批准

當您的 IT 管理員設定了安裝應用程式到本機 Azure Active Directory 環境的限制時，會發生此錯誤。

要解決此錯誤，以便您可以繼續連接 HubSpot 的 Office 365 整合，您的管理員可以採取以下其中一種方法：

• 更新使用者同意設定： 依照Microsoft 的 Azure 文件中的這些步驟，開啟允許 使用者 同意來自經驗證的發佈者的應用程式，針對選取的權限 (建議) 設定。由於 HubSpot 是經過驗證的發行商，只要您的管理員開啟這項設定，您帳戶中的使用者就可以連線收件匣，而不需要任何進一步的介入。
• 啟用管理員同意工作流程： 依照Microsoft Azure 文件中概述的這些指示，開啟使用者可要求管理員同意他們無法同意的應用程式設定。開啟此設定後，管理員將收到電子郵件通知，提示他們批准使用者安裝第三方應用程式的請求。管理員也可以在「管理員同意請求 」頁面檢視和批准待決 請求 。
• 同意租戶的權限：使用Microsoft 身份平台 管理員同意端點：
  • 將其租戶 ID 複製並貼入以下 URL，然後在 Web 瀏覽器中導航至結果 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

Google 進階保護

如果您的 Google 帳戶已加入Google 進階保護計畫，則需要提升 Gmail 和 Google Drive 存取權限的應用程式會自動預設封鎖。為了讓 HubSpot 的 Gmail 整合正常運作，需要存取權限來代表您讀寫電子郵件，Google 將此歸類為高風險存取。

若要修正此問題並將收件匣連線至 HubSpot，您可以聯絡 Google Workspace 管理員，讓他們在組織的 Workspace 設定中，將 HubSpot 加入可信賴的應用程式清單。請參閱此 Google 說明中心文章，瞭解如何設定信任的應用程式清單。

進一步瞭解Google 的進階保護計劃。