「連携要求」のエラーを解決する

連携をHubSpotに接続しようとすると、［連携権限の要求］エラーが発生する可能性があります。HubSpotに接続するには、特定の連携に特定のユーザー役割や特定のアカウント全体のツールが必要なため、これらのエラーは発生します。

よくあるエラー

ユーザーがインテグレーションに接続しようとすると、次のようなエラーが表示されることがあります。問題の対処方法の詳細については、エラーに関連付けされたトラブルシューティングの手順を確認してください。

「接続を完了できませんでした：提供されたスコープが不十分なため、認証に失敗しました。アプリ開発者にコンタクトしてください。"

このエラーは、アプリのインストールURLのscopeクエリーパラメーターにない必須スコープがアプリの設定に含まれている場合に発生します。optional_scopeパラメーターに必要なスコープを含めてもエラーになる。

この問題を解決するには、アプリ開発者は、すべてのインストールURLに、アプリ構成で選択したすべての必須スコープが含まれていることを確認する必要があります。

"接続を完了できませんでした：インストールURLのスコープとアプリを設定したスコープの間に不一致があるため、認証に失敗しました。アプリ開発者にコンタクトしてください。"

以下のシナリオのいずれかが発生した場合、ユーザーはこのエラーに遭遇する：

• アプリのインストールURLに、アプリの設定で設定されていない条件付き必須またはオプションのスコープが含まれている。
• アプリをインストールする URL のoptional_scopeクエリーパラメーターに、条件付きで必須となるスコープを含めます。
• アプリをインストールするURLのスコープパラメーターに、オプションのスコープが誤って含まれています。例えば、アプリの設定でcrm.objects.custom.readスコープがオプションのスコープとして設定されているが、提供されたインストールURLが/authorize?client_id=123&redirect_uri=xyz&scope=crm.objects.custom.readの場合、このエラーが発生する。

「接続を完了できませんでした。この連携を接続する権限がありません。」

連携を接続しようとしているHubSpotユーザーには、連携によって要求された必要なスコープを承認するために必要なユーザーロールまたは権限がありません。

このエラーを解決するには、アプリを接続されたユーザーが、HubSpotアカウントのHubSpotアプリマーケットプレイスからアプリを接続およびインストールできるように、アプリマーケットプレイス権限を設定する必要があります。これらの権限をユーザーに与えてもうまくいかない場合は、スーパー管理者権限を与えてエラーを解決する必要があります。

「このアカウントには、この連携によって必要なHubSpot機能へのアクセス権がありません。インテグレーターに連絡してください。」

連携の接続先の HubSpot アカウントに、連携で求められたスコープに対応するツールがありません。たとえば、Marketing Hub Starterサブスクリプションを使用しているHubSpotアカウントが、ワークフローツールを必要とする連携に接続しようとしている場合です。

このエラーを解決するには、HubSpotアカウントを必要なツールにアクセスできるサブスクリプションにアップグレードする必要があります。アカウントをアップグレードする場合は、サードパーティーのインテグレーターに連絡して、連携を接続するために必要なサブスクリプションを決定します。