# Microsoft Teamsコネクタ

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

マイクロソフト Teams 用コネクタは、通話品質データの測定・表示のほか、Nexthink のウェブインターフェースを通して問題の調査、トラブルシューティング、支援を行い、デジタル従業員エクスペリエンス（DEX）の最適化における意思決定をサポートします。

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

* ユーザーは Microsoft Entra ID の一部です。
* Microsoft Entra ID に参加したデバイスを使用して Azure にログインするか、Microsoft Entra ID と同期した Active Directory を使用します。
* [Microsoft Hybrid Entra に参加したデバイス](https://docs.microsoft.com/en-us/azure/active-directory/devices/concept-azure-ad-join-hybrid) に対する Entra ID コネクタを有効にしました。 詳細は [Microsoft Entra ID（Azure AD）用コネクタ](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) を参照してください。
* Nexthink の[コラボレーション エクスペリエンス](https://www.nexthink.com/platform/collaboration-experience/) ライセンスを持っています。

## Azure アプリケーションの設定 <a href="#connectorformicrosoftteams-configuringtheazureapplicationconfigureazureapp" id="connectorformicrosoftteams-configuringtheazureapplicationconfigureazureapp"></a>

通話品質データを取得するために[Azure](https://azure.microsoft.com/es-es/free/search/?ef_id=_k_EAIaIQobChMIodqLx8ichgMVu5xQBh2GnA_UEAAYASAAEgJxevD_BwE_k_\&OCID=AIDcmm68ejnsa0_SEM__k_EAIaIQobChMIodqLx8ichgMVu5xQBh2GnA_UEAAYASAAEgJxevD_BwE_k_\&gad_source=1\&gclid=EAIaIQobChMIodqLx8ichgMVu5xQBh2GnA_UEAAYASAAEgJxevD_BwE) ページからアプリケーションを設定します。

1. Azure の資格情報を使用してサインインします。
2. 新しいアプリケーションを登録します。
   * 登録プロセス中に、**シングル テナント** オプションを選択します。
3. **リダイレクト URL** の場合、**Web** を選択してください。
   * すでに Azure ポータルにアプリケーションが存在する場合、そのアプリケーションを再利用して通話記録の読み取り権限を割り当てることができます。
4. アプリケーションを**登録**します。
5. 左側のメニューから**API の権限**オプションにアクセスします。
6. **Microsoft Graph** に対する権限を追加します。
   * **CallRecords.Read.All** を選択し、API 権限を追加します。 下の画像を参照してください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-02312c25fe03c26933d619ae5208db736c2d6013%2Fimage-20240524-061021.png?alt=media" alt="Configuring the Azure application" width="760"><figcaption></figcaption></figure>

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-45bf696db287ca7253d52ad72870f8da0428b2fc%2Fimage-20240524-061723.png?alt=media" alt="image-20240524-061723.png" width="760"><figcaption></figcaption></figure>

{% hint style="info" %}
権限リストの **ステータス** 列は、使用中のAzureアカウントが適切な権限を欠いているかどうかを示します。
{% endhint %}

上記の手順については、[Microsoft ドキュメント](https://docs.microsoft.com/en-us/graph/auth-register-app-v2)を参照してください。

7. 設定されているアプリケーションの **概要** セクションを開いて、Azure AD の資格情報をコピーして保存し、将来の参照用に利用します。 つまり、[Nexthink コネクタ構成](#connectorformicrosoftteams-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration)のためにです。
   * **アプリケーション (クライアント) ID**
   * **ディレクトリ (テナント) ID**

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-cecf827d98f58d1255944b3c069c4d825475b356%2Fimage-20220513-132432.png?alt=media" alt="MS Teams enrichment" width="744"><figcaption></figcaption></figure>

8. 将来の参照用に、Azure ポータルの **証明書とシークレット** オプションを使用してクライアントシークレット **値** を生成し、コピーします。 つまり、[Nexthink コネクタ構成](#connectorformicrosoftteams-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration)のためにです。
   * **新しいクライアントシークレット**をクリックします。
   * **説明**と**有効期限**の値を入力します。
   * **追加**をクリックし、**値**をコピーします。

{% hint style="info" %}
有効期限後、Azure ポータルと Nexthink コネクタの両方でクライアントシークレットを更新する必要があります。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-b1527f0caa2ca474810b41caf647fa593a2622b6%2Fimage-20220419-071120.png?alt=media" alt="Generate new client secret" width="744"><figcaption></figcaption></figure>

## Nexthink Web インターフェースにおけるコネクタの設定 <a href="#connectorformicrosoftteams-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration" id="connectorformicrosoftteams-configuringtheconnectorinthenexthinkwebinterfaceconnectorconfiguration"></a>

1. **管理** > **インバウンドコネクタ**に移動します。
2. ページの右上隅にある**新しいコネクタ**ボタンをクリックします。
3. インバウンドコネクタのリストから **Microsoft Teams** を選択します。
4. Azure の設定されたアプリケーションから収集した 3つの **クレデンシャル** を入力します。 上記の[手順7と8](#connectorformicrosoftteams-configuringtheazureapplicationconfigureazureapp)を参照してください。
5. MS Teams インバウンドコネクタを**保存**します。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-5a1058086b12928925215a1d2eb1a1d3660aed32%2Fteams-1665479648.png?alt=media" alt="Configuring the MS Teams connector in the Nexthink web interface" width="744"><figcaption></figcaption></figure>

## 既知の制限 <a href="#connectorformicrosoftteams-knownlimitationsknownlimitations" id="connectorformicrosoftteams-knownlimitationsknownlimitations"></a>

* システムはオンプレミスの AD に参加していない macOS デバイスの通話品質データを取得できません。
* 時々、システムは通話を仮想マシンにリンクさせません。これは、Microsoft Teams コネクタがデバイスを MAC アドレスに基づいて識別するためで、仮想マシンにとって常に信頼できるわけではありません。

## FAQ <a href="#connectorformicrosoftteams-faq" id="connectorformicrosoftteams-faq"></a>

<details>

<summary>システムは通話品質をどのようにして計算しますか？</summary>

音声とビデオの通話品質の分類は、Microsoft の悪いと良いの定義に基づきます。

Microsoft [Call Quality Dashboard のストリーム分類](https://docs.microsoft.com/en-us/microsoftteams/stream-classification-in-call-quality-dashboard)ドキュメントを参照してください。

</details>

<details>

<summary>通話品質データを取得するには、常に Microsoft Entra ID のコネクタを使用する必要がありますか？</summary>

必ずしもそうとは限りません。 すべてのユーザーが Entra ID のみで認証する場合、Microsoft Entra ID のコネクタは不要です。

Entra ID のコネクタは、[Hybrid Entra ID に参加したデバイス](https://docs.microsoft.com/en-us/azure/active-directory/devices/concept-azure-ad-join-hybrid) のみで有効にすべきです。 例えば、オンプレミスで Entra ID に対して認証するユーザーがいるときです。

</details>

<details>

<summary>Nexthink Collector がインストールされていないデバイスでユーザーがコールを受けた場合、何が起こりますか？</summary>

Nexthink は、コレクターがインストールされている少なくとも1台のデバイスでユーザーの通話品質データを関連付けます。 したがって、コレクターがインストールされていないモバイルデバイスで Microsoft Teams 通話に参加した場合、システムはユーザーのセッションの詳細は報告しますが、デバイス情報は記録しません。

</details>

<details>

<summary>どのようにしてサブスクリプションが正しく設定されているかを確認できますか？</summary>

NexthinkのWebインターフェースから、コネクターページの**資格情報テスト**ボタンを使用して、**AzureテナントID**、**AzureクライアントID**、および**Azureクライアントシークレット**の値を検証できます。

</details>

<details>

<summary>通話品質データはどのくらいの頻度で更新されますか？ 即時ですか？</summary>

現在のメカニズムは、Graph APIからデータを受け取るためにサブスクリプションを使用します。

通話が終了するたびに、システムは通話の詳細をNexthinkプラットフォームにプッシュします。 データは通常、通話終了後5～10分で届くため、このプロセスは即時ではありません。

</details>

<details>

<summary>Nexthinkは仮想マシンでの通話の通話品質データを取得しますか？</summary>

これは[既知の制限](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-teams)であり、Microsoft TeamsコネクターがMACアドレスに基づいてデバイスを識別するため、仮想マシンの通話をリンクできない場合があります。

</details>

<details>

<summary>Microsoft TeamsコネクターはNexthinkで新しいユーザーを作成しますか？</summary>

いいえ. Microsoft TeamsコネクターはNexthinkにユーザーを作成しません。 既存のユーザーにMicrosoft Teamsから取得した属性を追加するのみです。

同期中に、Nexthinkに存在しないユーザーのデータを受け取る場合があります。 システムはこれらのエントリを無視し、新しいユーザー記録を作成しません。

</details>