# Microsoft Teamsコネクターシンクレット

ワークフロー内で特定のアクションを実行するために、Microsoft Teams コネクタシンクレットを構成します。

{% hint style="info" %}
Microsoft ドキュメントの [権限](https://learn.microsoft.com/en-us/graph/api/presence-get?view=graph-rest-1.0\&tabs=http#permissions) セクションを参照して、必要な認可を確認してください。
{% endhint %}

## アクション: ユーザーの MS Teams ステータスを取得 <a href="#microsoftoutlookconnectorthinklet-action-sendanemailtoonerecipient" id="microsoftoutlookconnectorthinklet-action-sendanemailtoonerecipient"></a>

**ユーザーの MS Teams ステータスを取得する** は、MS Teams でのユーザーの利用可能状況および活動ステータスを取得します。

Microsoft Teams コネクタ Thinklet は、Microsoft Graph に提供される [Get presence](https://learn.microsoft.com/en-us/graph/api/presence-get?view=graph-rest-1.0\&tabs=http#permissions) API エンドポイントを利用します。

<figure><img src="/files/glDJYbBd8Ddqmr9FlsOg" alt="" width="375"><figcaption></figcaption></figure>

* **パラメータ：** このアクションで使用されるデータをパラメータとして構成します。 パラメーターがシステムでどのようにマッピングされ、どのデータが必要か詳細を表示したい場合は、ツールチップアイコンにカーソルを合わせてください。
  * **ユーザー UUID**: MS Teams ステータスを取得したい Entra ID ユーザーの UUID。
* **出力**
  * **ユーザーの利用可能ステータス (**`UserAvailability`**)**: ユーザーの基本的なプレゼンス情報—利用可能、ビジー、外出中など。
  * **ユーザーのアクティビティステータス (**`UserActivity`**):** ユーザーの利用可能性に関する追加情報—通話中、プレゼンテーション中、外出中など。

{% hint style="info" %}
無効なユーザー UUID が提供された場合、または Entra ID にそのユーザーが存在しない場合、どちらの出力も `PresenceUnknown` を返します。

このコネクタをワークフローで使用する際、出力が `PresenceUnknown` でないことを確認する条件分岐を追加してください。 これにより、MS Teams のプレゼンスステータスが正常に取得されたことを保証します。
{% endhint %}

以下の表は、コネクタを再作成する際に必要な API サービスコネクタの詳細を示しています：

<table><thead><tr><th width="272">フィールド</th><th>値</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>/users/{{userUuid}}/presence</code></td><td></td></tr><tr><td>メソッド</td><td>GET</td><td></td></tr><tr><td>ペイロード</td><td></td><td></td></tr><tr><td>出力</td><td><p><code>ユーザー活動 $.activity</code></p><p><code>UserAvailability $.availability</code></p></td><td></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/ja/user-guide/workflows/creating-workflows/configuring-connector-thinklet/microsoft-teams-connector-thinklet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.