排除收件匣與行事曆連線錯誤

當您將 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 帳戶，但您的信箱並非由 Microsoft 直接管理。因此，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 存取權限

當 Microsoft 365 阻止 HubSpot 透過 Microsoft Graph REST API 存取信箱時，便會出現

此 Outlook 信箱未啟用 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 管理員在本地 Azure Active Directory 環境中設定了應用程式安裝限制時，便會發生此錯誤。

為了解決此錯誤並讓您能繼續連接 HubSpot 的 Office 365 整合功能，您的管理員可採取以下任一方法：

• 更新使用者同意設定：請依照 Microsoft Azure 文件中的步驟，啟用「允許使用者 同意」設定。 由於 HubSpot 屬於已驗證 的發佈者，一旦您的管理員啟用此設定，您帳戶中的使用者便能無需任何進一步干預即可連接收件匣。
• 啟用管理員同意工作流程：請依照 Microsoft Azure 文件中所述的指示，啟用「使用者可針對無法自行同意的應用程式，向管理員請求同意」設定。啟用此設定後，管理員將收到電子郵件通知，提示其核准使用者安裝第三方應用程式的請求。管理員亦可於「管理員同意請求」頁面中 檢視並核准待處理的請求。
• 為租戶同意權限：請使用Microsoft 身分識別平台 的管理員同意端點：
  • 將您的租戶 ID 複製並貼上至下方網址，然後在網頁瀏覽器中開啟該網址。這將產生一個「權限請求」提示，其中包含針對 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 管理員，請他們在貴組織的 Workspace 設定中，將 HubSpot 加入「受信任應用程式」清單。請參閱這篇 Google 幫助中心文章，了解如何設定「受信任應用程式」清單。

進一步了解Google 的「進階保護計畫」。