# 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="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-dbbd4367330ead4f8b6b8ff64cda24e1cc997f61%2Fimage%20(156).png?alt=media" 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>
