> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/ja/user-guide/workflows/creating-workflows/configuring-connector-thinklet/microsoft-teams-connector-thinklet.md).

# 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-fc536f96b3a42009454d83801e5b564c6cfdda7f%2Fimage%20(384).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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.