# Zoomコネクタ

{% hint style="warning" %}
このドキュメントは外部ソースを参照しています。 Nexthink はサードパーティのドキュメントの正確性や、このページに記載されている情報に矛盾を生じさせる可能性のある外部の更新または変更を制御することはできません。 エラーや矛盾を[Nexthink サポート](https://support.nexthink.com/)に報告してください。
{% endhint %}

Zoom用コネクタは、通話品質データを測定および閲覧し、NexthinkのWebインターフェースを使用してZoom通話の問題を調査、トラブルシューティング、解決し、デジタル・エンプロイー・エクスペリエンス（DEX）の最適化における情報に基づいた意思決定をサポートします。

## 前提条件 <a href="#connectorforzoom-prerequisites" id="connectorforzoom-prerequisites"></a>

* ユーザーはMicrosoft Azure Active Directory（Azure AD）の一部です。
* Azure ADのコネクタを有効化しました。 詳細については、[Microsoft Azure Active Directory用コネクタ](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-microsoft-entra-id-azure-ad)のドキュメントを参照してください。
* Azure ADのユーザーのメールアドレスは、Zoomアカウントと同じです。
* あなたのZoomアカウントプランは**Pro**または**Business+**（Business, Education, Enterprise & Partners）です。

## Zoomアプリケーションの設定 <a href="#connectorforzoom-configuringthezoomapplicationzoomapp" id="connectorforzoom-configuringthezoomapplicationzoomapp"></a>

[Zoom App Marketplace](https://marketplace.zoom.us/)ページからZoomアプリケーションを設定して通話品質データを取得してください。

1. Zoomのクレデンシャルを使用してサインインします。
   * アプリケーションを構築する権限を持っていることを確認してください。 通常、この操作はアカウントの所有者にデフォルトで付与されますが、指定されたユーザーに手動で権限を与えることもできます。
2. Zoom App Marketplaceページの右上隅の**Develop**オプションに移動し、**Build Server-to-Server app**を選択します。
3. アプリケーションを**作成**して名前を付けます。
4. **アカウントID**、**クライアントID**、および**クライアントシークレット**を、将来の参照のためにコピーして保存します。 つまり、[Nexthinkコネクタ構成](#connectorforzoom-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration)用です。
5. **続行**し、**基本情報**と**開発者の連絡先**の必須フィールドを記入します。
6. **続行**し、将来の参照のために**シークレットトークン**を安全な場所にコピーします。 つまり、[Nexthinkコネクタ設定](#connectorforzoom-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration)用です。
7. **Continue** をクリックし、**Add Scopes** を選択して以下の権限を選びます:
   * **すべてのユーザーのミーティングを表示** (meeting:read:meeting:admin, meeting:read:list\_past\_participants:admin)
   * **ダッシュボードでユーザーのすべてのミーティング情報を表示** (dashboard:read:meeting:admin, dashboard:read:meeting\_participant\_qos:admin, dashboard:read:list\_meeting\_participants\_qos:admin, dashboard:read:list\_meeting\_participants:admin)
8. **続行**し、**アプリを有効化**します。
9. アプリケーションの有効化を確認するためにバリデーションメッセージを読みます。

## Nexthink Web インターフェースでのコネクタ設定 <a href="#connectorforzoom-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration" id="connectorforzoom-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration"></a>

Nexthink Webインターフェースから:

1. **管理** > **インバウンドコネクタ**に進みます。
2. ページの右上隅にある**新しいコネクタ**ボタンをクリックします。
3. リストから**Zoom**を選択します。
4. 保存した**アカウントID**、**クライアントID**、**クライアントシークレット**、および**シークレットトークン**を、NexthinkのZoom用コネクタの認証情報として入力します。 上記の[Zoomアプリケーションの設定](#connectorforzoom-configuringthezoomapplicationzoomapp)セクションを参照してください。
5. Zoomインバウンドコネクタを**保存する**。
6. 保存後、同じZoomインバウンドコネクタページから、右側のパネルを使用して製品内ドキュメントを開き、将来の参照のために**イベント通知エンドポイントURL**をコピーします。 つまり、Zoomでの[イベントサブスクリプション設定](#connectorforzoom-settingeventsubscriptionsinzoomeventsubscription)用です。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-2f08f0e10566a90076157add2d236108a954b4d1%2Fzoomconnectors-1715096047.png?alt=media" alt="ZoomConnectors-1715096047.png" width="760"><figcaption></figcaption></figure>

## Zoomでのイベントサブスクリプションの設定 <a href="#connectorforzoom-settingeventsubscriptionsinzoomeventsubscription" id="connectorforzoom-settingeventsubscriptionsinzoomeventsubscription"></a>

Zoom App Marketplaceで作成および[設定されたアプリケーション](#connectorforzoom-configuringthezoomapplicationzoomapp)から:

1. **機能**セクションに移動します。
2. トグルを使用して**イベントサブスクリプション**を有効にし、**+ イベントサブスクリプションを追加**を選択します。
3. **サブスクリプション名**を入力します。

   <figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-94b06f1782f8fa15dc84baabf18aeda60f46630d%2Fscreenshot-2022-06-07-at-15-22-37.png?alt=media" alt="Event subscriptions" width="539"><figcaption></figcaption></figure>
4. 製品内ドキュメントで提供された**イベント通知エンドポイントURL**を貼り付けて**バリデート**します。
5. **+ イベントを追加**をクリックします。
6. **ミーティング**セクションから、**ミーティング終了**オプションを選択し、**完了**をクリックします。 これにより、ミーティングを終了する際にZoomから情報が送信されることが保証されます。
7. イベントサブスクリプションを**保存**する。

   <figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-af156a51d31c35ef4b7d7c1cc1f953ae58cc86a0%2Fscreenshot-2022-06-07-at-15-26-05.png?alt=media" alt="Event types" width="521"><figcaption></figcaption></figure>

## 既知の制約 <a href="#connectorforzoom-knownlimitations" id="connectorforzoom-knownlimitations"></a>

* システムは、オンプレミスのADに参加していないmacOSデバイスの通話品質データを取得できません。
* Zoomは、\_Proアカウント\_で1日に30,000件、\_Business+\_アカウントで1日に60,000件の通話データリクエストに制限しています。
* システムは、1日あたり30,000 / 60,000件の通話データのみを取得します。

## FAQ <a href="#connectorforzoom-f.a.q" id="connectorforzoom-f.a.q"></a>

<details>

<summary>以前に検証トークンでコネクタを構成している場合、設定を変更する必要がありますか。</summary>

コネクタは、検証トークンが廃止されるまで、以前構成された検証トークンに依存しています。 コネクタが正しく動作することを確認するために、新しいフィールドで設定を更新してください。

</details>

<details>

<summary>通話品質データを取得するために、常にAzure ADのコネクタを使用する必要がありますか。</summary>

はい、NexthinkユーザーとZoom通話に参加するユーザーを識別するために使用されるフィールドは、メールアドレスです。

Azure AD用コネクタは、Nexthinkユーザーをメールアドレスに基づいて強化し、Zoomから提供される情報と一致させるのに必要です。

</details>

<details>

<summary>Collectorがインストールされていないデバイスからユーザーが通話を受けた場合、どうなりますか。</summary>

NexthinkはCollectorが動作している限り、デバイスと通話品質データ情報を関連づけます。 ユーザーが携帯電話からログインすると、NexthinkのWebインターフェースは、`mac_address`や接続タイプなどの情報を提供しますが、デバイス情報は提供しません。

</details>

<details>

<summary>Zoomサブスクリプションを無効化または削除することはできますか。</summary>

Zoom用コネクタは、サブスクリプションの無効化や削除を許可しません。

JWTトークンまたはシークレットトークンに誤った値を入力するか、Zoomで作成されるアプリケーションを削除することで、Zoomからの通話を処理しないようにすることができます。

</details>

<details>

<summary>Zoomエンドポイントに対する通話の数には、制限がありますか。</summary>

Nexthink Connector for Zoomは、Zoom APIエンドポイントへの通話を制限なく行うように設計されています。 レート制限はZoomアカウントのプラン（*Pro\_または\_Business+*）に依存します。

レート制限について詳しく知るには、[Zoom開発者サイト](https://developers.zoom.us/docs/api/rest/rate-limits/)を訪問してください。

</details>