翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ZoomInfo 統合
<a name="zoominfo-integration"></a>

ZoomInfo アクションコネクタを使用すると、企業データと連絡先データを検索し、自然言語を通じて Amazon Quick で直接企業データとインテントデータをクエリできます。

Amazon Quick は、ZoomInfo の複数の認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。
+ **デフォルトの OAuth アプリケーション** –AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。ユーザーは ZoomInfo アカウントで直接認証します。
+ **カスタム OAuth アプリケーション** – カスタマー管理の OAuth アプリケーションを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。
+ **Service-to-Service OAuth** – ユーザー操作なしでserver-to-server認証にクライアント認証情報を使用します。自動ワークフローに適しています。
+ **API キー** – 認証に API キーを使用します。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## [開始する前に]
<a name="zoominfo-integration-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ クエリするデータ製品にアクセスできるアクティブな ZoomInfo アカウント。
+ **カスタム OAuth アプリ**または **Service-to-Service OAuth** の場合: ZoomInfo 管理者からの OAuth 認証情報。ZoomInfo は Okta for OAuth を使用します。
+ **API キー**の場合: ZoomInfo が発行した API キー。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## ZoomInfo の設定
<a name="zoominfo-source-setup"></a>

**デフォルトの OAuth アプリ**認証を使用している場合は、このセクションをスキップして に進みます[Amazon Quick でのコネクタのセットアップ](#zoominfo-quicksuite-setup)。

カスタム OAuth アプリまたはService-to-ServiceOAuth 認証の場合は、ZoomInfo 管理者と協力して ZoomInfo Okta テナントに OAuth クライアントを登録し、Amazon Quick Callback URL をリダイレクト URI `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`として追加します。{{{region}}} を自分のAWSリージョン (例: ) に置き換えます`us-east-1`。step-by-stepの手順については、[ZoomInfo ドキュメントの「ZoomInfo MCP の概要](https://docs.zoominfo.com/docs/zi-api-mcp-overview/)と[デベロッパーポータルガイド](https://docs.zoominfo.com/docs/app-creation-developer-portal-guide)」を参照してください。 ZoomInfo クライアント ID とクライアントシークレットを記録します。Amazon Quick を設定するときに必要になります。API キー認証では、ZoomInfo アカウントから API キーを生成します。

## Amazon Quick でのコネクタのセットアップ
<a name="zoominfo-quicksuite-setup"></a>

### 使用可能なタブから接続する
<a name="zoominfo-quick-connect"></a>

デフォルトの OAuth アプリ認証を使用する場合は、追加の設定なしで**、利用可能な**タブから直接接続できます。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **使用可能**タブで、**ZoomInfo** を見つけて**接続**を選択します。

1. ZoomInfo サインインフローを完了し、リクエストされたアクセス許可を付与します。

他の認証方法のいずれかを使用してコネクタを設定するには、以下で説明するように、**Create for your team** タブを使用します。

### チームの作成タブから を作成する
<a name="zoominfo-full-setup"></a>

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. **ZoomInfo** を見つけて選択します。

1. コネクタ**の名前**を入力します。必要に応じて、 **\+ 説明を追加** を選択して説明を追加します。

1. Connection **type** で、**Public network** を選択します。

1. **OAuth 設定では**、次のいずれかの認証方法を選択し、必須フィールドを設定します。

   1. **デフォルトの OAuth アプリ**の場合:

      追加の認証情報は必要ありません。**[次へ]** を選択して続行します。

   1. **カスタム OAuth アプリ**の場合は、次のフィールドを設定します。
      + **クライアント ID** – ZoomInfo OAuth クライアントのクライアント ID。
      + **パブリック OAuth クライアント** (オプション) – ZoomInfo OAuth クライアントがパブリッククライアント (クライアントシークレットなし) として設定されている場合は、このオプションを選択します。
      + **クライアントシーク**レット – ZoomInfo OAuth クライアントからのクライアントシークレット。
      + **トークン URL** – トークンエンドポイント。デフォルト: `https://okta-login.zoominfo.com/oauth2/default/v1/token`
      + **認可 URL** – 認可エンドポイント。デフォルト: `https://okta-login.zoominfo.com/oauth2/default/v1/authorize`
      + **リダイレクト URL** – Amazon Quick コールバック URL があらかじめ入力されています。

   1. **Service-to-Service OAuth **では、次のフィールドを設定します。
      + **クライアント ID** – ZoomInfo OAuth クライアントのクライアント ID。
      + **クライアントシーク**レット – ZoomInfo OAuth クライアントからのクライアントシークレット。
      + **トークン URL** – トークンエンドポイント。デフォルト: `https://okta-login.zoominfo.com/oauth2/default/v1/token`

   1. **API キー**の場合は、次のフィールドを設定します。
      + **API キー** – ZoomInfo API キー。
      + **E** メール (オプション) – API キーに関連付けられた E メールアドレス。

1. [**次へ**] を選択します。

1. **デフォルトの OAuth アプリ**または**カスタム OAuth アプリ**を選択した場合、ZoomInfo 認可ウィンドウが開きます。リクエストされたアクセス許可を確認し、**許可**を選択します。

1. **レビュー**ページで、コネクタで使用可能なアクションを確認します。[**次へ**] を選択します。

1. **公開**ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

1. **[公開]** を選択します。

## 使用可能なアクション
<a name="zoominfo-integration-actions"></a>

コネクタを設定すると、ZoomInfo によって公開されるアクションを使用できます。コネクタの現在のアクションセットを確認するには、Amazon Quick コンソールのコネクタの**利用可能なアクション**ビューに移動します。

## の管理とトラブルシューティング
<a name="zoominfo-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="zoominfo-troubleshooting-auth"></a>
+ **サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ)** — ZoomInfo アカウントがアクティブであることを確認します。カスタム OAuth アプリの場合、ZoomInfo OAuth クライアントのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。
+ **無効なクライアント認証情報 (カスタム OAuth アプリまたは Service-to-Service OAuth)** — クライアント ID とクライアントシークレットが ZoomInfo OAuth クライアントの値と一致していることを確認します。
+ **API キー認証が失敗**する – API キーが取り消されていないことを確認します。