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

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

Microsoft ドキュメントの 権限 セクションを参照して、必要な認可を確認してください。

アクション: ユーザーの MS Teams ステータスを取得

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

Microsoft Teams コネクタ Thinklet は、Microsoft Graph に提供される Get presence API エンドポイントを利用します。

• パラメータ： このアクションで使用されるデータをパラメータとして構成します。 パラメーターがシステムでどのようにマッピングされ、どのデータが必要か詳細を表示したい場合は、ツールチップアイコンにカーソルを合わせてください。

  • ユーザー UUID: MS Teams ステータスを取得したい Entra ID ユーザーの UUID。

• 出力

  • ユーザーの利用可能ステータス (UserAvailability): ユーザーの基本的なプレゼンス情報—利用可能、ビジー、外出中など。

  • ユーザーのアクティビティステータス (UserActivity): ユーザーの利用可能性に関する追加情報—通話中、プレゼンテーション中、外出中など。

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

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

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

フィールド	値
リソースパス	/users/{{userUuid}}/presence
メソッド	GET
ペイロード
出力	ユーザー活動 $.activity UserAvailability $.availability