普段利用しているTeamsのリアクション、「いいね」などは、投稿ごとに誰がいつリアクションしたのかなどの情報が全て取得できるようになっています。リアクションは投稿内容について「承認の代わり」にしたり、重要な投稿を「誰がまだ未読か」などデータとして取得・集計することで色々と活用方法が広がります。今回はこのTeamsのリアクション情報をPower Automateで取得する方法を紹介します。
Teamsへの投稿
Teamsに投稿されたメッセージリアクションの集計はPower Automateにログインするアカウントでアクセスできる全てのチーム、チャネル、投稿に対して可能です。まずはリアクションを集計するTeamsの投稿を行います。集計しやすいように件名もきちんと入れておきましょう。件名が無い場合、どの投稿へのリアクションなのかが後々判別しにくくなってしまいます。今回はこんなメッセージ2つを投稿して、それぞれリアクションを付けています。
Power Automateでフローの作成
まずは、Power Automateで開発するフローの大まかな流れです。Power Automateではチームとチャネルまで決定するれば、該当する投稿メッセージすべてについてリアクションの情報が取得可能です。
インスタントフローを作成します。まずは、リアクション一覧を格納するための変数をアレイ型で設定しておきます。
アクション一覧から「Microsoft Teams」-「メッセージを取得します」を選択します。
ここまでを実行すると、実行結果としてTeamsからメッセージとその他情報がjson形式で参照可能となります。
今回必要な部分としてはこの部分となります。
{
"reactionType": "like",
"createdDateTime": "2022-06-14T05:54:57.348Z",
"user": {
"application": null,
"device": null,
"user": {
"id": "4fd4c81b-5013-4ec3-9b62-a41dd870e332",
"displayName": null,
"userIdentityType": "aadUser"
}
}
},
{
"reactionType": "heart",
"createdDateTime": "2022-06-14T05:54:05.841Z",
"user": {
"application": null,
"device": null,
"user": {
"id": "67a57729-4fcf-4669-a1ea-e6b264121469",
"displayName": null,
"userIdentityType": "aadUser"
}
}
}
アクション一覧から「Microsoft Teams」-「メッセージ詳細を取得します」を選択します。「メッセージ」に「メッセージを取得する」-「メッセージID」を選択すると自動的にApply to Each が配置されます。全てのメッセージ対して実行することになります。
次に「データ操作」-「選択」アクションを追加します。これは、メッセージ詳細から取得したjsonの情報から必要な項目を選択するために利用します。
「開始」の項目には、“outputs('メッセージ詳細を取得する')?['body']?['reactions']” と入力します。これでリアクションの情報部分を抽出します。
「マップ」の「キーの入力」には 1つ目として “reactionType” 「値の入力」には式として “item()?['reactionType']” と入力します。2つ目は “createdDateTime” 「値の入力」には式として “item()?[createdDateTime]” 3つ目は “userId” 「値の入力」には式として “item()?['user']?['user']?['id']” と入力します。リアクションの種類と、リアクションの時間、リアクションをしたユーザーIDを抽出します。ユーザー名はここでは取得できないので、後程ユーザーIDを元に取得します。
1つの投稿メッセージに対して、複数のメンバーがリアクションできますので、全てのリアクション情報を取得するためにApply to eachを配置します。「コントロール」から「Apply to each」を追加します。分かりやすいように“リアクション一覧”に名前を変更します。「以前の手順から出力を選択」には「選択」-「出力」を選択しておきます。
「配列変数に追加」アクションを追加します。「名前」には最初に定義した“Reaction”を選択します。「値」には以下のjsonを入力します。reactionTime はUTC時間となっていますので日本時間へタイムゾーンを変更します。
{
"subject": "@{items('Apply_to_each')?['subject']}",
"userId": "@{items('リアクション一覧')?['userId']}",
"reactionType": "@{items('リアクション一覧')?['reactionType']}",
"reactionTime": "@{convertTimeZone(items('リアクション一覧')?['createdDateTime'], 'UTC', 'Tokyo Standard Time', 'yyyy/MM/dd HH:mm:ss')}"
}
「CVSテーブルの作成」アクションを追加します。「開始」にはリアクション情報が詰まった変数“Reactions”を指定します。
最後に「ファイルの作成」アクションを追加します。OneDrive for Businessに保存されるので、保存先のフォルダとファイル名を指定します。「ファイルコンテンツ」としては「CSVテーブルの作成」から「出力」をそのまま選んでしまうと文字化けしてしまうので、式として
concat(decodeUriComponent('%EF%BB%BF'), body('CSV_テーブルの作成'))
と入力します。
テスト実行
一旦ここまでの内容で保存してテスト実行してみましょう。リアクション情報がcsvで出力されました。いいね（like）が2つに、ステキ（hart）が１つ、笑い（laugh）が1つという結果となりました。実際にはかなりの情報量になるので、ピボットテーブルなどで集計するとよいでしょう。
ユーザー名の取得
このままですと、誰がリアクションしたのかが分かりませんのでユーザー名を取得できるように機能を追加します。「配列変数に追加」の上に「ユーザープロフィールの取得（V2）」アクションを追加します。「ユーザー（UPN）」には “items('リアクション一覧')?['userId']” を入力します。
「配列変数に追加」アクションの「値」も少し修正して
{
"subject": "@{items('Apply_to_each')?['subject']}",
"userName": "@{outputs('ユーザー_プロフィールの取得_(V2)')?['body/displayName']}",
"reactionType": "@{items('リアクション一覧')?['reactionType']}",
"reactionTime": "@{convertTimeZone(items('リアクション一覧')?['createdDateTime'], 'UTC', 'Tokyo Standard Time', 'yyyy/MM/dd HH:mm:ss')}"
}
とします。
これで、ユーザー名が取得できます。
テスト実行2
テストしてみると、先ほどとは変わってユーザー名がきちんと取得できています。
フローの全体はこちらになります。
以上が、Power AutomateによるTeamsのリアクションのカウント方法です。Teamsからでは見られないいくつかの情報もPower Automateを通すことで細かく取得できることが分かります。特定の日付以降のメッセージだけに絞って集計してみたり、全メンバー必読のメッセージについて、未読のメンバーに通知を出してみたりと利用法方は色々考えられます。ここまででも十分活用はできるのですが、残念ながらPower Automateからだと現時点では、アクセス権のあるTeamsのチームとチャネルを指定した上でメッセージに対してのリアクション情報の取得に限定されています。そこで次回は、PowerShellを使って、Teamsの組織内の（プライベートも含め）全てのチーム、チャネルの全てのメッセージのリアクション情報の取得方法を紹介する予定です。
