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

Last updated

Was this helpful?