Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Teamsコネクタについて

MiyakeMito
March 25, 2023

 Teamsコネクタについて

MiyakeMito

March 25, 2023
Tweet

More Decks by MiyakeMito

Other Decks in Technology

Transcript

  1. 本日の参考サイト 6 ◼ Microsoft Teamsコネクタ のドキュメント(Microsoft Learn) https://learn.microsoft.com/ja-jp/connectors/teams/ ◼ MoreBeerMorePower(Hiroさん)

    https://mofumofupower.hatenablog.com/ ◼ ルドルフもわたるふもいろいろあってな(わたるふさん) https://wataruf.hatenablog.com/
  2. Teamsコネクタのアクション ① 13 5 チームにメンバーを追加する この操作はメンバーをチームに追加します。 6 チームの作成 この操作は新しいチームを作成します。 23

    チームの一覧を表示する この操作では、メンバーになっているすべての Teams (Office 365 Groups) のリストを取得します。 24 チームを取得する この操作を実行すると、チームの一意の ID を使用してチームの詳細が返されます。 チーム 関連 26 チャネルの一覧表示 この操作は、特定のチームのすべてのチャネルの一覧を取得します。 27 チャネルを作成する この操作は特定のチームの新しいチャネルを作成するために使用されます。 チャネル 関連 7 チャットの作成 この操作により、1対1またはグループ チャットが作成されます 25 チャット一覧を作成 この操作により最近のチャットの一覧が取得されます。 チャット 関連 15 メンバー リストを作成 この操作により、1対1またはグループ チャットが作成されます メンバー 関連
  3. Teamsコネクタのアクション ② 14 16 タグからメンバーを削除する この操作はタグからメンバーを削除します。 17 タグにメンバーを追加する この操作によってユーザーがタグに追加されます。 19

    タグのメンバーを一覧表示する この操作はタグのメンバーを一覧表示します。 20 タグを削除する この操作はタグを削除します。 21 チームのタグをすべて一覧表示する この操作によりタグの一覧を取得します。 22 チームのタグを作成する この操作はタグを作成します。 タグ 関連 18 タグの @mention トークンを取得する この操作は、トークンを作成してメッセージやアダプティブ カードに挿入し、チャネルが含むユーザーとし て @mention にタグを送信します。 29 ユーザーの @mention トークンを取得する この操作は @mention 対象のユーザーに、メッセージやアダプティブカードに挿入できるトークンを作成します。 メンション 関連 2 Teams 会議の作成 招待状の下部にあるリンクから会議を作成して Teams のオンライン会議に参加する Teams 会議関連
  4. Teamsコネクタのアクション ③ 15 8 チャットまたはチャネルでメッセージを投稿する この操作を実行すると、チャットまたはチャネルにメッセージが投稿されます。 12 チャネル内のメッセージで応答します この操作はチャネルのメッセージで応答します。 13

    メッセージを取得する この操作は、特定のチームのチャネルからメッセージを取得するために使用されます。 14 メッセージ詳細を取得する この操作により、チャットまたはチャネル内のメッセージ詳細が取得されます。 メッセージ 関連 3 アダプティブ カードを投稿して応答を待機する この操作により、アダプティブ カードをチャットやチャネルに投稿し、応答を待機します。 4 オプションの選択をフローボットとしてユーザーに投稿する Teams ユーザーにメッセージを送信するプロセスを簡単に自動化するもので、このメッセージには、 応答する前に選択する必要のある一連のオプションが含まれています。 9 チャットやチャネルにカードを投稿する この操作により、カードがチャットやチャネルに投稿されます。 10 チャットやチャネルのアダプティブ カードを更新する この操作を実行すると、既存のアダプティブ カードが更新されます。 11 チャネル内でアダプティブ カードを使用して返信する この操作により、チャネルへの返信がアダプティブ カードを使用して行われます。 1 Teams のタスク モジュールで応答 この操作を実行すると、Microsoft Teams の既存のタスク モジュールにあるアダプティブ カードで 応答することができます。 アダプティブカード 関連 28 フィード通知を投稿する この操作によりフィード通知が投稿されます。 フィード通知 関連 次ページ 参照
  5. チームIDとチャネルIDの取得方法 17 Microsoft Teams のチームID、チャネルIDの確認方法(山田さん) https://qiita.com/yamad365/items/e480f77e9102b132d258 ◼ チームID(M365グループID) Teams管理センターでも可能 (こちらの方がカンタンかも)

    ◼ チャネルID(conversationId、会話ID) チームへのリンクを取得 https://teams.microsoft.com/l/team/~/conversations ?groupId=<チームID>&tenantId= ~ 該当のチャネルを選び、 URLを確認 https://teams.microsoft.com/_#/conversations/<チャネル名> ?threadId=<チャネルID>&ctx=channel 19:f8c4deeda62a49a6ae13c00e [email protected] のような値 00794145-462d-4a3c-9505-8e4eexxxxxxc のような値
  6. 20 ◼ チャネルチャットのメッセージID ◼ 1対1チャット や グループチャットのメッセージID チームID チャネルID チャットID

    子(応答)メッセージの [replyToId] が親(スレッドの先頭 のメッセージIDを保持する テナント:テナントIDで一意 メッセージID replyToId メッセージID メッセージID テナント:テナントIDで一意 チャットIDの代わりにチャネルIDを 指定可能なアクションがいくつかある
  7. チームの種類 23 ▪ パブリック ➢ 組織に所属するユーザーなら誰でも自由に参加可能 ▪ プライベート ➢ メンバー追加に制限がある

    (チーム所有者が追加する) ▪ 組織全体 ➢ 組織内の全ユーザーが自動的に参加する ➢ 組織全体で5つまで作成可能 ➢ ライセンス未付与のユーザーもチームに追加される。 ライセンスのないユーザーが初めて Teams にサインインすると、 Microsoft Teams Exploratoryライセンスが割り当てられる
  8. 24 チーム チーム所有者 参加方法 参加していないメンバーか らの見え方 ゲスト参加 SharePoint Onlineサイト パブリック

    チーム作成者 チーム所有者が任命 チーム所有者が追加 組織内のユーザーなら自由 に参加可能 表示 (「チームに参加」から) 可能 専用サイトが作成される プライベート チーム作成者 チーム所有者が任命 チーム所有者が追加 メンバーからの申請を所有 者が承認する(※1) 所有者がチームコードを生 成し伝える 非表示 可能 専用サイトが作成される 組織全体 以下ロールを割り当てられた ユーザーが自動的に ・グローバル管理者 ・Teams管理者 チーム所有者が任命 組織内のアクティブなユー ザー 以下は除く ・ゲスト ・リソース ・共有メールボックス - 可能 専用サイトが作成される チームの比較 (※1 参加したいユーザーが、チームのリンクからアクセスすることで申請する方法もある)
  9. 出力仕様 ① 27 ◼ チーム ➢ フローの実行者は、チームの所有者になる ◼ SharePoint Online

    ➢ フローの実行者は、 サイト管理者および、Members(SPOgroup)に所属
  10. 出力仕様 ② 28 ◼ Microsoft 365グループ ➢ フローの実行者がグループの所有者およびメンバーになる ➢ メールアドレスのアカウント

    ✓ チーム名に半角英数が含まれない:msteams_xxxxx@~ ✓ チーム名に半角英数が含まれる :チーム名の半角英数部分@~ ➢ GALに表示しないがONとなる
  11. 作成したチームの設定 29 メンバーにチャネルの作成と更新を許可する オン メンバーにプライベート チャネルの作成を許可する オン メンバーにチャネルの削除と復元を許可する オン メンバーにアプリの追加と削除を許可する

    オン メンバーにカスタム アプリのアップロードを許可する オン メンバーにタブの作成、更新、および削除を許可する オン メンバーにコネクタの作成、更新、および削除を許可する オン メンバーに自分のメッセージを削除するオプションを与える オン メンバーに自分のメッセージを編集するオプションを与える オン メッセージで Teams をメンションする オン メッセージでチャネルをメンションする オン ゲストはチャンネルを追加および編集できる オフ ゲストはチャンネルを削除できる オフ Giphy オン Giphy コンテンツの評価 中レベル ステッカーとミーム オン カスタム ミーム オン メッセージのアクセス許可 メンション ゲストのアクセス許可 楽しい設定 これらを設定しながらチームを作成 する場合はGraph APIを利用します https://learn.microsoft.com/ja- jp/graph/api/team-post?view=graph- rest-1.0&tabs=http タグ タグを管理できるユーザー チームの所有者 他のアプリのタグを自動的に適用する オン 標準チャネルのみ可能
  12. Microsoft 365グループ作成制限 30 ◼ チームの作成が可能なユーザーを制限することが可能 ➢ Microsoft 365 グループを作成できるユーザーを管理する https://learn.microsoft.com/ja-jp/microsoft-365/solutions/manage-

    creation-of-groups?view=o365-worldwide&WT.mc_id=M365-MVP- 5000493 ◼ 当然、制限されているユーザーではPower Automateからも作成不可 • チームの作成は情シスに依頼 • 情シスにてチーム作成後、依頼者 を所有者に設定 という運用のお供に・・・
  13. 所有者権限を削除する 31 ◼ フローの実行者は自動的に作成されたチームの所有者(M365グループ所有者) の権限が付与される ◼ 所有者権限をはく奪する際はGraph APIを使用し、メンバーに降格させる ◼ さらにグループから除外する場合は、

    ◼ https://learn.microsoft.com/ja-jp/graph/api/group-delete-owners?view=graph-rest-1.0&tabs=http https://graph.microsoft.com/v1.0/groups/{id}/ owners/{id}/$ref DELETE application/json チームID (M365グループID) userId Office 365 Users コネクタ (M365管理センター等からも取得可能) Office 365 Groups コネクタ
  14. チームの一覧表示 33 ◼ フロー実行者が所有者またはメンバーになっているすべての Teams (Office 365 Groups) のリストを取得する ◼

    チームごとに取得できる項目は、チームID(M365グループID)、表示名、 詳細、アーカイブ状態、テナントID
  15. 34 "body": { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams", "@odata.count": 2, "value": [ {

    "id": "00794145-462d-4a3c-9505-8e4ee100935c", "displayName": "PVAfT", "description": "Power Virtual Agent サンドボックス", "isArchived": false, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" }, { "id": "fc2ec21d-5c5e-4603-8acf-faace4d4dfbf", "displayName": "Sample Engineering Team", "description": "This is a sample engineering team", "isArchived": false, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" } ] } 出力 チームID チームの表示名 チームの詳細 アーカイブ済みか テナントID 開始位置の座標 とサイズ 様々なTeamsコネクタのアクショ ンで利用する アーカイブの有無に関わらずfalse が出力される模様
  16. 37 1階層 2階層 説明 id - チームID createdDateTime - チーム作成日時

    displayName - 表示名 description - チームの説明 internalId - 内部ID specialization - ??? visibility - public(組織全体も) / private webUrl - チームの Web URL isArchived - アーカイブ済みか isMembershipLimitedToOwners - メンバーの追加を禁止 discoverySettings showInTeamsSearchAndSuggestions Teams の検索とサジェストに表示する memberSettings allowCreateUpdateChannels チャネルを追加および編集する allowCreatePrivateChannels プライベート チャネルの追加と編集 allowDeleteChannels チャネルの削除 allowAddRemoveApps アプリを追加、編集、または削除する allowCreateUpdateRemoveTabs タブを追加、編集、または削除する allowCreateUpdateRemoveConnectors コネクタを追加、編集、または削除する guestSettings allowCreateUpdateChannels ゲストはチャンネルを追加および編集できる allowDeleteChannels ゲストはチャンネルを削除できる messagingSettings allowUserEditMessages 送信済みメッセージを編集する allowUserDeleteMessages 送信済みメッセージを削除する allowOwnerDeleteMessages チーム所有者が送信したメッセージを削除する allowTeamMentions メッセージで Teams をメンションする allowChannelMentions メッセージでチャネルをメンションする funSettings allowGiphy Giphy giphyContentRating Giphy コンテンツの評価 allowStickersAndMemes ステッカーとミーム allowCustomMemes カスタム ミーム summary ownersCount チーム所有者の数 membersCount チームメンバーの数 guestsCount チームのゲストユーザーの数
  17. チームを削除する 39 ◼ Microsoft 365グループを削除することで、チームも削除可能 ◼ グループの削除は、[Office 365 Groups]コネクタの[HTTP 要求

    V2 を送信する]ア クションを利用し、Graph API による削除を行う ◼ SPOサイトも削除される ◼ https://learn.microsoft.com/ja-jp/graph/api/group-delete?view=graph-rest-1.0&tabs=http Teamsコネクタに、チームを削除 するアクションは存在しません https://graph.microsoft.com/v1.0/groups/{id} DELETE application/json チームID (M365グループID) Office 365 Groups コネクタ
  18. チャネルの種類 48 ▪ 標準 ➢ 全チームメンバーに共有され、自動的に所属する ▪ プライベート ➢ チームメンバーを限定し共有可能

    ➢ 参加するには招待される必要がある ▪ 共有 ➢ チームメンバーまたは組織内外のユーザーと共有 ➢ 組織外:B2B 直接接続が必要 (B2Bコラボレーション不可)
  19. テナントA チーム1 チーム2 テナントD チャネルメンバーの範囲 49 テナントC AAD B2B 直接接続

    AAD B2B コラボレーション 標準 プライベート 共有 B2B 直接接続 ユーザー テナントB ゲストユーザー 外部チャット 外部ユーザー チームの 所有者 メンバー
  20. 50 チャネル チャネルの編集権 参加方法 参加可能 参加していないテナント内 メンバーからの見え方 SharePoint Onlineサイト 標準

    チーム所有者 チーム内のメンバー全員が 自動的に参加 チームメンバーが自動的に 参加 ゲストユーザー 見えない (該当チームに参加してい ない共有チャネルメンバー から) 他の標準チャネルと共有 (チームに対応したサイ ト) プライベート チャネル所有者 チャネル所有者が招待 チームメンバー ゲストユーザー 見えない 個別のチャネル用サイトが 作成される 共有 チャネル所有者 チャネル所有者が招待 テナント内ユーザー B2B 直接接続ユーザー 見えない 個別のチャネル用サイトが 作成される チャネルの比較 https://learn.microsoft.com/ja-jp/microsoftteams/teams-channels-overview#channel-feature-comparison
  21. 共有チャネル 51 ▪ Azure AD B2B コラボレーションによるゲストアクセスユーザー は参加不可 ➢ Azure

    AD B2B 直接接続による外部ユーザーで参加させる (要Azure AD Premium P1 ライセンス) ▪ チーム外から招待されたメンバーは、チーム内の他のチャネル は見えない、がチーム名は見える 共有元 チームメンバーから 共有されたユーザーから
  22. 53 ユーザー種類 招待可能となる ユーザ (招待されるユー ザーの状態) 招待の手順 チーム参加 チャット利用 ファイル共有

    ビデオ通話 ゲストユーザー • Microsoft 365アカウ ント • Microsoftアカウント • ソーシャル ID プロバ イダー • ワンタイムパスコー ド認証による上記以 外のメールアカウン ト(*1) AADやM365管理画面 より登録 チームに招待される 事で参加可能 1対1チャット グループチャット チャネルチャット が可能 チーム内で共有可能 • プライベート通話 • IPビデオ通話 • 今すぐ会議 会議に招待される 外部ユーザー • Microsoft 365アカウ ント • Microsoftアカウント (Teamsが利用でき ること) 各ユーザーがTeams アプリの検索 (Microsoft Search)より 参加不可 招待したユーザーと の 1対1チャット グループチャット が可能 不可 • プライベート通話 • IPビデオ 会議に招待される B2B直接接続ユーザー • Microsoft 365アカウ ント • (Teamsが利用でき ること) AAD管理センター External Identities テナント間アクセス 設定 (互いのテナントで 設定する必要があ る) 共有チャネルに招待 されることで参加可 能 (ただしチーム内の 他のチャネルは不 可) チャネルチャットが 可能 招待されたチャネル 内で可能 • プライベート通話 会議に招待される 外部アクセス ユーザーの比較 (*1)https://learn.microsoft.com/ja-jp/azure/active-directory/external-identities/one-time-passcode
  23. ゲストの制限 54 ▪ Teams管理センター - チーム-チームを管理 - [チーム] - 設定

    - ゲストのアクセス許可 – ゲストはチャンネルを追加および編集できる:ON/OFF – ゲストはチャンネルを削除できる:ON/OFF ▪ Teams管理センター - ゲストアクセス – Teams へのゲスト アクセスを許可する:ON/OFF – 通話 - プライベート通話を行う:ON/OFF – 会議 ➢ ビデオ:ON/OFF ➢ 画面共有:画面全体/単一アプリケーション/禁止 ➢ 今すぐ会議 :ON/OFF – メッセージング ➢ 送信済メッセージを編集,送信済メッセージを削除,チャットの削除,チャット,会話での Giphy, Giphy コンテンツの評価,会議でのミーム,会話でのステッカー,メッセージ用のイマーシブ リー ダー ▪ SharePoint管理センター – ポリシー – 共有 – 外部共有(SPO、ODfB) – コンテンツを共有できる相手 ➢ 自分の組織内のユーザーのみにすると、組織内のファイルをゲストに共有できない
  24. 外部アクセスの制限 55 ▪ Teams管理センター – 外部アクセス – ユーザーがアクセスできる外部ドメインを選択します ➢ 外部ドメインをすべて許可する

    ➢ 特定の外部ドメインのみを許可する ➢ 特定の外部ドメインのみをブロックする ➢ 外部ドメインをすべてブロックする – 外部ドメインをすべて許可する ➢ :ON/OFF – 組織内のユーザーは、アカウントが組織によって管理されていない Teams ユーザーと通信できます ➢ :ON/OFF – 組織内のユーザーが Skype ユーザーと通信できるようにします。 ➢ :ON/OFF
  25. 61 "body": { "@odata.context": "https://graph.microsoft.com/v1.0/・・・, "@odata.count": 7, "value": [ {

    "id": "19:[email protected]", "createdDateTime": "2023-02-07T12:40:49.456Z", "displayName": "Private Channel", "description": "for testing", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "webUrl": "https://teams.microsoft.com/l/channel/19%3Acc47005ff12d40f18c1d4f1e00d75c08%40t ・・・", "membershipType": "private" }, { "id": "19:[email protected]", "createdDateTime": "2022-05-28T12:30:40.415Z", "displayName": "Announcements 📢", "description": "This is a sample announcements channel that is favorited by default.", "isFavoriteByDefault": true, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "webUrl": "https://teams.microsoft.com/l/channel/19%3Ab0568b463e0a40a8876123d2271・・・", "membershipType": "standard" }, 出力 チャネルID チャネルの表示名 チャネルの詳細 チャネルのURL 標準:standard プライベート:private 共有:unknownFutureValue 様々なTeamsコネクタのアクション で利用する 既定でチャネルを表示するか (trueの場合のみ項目が出力されるため注意)
  26. チャネルを削除する 63 ◼ Teamsコネクタに、チャネルを削除するアクションは存在しない ◼ よって、[Office 365 Groups]コネクタの[HTTP 要求 を送信する]アクショ

    ンを利用し、Graph API による削除を行う ◼ https://learn.microsoft.com/ja-jp/graph/api/channel-delete?view=graph-rest-1.0&tabs=http https://graph.microsoft.com/v1.0/teams/{id}/ channels/{id} DELETE application/json チームID (M365グループID) Office 365 Groups コネクタ HTTP 要求 V2 を送信 する (Preview) ではサポートされない メソッドのため注意 チャネルID 2023/08 現在 [HTTP 要求 を送信する]アクションは Power Automateで新規利用不可となりました
  27. チャネルを削除する 64 ◼ Teamsコネクタに、チャネルを削除するアクションは存在しない ◼ よって、[HTTP with Azure AD コネクタ]コネクタの[HTTP要求を呼び出し

    ます]アクションを利用し、Graph API による削除を行う ◼ https://learn.microsoft.com/ja-jp/graph/api/channel-delete?view=graph-rest-1.0&tabs=http https://graph.microsoft.com/v1.0/teams/{id}/ channels/{id} DELETE Content-type: application/json チームID (M365グループID) HTTP with Azure AD コネクタ > HTTP要求を呼び 出します チャネルID プレミアムコネクタです コネクタの使い方は下記参照 Graph API について
  28. チャットの種類 66 ▪ 1対1チャット ➢ 特定のユーザーと個別にチャット ▪ グループチャット ➢ 複数の特定ユーザーとチャット

    ▪ 会議チャット ➢ Teams 会議の参加者で共有できるチャット ▪ チャネルチャット ➢ チャネル上で、チームに所属するメンバーとチャット
  29. チャットの作成 68 ◼ 1対1またはグループ チャットを作成する ◼ チャットごとに最大 20 人のユーザーを処理可能 ◼

    チャットが作成されると、会話IDが返る ◼ 1対1チャットの場合、Teams上にチャットは表示されない このアクションで、 ゲストユーザーをチャットのメン バーに追加することはできません 複数人を設定する場合は、 " ; "(セミコロン)で区切る 末尾に " ; " を付与するとエラーとなる
  30. チャットの一覧表示 70 ◼ 最近のチャットの一覧を取得する ◼ 1対1チャット、グループチャット、会議チャットが取得できる ◼ 取得するチャットの種類を条件を絞ることができる ➢ すべてのチャット

    ➢ 定義済み ➢ 未定義 ➢ すべてのチャットの種類 ➢ グループ ➢ 会議 ➢ 1対1 2023/08/14 未定義を選択してもフィルターされない模様
  31. 71 "body": { "value": [ { "id "19:[email protected]", "cre":atedDateTime": "2023-02-09T13:28:00.823Z",

    "lastUpdatedDateTime": "2023-02-09T13:28:00.823Z" }, { "id": "19:meeting_YjhlNTg0ZjAtNmZkYi00ZmNjLWE5OGYtODY3Yjc5OWE3ZWJh@thread.v2", "topic": "気ままに勉強会 #22", "createdDateTime": "2022-07-01T21:22:21.536Z", "lastUpdatedDateTime": "2022-09-25T21:13:18.474Z" } ], "@odata.count": 2, "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats" } 出力 会話ID チャットの表示名 チャットの作成日時 様々な Teamsコネクタのアクション で利用する チャットの最終更新日時
  32. 74 "body": { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3A35784152e39848ed8f7e55077ee31b99%40thread.v2')/members", "@odata.count": 3, "value": [ {

    "@odata.type": "#microsoft.graph.aadUserConversationMember", "id": "MCMjMCMjNTUyNDQwZWUtODkxZC00ZjVhLWI3OGUtMTNkMGEzZmExZGQ0IyMxOTozNTc4NDE1MmUzOTg0OGVkOGY3ZTU1MDc3ZWUzMWI5OUB0aHJlYWQud", "roles": [ "owner" ], "displayName": "二宮 次郎", "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z", "userId": "6480daab-d9b5-4285-a9da-e2905e6aa2fc", "email": "[email protected]", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" }, { "@odata.type": "#microsoft.graph.aadUserConversationMember", "id":”GEzZmExZGQ0IyMxOTozNTc4NDE1MmUzOTg0OGVkOGY3ZTU1MDc3ZWUzMWI5OUB0aHJlYWQudjIjI2U4NjM1ZDhmLTVmNzAtNGQ1ZC1iOTBiLW==", "roles": [ "guest" ], "displayName": "user01", "visibleHistoryStartDateTime": "0001-01-01T00:00:00Z", "userId": "e8635d8f-5f70-4d5d-b90b-a9d85e11f183", "email": "[email protected]", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" } 出力 表示名 メールアドレス テナントID ロール 会話のメンバーとの会話履歴を、 過去のどの時点からメンバーと共 有するかを示すタイムスタンプ ユーザーID
  33. チームのタグについて 76 ◼ チーム内の一部属性ユーザーに対しメンションする際に利用する ◼ タグ付けの管理は ➢ Teams管理センター - Teamsの設定

    ー タグ付け ✓ タグを管理できるユーザー:チームの所有者/チームの所有者とメンバー/タグ付けを無効 ✓ チームの所有者は、タグを管理できるユーザーを変更できます:ON/OFF ✓ 推奨タグ(候補として表示されるタグ) ✓ カスタム タグ:ON/OFF(推奨タグ以外を追加できるか) ✓ Shifts アプリでタグを適用できます:ON/OFF チームで最大200個 最大200人に割り当て可能 同一チームで一人に25個まで Microsoftの規定値??
  34. Teams Shifts について 77 ◼ チームに所属しているメンバーを管理するスケジューラー(シフト管理) ✓ スケジュールはチーム管理者のみが管理可能 ✓ 任意のタイミングでシフトを公開可能

    ✓ 出勤 と 休憩時間で合計勤務時間を表示 ✓ 空き時間(不足している時間)を設定し、メンバーからの出勤希望を受け付け可能 ✓ タイムカード機能あり、休暇申請、交代申請、シフト変更申請が可能 ✓ 出退勤レポートを出力可能 ✓ シフトのグループをチャットやチャネルでタグとして利用可能 Shifts for Microsoft Teamsコネクタもあります https://learn.microsoft.com/ja- jp/connectors/Shifts/#approve-a-time-off- request
  35. 動的な値:ID メンバーの指定 80 ◼ ユーザーIDに指定するオブジェクトIDは、 「Office 365 Users」 コネクタで取得可能 「ユーザー

    プロフィールの取得」 や 「マイ プロフィールの取得」 複数指定する場合は";"(セミコロン)で区切る
  36. 83 "body": { "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('fc2ec21d-5c5e-4603-8acf-faace4d4dfbf')/tags", "@odata.count": 2, "value": [ {

    "id": "NTUyNDQwZWUtODkxZC00ZjVhLWI3OGUtMTNkMGEzZmExZGQ0IyNmYzJlYzIxZC01YzVlLTQ2MDMtOGFjZi1mYWFjZ", "teamId": "fc2ec21d-5c5e-4603-8acf-faace4d4dfbf", "displayName": "tag2", "memberCount": 1, "tagType": "standard" }, { "id": "NTUyNDQwZWUtODkxZC00ZjVhLWI3OGUtMTNkMGEzZmExZGQ0IyNmYzJlYzIxZC01YzVlLTQ2MDMtOGFjZi1mYWFjZT", "teamId": "fc2ec21d-5c5e-4603-8acf-faace4d4dfbf", "displayName": "tag3", "memberCount": 4, "tagType": "standard" } ] } 出力 タグID チームID 表示名 メンバー数 Standard :カスタムタグ Scheduled:シフトでのタグ
  37. 90 "body": { "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('fc2ec21d-5c5e-4603-8acf- faace4d4dfbf')/tags('NTUyNDQwZWUtODkxZC00ZjVhLWI3OGUtMTNkMGEzZmExZGQ0IyNmYzJlYzIxZC01YzVlLTQ2MDMtOGFjZi1mYWFjZTRkNG')/members", "@odata.count": 2, "value": [

    { "id": "MCMjMSMjNTUyNDQwZWUtODkxZC00ZjVhLWI3OGUtMTNkMGEzZmExZGQ0IyNmYzJlYzIxZC01YzVlLTQ2MDMtOGFjZizYtNDYyZC1hOGQ4LTE1ZDUwNWQ3NTJhZA==", "displayName": "一ノ瀬 一夫", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "userId": "bef8991a-5f76-462d-a8d8-15d505d752ad" }, { "id": "MCMjMSMjNTUyNDQwZWUtODkxZC00ZjVhLWI3OGUtMTNkMGEzZmExZGQ0IyNmYzJlYzIxZC01YzVlLTQ2MDMFiLWQ5YjUtNDI4NS1hOWRhLWUyOTA1ZTZhYTJmYw==", "displayName": "二宮 次郎", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "userId": "6480daab-d9b5-4285-a9da-e2905e6aa2fc" } ] } 出力 タグ メンバーID テナントID ユーザーの表示名 ユーザーID
  38. タグのメンションを取得 98 ◼ メッセージやアダプティブカードに挿入可能な、タグの @mention トー クンを取得する ◼ メッセージやアダプティブカードにトークンを使用する際、ユーザーに よる投稿であること

    ◼ トークンを取得したチームと異なるチームに、トークンを利用しメン ションすることは可能(エラーは発生しないがタグのメンバーは0)
  39. Teams 会議について 100 ◼ 種類 ✓ Teams 会議 ✓ Teams

    ウェビナー (参加登録フォーム、招待通知、参加者のオーディオとビデオは規定でOFF など) ✓ Teams ライブイベント (開催者,プロデューサー,発表者のロール、Public/Privateイベント) ◼ 会議の制限 ➢ チャット、オーディオ、ビデオを使用して対話できる招待者数は ➢ Microsoft 365 Business Basic、Business Standard、Business Premium、A1 :300人 ➢ Microsoft 365 E3/E5、A3/A5:1,000人 ➢ 会議の容量に達した場合、表示のみの参加者となる(本年度末まで最大20,000人)
  40. Teams 会議の作成 103 ➢ Tokyo Standard Time など ➢ 低

    ➢ 中 ➢ 高 ➢ 第1 ➢ 第2 ➢ 第3 ➢ 第4 ➢ 最後 英語で指定する 例:Monday,Wednesday,Saturday ➢ free ➢ tentative ➢ busy ➢ oof ➢ workingElsewhere ➢ unknown
  41. 107 投稿者 投稿先 ユニークなパラメータ ユーザー user Channel Team ChannelSubject Hosted

    Contents(*1) Group chat Group chat Hosted Contents(*1) フローボット flow bot Channel Team Channel Chat with Flow bot Recipient Channel IsAlert Group chat Group chat Power Virtual Agents Chat with bot Bot Recipient Label as notification If chat is active IF bot not installed 投稿者と投稿先の組み合わせ 複数人指定不可
  42. 108 Hosted Contents について Hiroさん [Tips] Power Automate から Teams

    に投稿するメッセージに画像を埋め込む – Qiita Power Automate から投稿する Adaptive Card に画像を表示する方法 (2023年版) - MoreBeerMorePower (hatenablog.com) ◼ Hosted Contents を指定することで、メッセージに画像を挿入できる コードビューに変更する <img src="../hostedContents/[temporaryId]/$value"> [ { "@microsoft.graph.temporaryId": "[temporaryId]", “contentBytes”: “/9j/4AAQSkZJRgABAQ....<base64 image>”“, "contentType": "image/jpg“ } ] 同一の値(数字)で設定する 一つのメッセージに複数のイメージを挿入する場合、 それぞれの[temporaryId]はユニークな値とする Base64化したイメージファイルの拡張子 (image/jpg,image/png ) Base64化した画像ファイル
  43. 109 Power Virtual Agents for Teams で プロアクティブなメッセージを受信 Power Virtual

    Agents for Teams でプロアクティブなメッセージを受信する – Qiita プロアクティブなメッセージで Teams のボットユーザーに通知する - Power Virtual Agents | Microsoft Learn ◼ プロアクティブなメッセージで質問し、入力された回答をトリガーフレーズとしてト ピックを実行するなど可能 チャットボットを選択 ボットとフローは同一チーム内かつ、 同じソリューションに配置 クラシックボットであること 受信者を指定 「経由の通知」の表示有無 複数人指定不可
  44. 112 "body": { "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('084ff44a-92db-4844-9063-8aeed0aec5d5')/channels('19%3AiEEyWC- gxk8GciL45EVkDE1K_WBaUf3XkjmqI4H9WVg1%40thread.tacv2')/messages", "@odata.count": 20, "@odata.nextLink": "https://japan-001.azure-apim.net/apim/teams/shared-teams-bc70055c-7080-4d37-88b1-00d483c6e8f3/beta/teams/084ff44a-92db-4844-

    9063-8aeed0aec5d5/channels/19:iEEyWC- [email protected]/messages?$skiptoken=%5b%7B%22token%22%3a%22%2bRID%3a~vpsQAJ9uAC3m4i0AAOCTDA%3d%3d%23RT%3a1%23TRC%3a20%2 3RTD%3aAyAER1ygxSHVHGAn2S99BTI6O2pGRnpYRC5oeWw5SGRqTTU2RldsRUYyTGBYQ2JWZzRZbGtucko1STpYV2gyQXVpc2ZiZS91YmR3MzwyNzo2ODM2OTEyNzUzAA%3d%3d%23ISV%3a2%23IEO%3a 65551%23QCF%3a8%23FPC%3aAgjSAQAAmCsAALkAAIBPMgAA0gEAAJgrAAAEABq7EoB6AACATzIAAAYAYooWgBiAhQAAgE8yAAACAOShhgAAgE8yAAAIALKYMgsAYAMAtwAAgE8yAAAcAH2gKIB7gIaAFo EGgAHACCCDjjqBB4BNgIiAVYC5AACATzIAABYAo5nqh8CAAoABwAQgDIERAEAIEoBfgA%3d%3d%22%2c%22range%22%3a%7B%22min%22%3a%2205C1E577438128%22%2c%22max%22%3a%2205C1E57 94B15B6%22%7D%7D%5d", "value": [ { "id": "1695821263344", "etag": "1695821633441", "messageType": "message", "createdDateTime": "2023-09-27T13:27:43.344Z", "lastModifiedDateTime": "2023-09-27T13:33:53.441Z", "lastEditedDateTime": "2023-09-27T13:28:35.278Z", "subject": "親メッセージ", "importance": "high", "locale": "en-us", "webUrl": "https://teams.microsoft.com/l/message/19%3AiEEyWC- gxk8GciL45EVkDE1K_WBaUf3XkjmqI4H9WVg1%40thread.tacv2/1695821263344?groupId=084ff44a-92db-4844-9063-8aeed0aec5d5&tenantId=552440ee-891d-4f5a-b78e- 13d0a3fa1dd4&createdTime=1695821263344&parentMessageId=1695821263344", 出力メッセージ 親メッセージ の配列 取得件数(最大20) 親メッセージの詳細
  45. 113 { "id": "1695821263344", "etag": "1695821633441", "messageType": "message", "createdDateTime": "2023-09-27T13:27:43.344Z",

    "lastModifiedDateTime": "2023-09-27T13:33:53.441Z", "lastEditedDateTime": "2023-09-27T13:28:35.278Z", "subject": "親メッセージ", "importance": "high", "locale": "en-us", "webUrl": "https://teams.microsoft.com/l/message/19%3AiEEyWC- gxk8GciL45EVkDE1K_WBaUf3XkjmqI4H9WVg1%40thread.tacv2/1695821263344?groupId=084ff44a-92db-4844-9063-8aeed0aec5d5&tenantId=552440ee-891d-4f5a-b78e- 13d0a3fa1dd4&createdTime=1695821263344&parentMessageId=1695821263344", "from": { "user": { "@odata.type": "#microsoft.graph.teamworkUserIdentity", "id": "da46df74-8329-4857-9caf-b5f9bcb15f69", "displayName": "管理者 1", "userIdentityType": "aadUser", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" } }, 出力メッセージ つづき タイトル メッセージID 重要度 投稿者情報
  46. 114 "body": { "contentType": "html", "content": "<p>過去のガンダムLTのスライド</p>¥n<p><at id=¥"0¥">一ノ瀬</at>&nbsp;<at id=¥"1¥">一夫</at>&nbsp;<at id=¥"2¥">二宮

    </at>&nbsp;<at id=¥"3¥">次郎</at></p>¥n<p>&nbsp;</p><attachment id=¥"bff73dda-3b28-41e1-aa1e-b9b33f29b600¥"></attachment><attachment id=¥"4072d7c8-3ac4- 4daa-be50-0d8a0217b833¥"></attachment>" }, "channelIdentity": { "teamId": "084ff44a-92db-4844-9063-8aeed0aec5d5", "channelId": "19:[email protected]" }, "attachments": [ { "id": "bff73dda-3b28-41e1-aa1e-b9b33f29b600", "contentType": "reference", "contentUrl": "https://20210401developer.sharepoint.com/teams/FromPowerAutomate/Shared Documents/General/ガンダムBotを1分で作 る.pptx", "name": "ガンダムBotを1分で作る.pptx" }, { "id": "4072d7c8-3ac4-4daa-be50-0d8a0217b833", "contentType": "reference", "contentUrl": "https://20210401developer.sharepoint.com/teams/FromPowerAutomate/Shared Documents/General/セリフを感情分析.pptx", "name": "セリフを感情分析.pptx" } ], 出力メッセージ つづき チームとチャネルのID 本文 添付ファイル
  47. 115 "mentions": [ { "id": 0, "mentionText": "一ノ瀬", "mentioned": {

    "application": null, "device": null, "conversation": null, "tag": null, "user": { "@odata.type": "#microsoft.graph.teamworkUserIdentity", "id": "bef8991a-5f76-462d-a8d8-15d505d752ad", "displayName": "一ノ瀬", "userIdentityType": "aadUser" } } }, { "id": 1, "mentionText": "一夫", } ], 出力メッセージ つづき メンション情報 ユーザー名に空白があると、別の要素となる
  48. 116 "reactions": [ { "reactionType": "like", "createdDateTime": "2023-09-27T13:33:43.469Z", "user": {

    "application": null, "device": null, "user": { "@odata.type": "#microsoft.graph.teamworkUserIdentity", "id": "da46df74-8329-4857-9caf-b5f9bcb15f69", "displayName": null, "userIdentityType": "aadUser" } } }, { "reactionType": "heart", "createdDateTime": "2023-09-27T13:33:53.458Z", "user": { } } } ] } 出力メッセージ つづき リアクション情報
  49. 118 メッセージの詳細を取得 ◼ メッセージの詳細情報を取得 ◼ 取得するメッセージの種類(グループチャット/チャネル)でパラメータが変化 ◼ チャネルから取得できる項目は前項「メッセージを取得する」とほぼ同じ グループチャットの場合 チャネルの場合

    取得対象が返信の場合、親メッセージIDを指定す る必要がある メッセージの存在するチャットと チャネルを指定 こちらでもチャネルのメッセージ詳細を取得可能 メッセージの種類:グループチャット Group chat:チャネルID を指定する
  50. 120 "body": { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#chats('19%3Ab359d43fe2e949cfbe0fd654734b00aa%40thread.v2')/messages/$entity", "id": "1695725913004", "replyToId": "1695725913004", "etag":

    "1695725913004", "messageType": "message", "createdDateTime": "2023-09-26T10:58:33.004Z", "lastModifiedDateTime": "2023-09-26T10:58:33.004Z", "lastEditedDateTime": null, "deletedDateTime": null, "subject": null, "summary": null, "chatId": "19:[email protected]", "importance": "normal", "locale": "en-us", "webUrl": null, "channelIdentity": null, "policyViolation": null, "eventDetail": null, 出力チャット 親メッセージID メッセージID チャットID
  51. 121 "from": { "device": null, "user": null, "application": { "@odata.type":

    "#microsoft.graph.teamworkApplicationIdentity", "id": "358f0194-6b0e-4dd3-af35-c24fe8a9ec87", "displayName": "Flow", "applicationIdentityType": "bot" } }, "body": { "contentType": "html", "content": "<p>今夜、行きましょう</p>", "plainTextContent": "今夜、行きましょう" }, "attachments": [], "mentions": [], "reactions": [], "messageLink": "https://teams.microsoft.com/l/message/19:[email protected]/1695725913004?context=%7B%22contextType%22:%22chat%22%7D", "threadType": "chat", "conversationId": "19:[email protected]" } 出力チャット つづき メッセージ本文
  52. 122 "body": { "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#teams('084ff44a-92db-4844-9063-8aeed0aec5d5')/channels('19%3AiEEyWC- gxk8GciL45EVkDE1K_WBaUf3XkjmqI4H9WVg1%40thread.tacv2')/messages/$entity", "id": "1695737588595", "replyToId": "1695737588595",

    "etag": "1695737588595", "messageType": "message", "createdDateTime": "2023-09-26T14:13:08.595Z", "lastModifiedDateTime": "2023-09-26T14:13:08.595Z", "lastEditedDateTime": null, "deletedDateTime": null, "subject": "", "summary": null, "chatId": null, "importance": "normal", "locale": "en-us", "webUrl": "https://teams.microsoft.com/l/message/19%3AiEEyWC- gxk8GciL45EVkDE1K_WBaUf3XkjmqI4H9WVg1%40thread.tacv2/1695737588595?groupId=084ff44a-92db-4844-9063-8aeed0aec5d5&tenantId=552440ee-891d-4f5a-b78e- 13d0a3fa1dd4&createdTime=1695737588595&parentMessageId=1695737588595", "policyViolation": null, "eventDetail": null, 出力チャネル 「メッセージを取得する」アクションとほぼ同じ項目
  53. 123 "from": { "application": null, "device": null, "user": { "@odata.type":

    "#microsoft.graph.teamworkUserIdentity", "id": "da46df74-8329-4857-9caf-b5f9bcb15f69", "displayName": "管理者 1", "userIdentityType": "aadUser", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" } }, "body": { "contentType": "html", "content": "<img src=¥"https://graph.microsoft.com/v1.0/teams/084ff44a-92db-4844-9063-8aeed0aec5d5/channels/19:iEEyWC- [email protected]/messages/1695737588595/hostedContents/aWQ9eF8wLWVqcC1kMS00ODY5M2NhOWFlZWJjMDY0NDQ1MDdkZmNiMWI5ZTEyYix0e XBlPTEsdXJsPWh0dHBzOi8vanAtcHJvZC5hc3luY2d3LnRlYW1zLm1pY3Jvc29mdC5jb20vdjEvb2JqZWN0cy8wLWVqcC1kMS00ODY5M2NhOWFlZWJjMDY0NDQ1MDdkZmNiMWI5ZTEyYi92aWV3cy9pbWd v/$value¥">", "plainTextContent": "" }, 出力チャネル つづき
  54. 124 "channelIdentity": { "teamId": "084ff44a-92db-4844-9063-8aeed0aec5d5", "channelId": "19:[email protected]" }, "attachments": [],

    "mentions": [], "reactions": [], "messageLink": "https://teams.microsoft.com/l/message/19%3AiEEyWC-gxk8GciL45EVkDE1K_WBaUf3XkjmqI4H9WVg1%40thread.tacv2/1695737588595?groupId=084ff44a- 92db-4844-9063-8aeed0aec5d5&tenantId=552440ee-891d-4f5a-b78e-13d0a3fa1dd4&createdTime=1695737588595&parentMessageId=1695737588595", "threadType": "channel", "teamId": "084ff44a-92db-4844-9063-8aeed0aec5d5", "channelId": "19:[email protected]" } 出力チャネル つづき
  55. 126 メッセージに応答 ◼ 指定したチャネルのスレッドにメッセージを送信する機能 ◼ 応答できるのはチャネルのみ(チャットは不可) ◼ 「チャネルに新しいメッセージが追加されたとき」トリガー等と組み合わせるのが主な 利用方法 Flow

    bot または User Channel のみ チャネル内スレッドの 親メッセージ ID 応答するスレッドが存在する チームとチャネルを指定 スレッドの親メッセージのIDであること ルート メッセージにのみ、返信できます (スレッドの返信に返信は不可)
  56. Power Apps Cards の手順 ②カードを作成する 1. Power Apps ポータルでCardsを作成 ①カード

    2. フローでCardsを送信 ③カードのインスタンス を作成する Power Apps(Preview) カードのインスタンスを作成する の Cards(動的なコンテンツ) https://learn.microsoft.com/ja-jp/power-apps/cards/send-a-card/send-card-with-flow 130
  57. 133 オプションの選択をフローボットと してユーザーに投稿する ② ◼ 返信時はコメントの入力が可能 "body": { "responseTime": "2023-09-29T12:32:25.7810368Z",

    "responder": { "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "objectId": "da46df74-8329-4857-9caf-b5f9bcb15f69", "userId": "da46df74-8329-4857-9caf-b5f9bcb15f69", "userType": "ActiveDirectory" }, "selectedOption": "いきます。", "comments": "おごりですね?!ゴチになります!" }
  58. 通知テキスト Flow bot のみ Power Virtual Agentsはどこに? 136 フィード通知を投稿する ◼

    指定したユーザーに向けて、特定のチーム、チャネル、メッセージ、およびチャットに 対し通知を送る ◼ 既存のチーム、チャネル、メッセージ、チャットへ、通知による誘導が主な使い道 メッセージIDを指定する場合は、 そのメッセージが存在するチャネルや チャットを指定する 複数人への通知は不可能 通知の種類:チャット 通知の種類:チャネル
  59. 138 チャネル タイミング (recurrence) Input Output チャネルに新しいメッセージが追加されたとき ポーリング 1分ごと チーム、チャネル

    メッセージの詳細情報 チャットに新しいメッセージが追加されたとき Webhook なし 会話ID、メッセージIDのみ 作成ボックスから(V2) プッシュトリガー (ApiConnection) アダプティブカード (設定すれば) アダプティブカードに入力情報値(設定すれば) 会話ID 選択されたメッセージに対して(V2) プッシュトリガー (ApiConnection) アダプティブカード (設定すれば) アダプティブカードに入力情報値(設定すれば) チームID、会話ID、メッセージID キーワードが言及された場合 Webhook キーワード チャネル または チャット チームID、会話ID、メッセージID チャネルのメッセージで自分がメンションされてい るとき ポーリング 1分ごと チーム、チャネル メッセージの詳細情報 自分が@mentionedである場合 Webhook チャネル または チャット チームID、会話ID、メッセージID 新しいチーム メンバーが追加されたとき ポーリング 15分ごと チーム 追加されたユーザーのID 新しいチーム メンバーを削除したとき ポーリング 15分ごと チーム 削除されたユーザーのID 誰かがアダプティブカードに応答した場合 プッシュトリガー (ApiConnection) Adaprivecards カードの種類 ID アダプティブカードの入力情報値 応答者の情報、チームID、会話ID、メッセージID トリガーの比較 ポーリング間隔はライセンスにより変化します
  60. 141 "body": { "@odata.type": "#microsoft.graph.chatMessage", "etag": "1697547461681", "messageType": "message", "createdDateTime":

    "2023-10-17T12:57:41.681Z", "lastModifiedDateTime": "2023-10-17T12:57:41.681Z", "subject": "タイトル", "importance": "normal", "locale": "en-us", "webUrl": "https://teams.microsoft.com/l/message/19%3AYnd2BOXO3BpzTWVhVCdq4iGsbDTrabhk0h9UJK9Do6g1%40thread.tacv2/1697547461681?groupId=70f14566-5085-4e97-abb5- 179ceeb94947&tenantId=552440ee-891d-4f5a-b78e-13d0a3fa1dd4&createdTime=1697547461681&parentMessageId=1697547461681", "id": "1697547461681", "from": { "user": { "@odata.type": "#microsoft.graph.teamworkUserIdentity", "id": "da46df74-8329-4857-9caf-b5f9bcb15f69", "displayName": "管理者 1", "userIdentityType": "aadUser", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" } }, "body": { "contentType": "html", "content": "<p>メッセージ</p>" }, "channelIdentity": { "teamId": "70f14566-5085-4e97-abb5-179ceeb94947", "channelId": "19:[email protected]" }, "attachments": [], "mentions": [], "reactions": [] } 出力 タイトル 本文 投稿者情報 添付ファイル メンション情報 リアクション情報 チームとチャネルのID メッセージID 取得可能な項目は 「メッセージを取得します」や 「メッセージの詳細を取得します」と同等
  61. 144 "body": { "value": [ { "subscriptionId": "357bc305-6e3e-4b2c-8327-3dcbdd899ad3", "changeType": "created",

    "clientState": "secretClientValue", "subscriptionExpirationDateTime": "2023-10-19T13:59:24.955246+00:00", "resource": "chats('19:[email protected]')/messages('1697720390327')", "resourceData": { "id": "1697720390327", "@odata.type": "#Microsoft.Graph.chatMessage", "@odata.id": "chats('19:[email protected]')/messages('1697720390327')" }, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "conversationId": "19:[email protected]", "messageId": "1697720390327", "linkToMessage": "https://teams.microsoft.com/l/message/19:[email protected]/1697720390327?tenantId=552440ee- 891d-4f5a-b78e-13d0a3fa1dd4&context=%7B%22contextType%22:%22chat%22%7D" } ] } 出力
  62. アダプティブカード編集画面が開くが、 Adaptive Cards Designer と比べ使いにくい ※Target versionは 1.3 147 作成ボックスから(V2)

    ◼ Teams の作成メッセージ ボックスからフローを開始できる ◼ アダプティブカードを設定することで、実行ユーザーからの入力を受け付け可能 ◼ Default 環境でのみ機能する(ソリューション内外は影響しない) ◼ 作成したフローは他のメンバーからも実行可能だが、権限については注意 Action.Submit パーツを配置しなくても、 実行時に自動的に配置される
  63. 150 "body": { "teamsFlowRunContext": { "Id": "f:f88fe935-1cf8-a347-fa51-80331b2fd722", "ChannelData": { "EventType":

    null, "InvalidateInvokeCache": null, "Team": null, "Tenant": { "Id": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" }, "Channel": null, "Notification": null, "OnBehalfOf": null }, "From": { "Id": "8:orgid:da46df74-8329-4857-9caf-b5f9bcb15f69", "Name": "管理者 1", "Role": null, "AadObjectId": "da46df74-8329-4857-9caf-b5f9bcb15f69", "Properties": null }, "Conversation": { "Id": "19:da46df74-8329-4857-9caf-b5f9bcb15f69_358f0194-6b0e-4dd3-af35-c24fe8a9ec87@unq.gbl.spaces", "Name": null, "IsGroup": null }, "Locale": "ja-JP", "CommandContext": "compose", "LocalTimezone": "Tokyo Standard Time" }, "cardOutputs": { "UserVal": “input1”, “PassVal”: “input2" } 出力 Adaprive Cards で入力された値 チャネル/チャットID
  64. 152 選択したメッセージに対して アダプティブカード編集画面が開くが、 Adaptive Cards Designer と比べ使いにくい ※Target versionは 1.3

    Action.Submit パーツを配置しなく ても、実行時に自動的に配置される ◼ Teams の投稿済みメッセージからフローを開始できる ◼ アダプティブカードを設定することで、実行ユーザーからの入力を受け付け可能 ◼ Default 環境でのみ機能する(ソリューション内外は影響しない) ◼ 作成したフローは他のメンバーからも実行可能だが、権限については注意
  65. “ "ChannelData": { "EventType": null, "InvalidateInvokeCache": null, "Team": null, "Tenant":

    { "Id": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" }, "Channel": null, "Notification": null, "OnBehalfOf": null }, "From": { "Id": "8:orgid:da46df74-8329-4857-9caf-b5f9bcb15f69", "Name": "管理者 1", "Role": null, "AadObjectId": "da46df74-8329-4857-9caf-b5f9bcb15f69", "Properties": null }, "Conversation": { "Id": "19:[email protected]", "Name": null, "IsGroup": null }, "Locale": "ja-JP", "CommandContext": "message", "LocalTimezone": "Tokyo Standard Time" }, "cardOutputs": { "UserVal": "ああ", "PassVal": "bbb" } } 154 "body": { "teamsFlowRunContext": { "MessagePayload": { "Id": "1697902720639", "From": { "Application": { "DisplayName": "Workflows", "Id": "358f0194-6b0e-4dd3-af35-c24fe8a9ec87" }, "Conversation": null, "Device": null, "User": null }, "Body": { "ContentType": "html", "Content": "<attachment id=¥"c4508ad7bb1b4646be3e8fa6949a7634¥"></attachment>", "PlainText": null }, "Subject": null, "LinkToMessage": "https://teams.microsoft.com/l/message/19:da46df74- 8329-4857-9caf-b5f9bcb15f69_358f0194-6b0e-4dd3-af35- [email protected]/1697902720639?context=%7B%22contextType%22:%22chat%22% 7D", "ReplyToId": null }, "Id": "f:abf8bbcc-fe12-50b0-4283-f55a6422a5e7", 出力 Adaprive Cards で入力された値 会話ID メッセージID テナントID
  66. 取得情報など 155 ▪ チームID ▪ チャネルID(チャットID) ▪ メッセージID ▪ アダプティブカードの応答

    triggerBody()?['teamsFlowRunContext']?['messagePayload']?['id'] triggerBody()?['teamsFlowRunContext']?['Conversation']?['id'] triggerBody()?['teamsFlowRunContext']?['ChannelData']?['Team']?['AadGroupId'] triggerBody()?[‘cardOutputs’]?[<アダプティブカードのinputsのId>']
  67. "body": { "value": [ { "subscriptionId": "d4294436-5669-4ae6-9638-9bc86aa1b05c", "changeType": "created", "clientState":

    "secretClientValue", "subscriptionExpirationDateTime": "2023-10-22T14:56:05.8142596+00:00", "resource": "chats('19:[email protected]')/messages('1697983012950')", "resourceData": { "id": "1697983012950", "@odata.type": "#Microsoft.Graph.chatMessage", "@odata.id": "chats('19:[email protected]')/messages('1697983012950')" }, "encryptedContent": null, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "conversationId": "19:[email protected]", "messageId": "1697983012950", "linkToMessage": "https://teams.microsoft.com/l/message/19:[email protected]/169798301 2950?tenantId=552440ee-891d-4f5a-b78e-13d0a3fa1dd4&context=%7B%22contextType%22:%22chat%22%7D" } ] } 158 "body": { "value": [ { "subscriptionId": "15181e6c-fb77-4002-9152-9e0ca226f6c1", "changeType": "created", "clientState": "secretClientValue", "subscriptionExpirationDateTime": "2023-10-22T14:20:07.0789412+00:00", "resource": "teams('b3c351fc-52b9-44e2-b555- 24e1d15949d0')/channels('19:[email protected]')/messag es('1696067592735')/replies('1697981145340')", "resourceData": { "id": "1697981145340", "@odata.type": "#Microsoft.Graph.chatMessage", "@odata.id": "teams('b3c351fc-52b9-44e2-b555- 24e1d15949d0')/channels('19:[email protected]')/messag es('1696067592735')/replies('1697981145340')" }, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "teamId": "b3c351fc-52b9-44e2-b555-24e1d15949d0", "channelId": "19:[email protected]", "messageId": "1697981145340", "replyToMessageId": "1696067592735", "linkToMessage": "https://teams.microsoft.com/l/message/19:5DVQkR1txbtUWemEPXQWysYWxPAKZYOG1ydkFkdC3Lk1@thread. tacv2/1697981145340?tenantId=552440ee-891d-4f5a-b78e-13d0a3fa1dd4&groupId=b3c351fc-52b9-44e2- b555-24e1d15949d0&parentMessageId=1696067592735" } ] } 出力 メッセージID 親メッセージID メッセージの種類:チャット メッセージの種類:チャネル メッセージID チャットID チームID チャネルID メッセージID
  68. "channelIdentity": { "teamId": "fc2ec21d-5c5e-4603-8acf-faace4d4dfbf", "channelId": "19:[email protected]" }, "attachments": [], "mentions":

    [ { "id": 0, "mentionText": "管理者 1", "mentioned": { "application": null, "device": null, "conversation": null, "tag": null, "user": { "@odata.type": "#microsoft.graph.teamworkUserIdentity", "id": "da46df74-8329-4857-9caf-b5f9bcb15f69", "displayName": "管理者 1", "userIdentityType": "aadUser" } } } ], "reactions": [] } 161 "body": { "@odata.type": "#microsoft.graph.chatMessage", "etag": "1698066929117", "messageType": "message", "createdDateTime": "2023-10-23T13:15:29.117Z", "lastModifiedDateTime": "2023-10-23T13:15:29.117Z", "subject": "タイトル", "importance": "normal", "locale": "en-us", "webUrl": "https://teams.microsoft.com/l/message/19%3Ac51e6cee3c9e4f8193fd00fe1d9409ba%40thread.tacv2/16 98066929117?groupId=fc2ec21d-5c5e-4603-8acf-faace4d4dfbf&tenantId=552440ee-891d-4f5a-b78e- 13d0a3fa1dd4&createdTime=1698066929117&parentMessageId=1698066929117", "id": "1698066929117", "from": { "user": { "@odata.type": "#microsoft.graph.teamworkUserIdentity", "id": "bef8991a-5f76-462d-a8d8-15d505d752ad", "displayName": "一ノ瀬 一夫", "userIdentityType": "aadUser", "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4" } }, "body": { "contentType": "html", "content": "<div><div>メッセージ本文</div>¥n¥n<div><at id=¥"0¥">管理者 1 </at></div>¥n</div>" }, 出力 取得可能な項目は 「メッセージを取得します」や 「メッセージの詳細を取得します」と同等
  69. 163 自分が @mentioned である場合 ◼ チャットやチャネルで @mentions に対して Webhook を作成する

    ◼ 親メッセージに対する返信でも動作する チャットを指定しないと トリガーされない チャネルの指定は必須 メッセージの種類:チャット メッセージの種類:チャネル 1対1チャットを指定する場合は、 カスタム値でチャットIDを入力する
  70. "body": { "value": [ { "subscriptionId": "61aec79e-4f59-4eee-b2cd-9c07bc6638f4", "changeType": "created", "clientState":

    "secretClientValue", "subscriptionExpirationDateTime": "2023-10-23T14:33:43.5559081+00:00", "resource": "chats('19:bef8991a-5f76-462d-a8d8-15d505d752ad_da46df74-8329-4857- [email protected]')/messages('1698068032719')", "resourceData": { "id": "1698068032719", "@odata.type": "#Microsoft.Graph.chatMessage", "@odata.id": "chats('19:bef8991a-5f76-462d-a8d8-15d505d752ad_da46df74-8329- [email protected]')/messages('1698068032719')" }, "encryptedContent": null, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "conversationId": "19:bef8991a-5f76-462d-a8d8-15d505d752ad_da46df74-8329-4857- [email protected]", "messageId": "1698068032719", "linkToMessage": "https://teams.microsoft.com/l/message/19:bef8991a-5f76-462d- a8d8-15d505d752ad_da46df74-8329-4857-9caf- [email protected]/1698068032719?tenantId=552440ee-891d-4f5a-b78e- 13d0a3fa1dd4&context=%7B%22contextType%22:%22chat%22%7D" } ] } 164 "body": { "value": [ { "subscriptionId": "bc937355-e4ce-4804-ba17-bc1ec3067b98", "changeType": "created", "clientState": "secretClientValue", "subscriptionExpirationDateTime": "2023-10-23T14:23:45.2856687+00:00", "resource": "teams('fc2ec21d-5c5e-4603-8acf- faace4d4dfbf')/channels('19:[email protected]')/messages('16980674 59210')/replies('1698067628392')", "resourceData": { "id": "1698067628392", "@odata.type": "#Microsoft.Graph.chatMessage", "@odata.id": "teams('fc2ec21d-5c5e-4603-8acf- faace4d4dfbf')/channels('19:[email protected]')/messages('16980674 59210')/replies('1698067628392')" }, "encryptedContent": null, "tenantId": "552440ee-891d-4f5a-b78e-13d0a3fa1dd4", "teamId": "fc2ec21d-5c5e-4603-8acf-faace4d4dfbf", "channelId": "19:[email protected]", "messageId": "1698067628392", "replyToMessageId": "1698067459210", "linkToMessage": "https://teams.microsoft.com/l/message/19:[email protected]/169806 7628392?tenantId=552440ee-891d-4f5a-b78e-13d0a3fa1dd4&groupId=fc2ec21d-5c5e-4603-8acf- faace4d4dfbf&parentMessageId=1698067459210" } ] } 出力 メッセージID 親メッセージID メッセージの種類:チャット メッセージの種類:チャネル メッセージID チャットID チームID チャネルID