受信トレイとカレンダーの接続エラーのトラブルシューティング
更新日時 2024年 9月 16日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
すべての製品とプラン |
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アカウントに、接続しようとしているEメールのメールボックスがないことを意味します。たとえば、Word や Excel などの他の製品に使用する Office 365 アカウントがあるが、E メールは別の E メールプロバイダーでホスティングされているということがあるかもしれません。カレンダーやEメールを接続するために、正しいプロバイダーを選択する必要があります。
[利用不可]: メールボックスで API アクセスが有効になっていません
HubSpotアカウントにOFFICE_ERROR_REST_API_NOT_ENABLED_FOR_COMPONENT_SHARED_MAILBOXとして、このエラーが表示されるでしょう。このエラーは、2つの方法のいずれかで発生する可能性があります:
- このエラーは、outlook.com/hotmailなどのサービスからOffice 365アカウントに移行されるプロセスにあることを示す可能性があります。この移行には時間がかかる場合があり、移行中に接続しようとすると、このエラーが表示されます。
- このエラーは、お客さまのドメインがハイブリッドオンプレミスエクスチェンジと Office 365 セットアップを使用していることを意味する場合もあります。つまり、Office 365 アカウントはあるが、直接 Microsoft によって管理されているメールボックスがないということを意味しています。その結果、HubSpot はメールボックスの REST API にアクセスできません。HubSpot で Office 365 アカウントに接続するには、REST API が必要です。メール受信トレイが Office 365 でホスティングされていないことを確認する1つの方法は、MX ToolboxでEメールドメインを調べることです。これはMX レコードを表示する外部サイトです。例えば、このMXルックアップは、ドメインsidekick.engineeringが Office 365 でホスティングされていることを示していますが、このMXルックアップ for mac.comは、既知のEメールのプロバイダーがないことを示しています。
このエラーが表示された場合は、別のEメールプロバイダーを使用して接続する必要があります。例えば、あなたがExchangeサーバーを運用しているのであれば、 IMAP経由で接続したり、Exchange経由で接続したりすることができる。
接続されているOffice 365の受信トレイが、outlook_[文字列]@outlook.comとして表示されます。
Office 365の受信トレイを接続した際に、Eメールの代わりにoutlook_[string_of_characters]@outlook.comが表示される場合があります。これは、HubSpot では非 Microsoft ドメインのプライマリーエイリアスの使用がサポートされていないためです。そのため、接続された受信トレイから E メールを送信したり同期したりする際に問題が発生する可能性があります。この問題の詳細とMicrosoftが推奨する解決策について説明します。
インタラクションが必要なエラー
Office 365の受信トレイを接続する際に「Interaction required」エラーが表示される場合は、ユーザーがAzure ADのHubSpot Salesアプリケーションにアクセスする必要があることを意味します。アクセス権を取得するには、Eメール管理者と協力して作業する必要があります。詳細はこちらAzure AD でアプリケーションにユーザーを割り当てる。
管理者の承認が必要です。
このエラーは、IT管理者がローカルのAzure Active Directory環境へのアプリケーションのインストールを制限するように設定している場合に発生します。
このエラーを解決してHubSpotのOffice 365連携の接続を進めるには、管理者が次のいずれかの方法を取ることができます:
- ユーザー同意設定の更新:Microsoft の Azure ドキュメントの手順に従って、許可するユーザー検証済みパブリッシャーからのアプリに対する、選択した権限での同意(推奨)設定をオンにします。HubSpotは認証されたパブリッシャーなので、管理者がこの設定をオンにすると、アカウントのユーザーは何もしなくても受信トレイを接続できるようになります。
- 管理者同意ワークフローを有効にする: MicrosoftのAzureドキュメントに概説されている手順に従って、ユーザーが同意できないアプリに対して管理者の同意を要求できる設定をオンにする。この設定をオンにすると、管理者は、ユーザーからのサードパーティーアプリのインストール要求を承認するよう促すEメール通知を受け取ることができます。管理者は、管理者の同意リクエストページで、保留中のリクエストを確認および承認することもできます。
- テナントの権限に同意する: Microsoft IDプラットフォームを使用する管理者の同意エンドポイント:
- 入居者IDをコピーして下記URLに貼り付け、ブラウザーでアクセスしてください。これにより、Office 365 テナントのアプリに同意するオプションのあるPermission requestedプロンプトが生成されます。
- アプリへの同意を承諾すると、エラーが発生する場合があります。このエラーは無視できる。
-
- この同意が得られたら、管理者はEnterpriseアプリケーションから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's Advanced Protection Programに登録されている場合、Gmail と Google Drive への高度なアクセスを必要とするアプリはデフォルトで自動的にブロックされます。HubSpotのGmail連携を正しく機能させるには、Eメールの読み書きを代行するためのアクセスが必要ですが、Googleはこれを高リスクのアクセスとして分類しています。
この問題を解決して受信トレイをHubSpotに接続するには、Google Workspace管理者にコンタクトを追加し、組織のWorkspace設定で信頼済みアプリのリストにHubSpotを追加してもらいます。、信頼できるアプリのリストを設定する方法については、Googleヘルプセンターの記事。
Googleの高度保護プログラムについての詳細はこちらをご覧ください。