Office 365 の受信トレイとカレンダーの接続エラーのトラブルシューティング
更新日時 2023年 9月 5日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
|
Office 365の受信トレイやカレンダーをHubSpotに接続する際、接続プロセス中にエラーが発生することがあります。これらの一般的なエラーと、そのトラブルシューティング方法について説明します。
Office 365の受信トレイやカレンダーを接続するために必要な権限
ITリソースの方は、HubSpotがGraph API for Microsoft 365を使って受信トレイと連携していることに注意してください。Office 365のカレンダーについては、HubSpotはOutlook REST APIを使用しています。HubSpotは、接続するために以下のスコープが必要です:
Mail.ReadWrite
Mail.Send
Calendars.Read
Calendars.ReadWrite
offline_access
Eメール
openid
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 でホスティングされていないことを確認する一つの方法は、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 メールを送信したり同期したりする際に問題が発生する可能性があります。この問題の詳細とマイクロソフトが推奨する解決策について説明します。
インタラクションが必要なエラー
Office 365の受信トレイを接続する際に「Interaction required」エラーが表示される場合は、ユーザーがAzure ADのHubSpot Salesアプリケーションにアクセスする必要があることを意味します。アクセス権を取得するには、Eメール管理者と協力して作業する必要があります。詳しくはこちらAzure ADでアプリケーションにユーザーを割り当てる .
管理者の承認が必要です。
このエラーは、IT管理者がローカルのAzure Active Directory環境へのアプリケーションのインストールを制限するように設定している場合に発生します。
このエラーを解決してHubSpotのOffice 365連携の接続を進めるには、管理者が次のいずれかの方法を取ることができます:
- ユーザー同意設定の更新: Microsoft の Azure ドキュメントにある以下の手順に従って、許可ユーザー検証済み出版社からのアプリに対する同意、選択した権限について(推奨)設定をオンにする。HubSpotは認証されたパブリッシャーなので、管理者がこの設定をオンにすると、アカウントのユーザーは何もしなくても受信トレイを接続できるようになります。
- 管理者同意ワークフローを有効にする: Microsoft の Azure ドキュメントに記載されている手順に従って、ユーザーが同意できないアプリに対して管理者同意を要求できる設定をオンにします。この設定をオンにすると、管理者は、ユーザーからのサードパーティーアプリのインストール要求を承認するよう促すEメール通知を受け取ることができます。管理者は、Admin consent requestsのページで、保留中のリクエストを確認し、承認することもできます。