Microsoft TeamsコネクタThinklet

Microsoft Teams コネクタの Thinklet を設定し、ワークフロー内で特定の操作を実行します；

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
ペイロード
出力	UserAvctivity $.activity UserAvailability $.availability