はじめに
Microsoft Teams(以下、Teams)のプライベートチャネルで、次のような定期リマインドを自動化したい場面がありました。
- 毎週決まった日時に投稿する
- プライベートチャネル内のタグをメンションする
- 新しいスレッドを毎回作らず、既存スレッドへ返信する
- URLをそのまま表示せず、ファイル名などの表示名付きリンクにする
Power Automateには、Teamsのタグメンショントークンを取得するアクションや、チャネル内のメッセージに返信するアクションがあります。しかし、プライベートチャネルでは標準アクションだけでは実現できませんでした。また、Microsoft Graphで新規投稿する例は見つかりますが、既存スレッドへの返信まで扱った例は少なかったため、本記事にまとめます。
対象読者は、Teamsを利用していて、Power Automateの基本操作(フローの作成、テスト実行、実行履歴の確認)を一通り行ったことがある方です。
全体の流れ
- プライベートチャネル専用のタグを作成する
- タグを使ったテスト投稿を行い、メッセージIDを確認する
- タグID取得用フローを実行し、タグIDを確認する
- 定期投稿用フローで、Microsoft Graph HTTP要求により既存スレッドへ返信する
完成イメージ
毎週、指定したプライベートチャネルの既存スレッドに、次のようなメッセージを返信として投稿します。
@運用メンバー(プライベートチャネル)
定例リマインド(資料更新のお願い)
次回の定例会に向けて、ご都合のつくタイミングでご確認・更新をお願いいたします。■更新対象
・計画資料:定例資料A
・状況管理:定例資料B.xlsx■更新いただきたい事項
・状況のアップデート
・見込みのアップデート
「定例資料A」などの表示名には、SharePoint上のファイルまたはフォルダへのリンクを設定します。
使用する機能と作成するフロー
使用する主な機能は次のとおりです。
- スケジュール済みクラウドフロー(Recurrenceトリガー)
- Teamsコネクタの「メッセージ詳細を取得する」アクション
- Teamsコネクタの「Microsoft Graph HTTP要求を送信する」アクション
作成するフローは次の2つです。
| フロー | 用途 | 実行頻度 |
|---|---|---|
| タグID取得用フロー | タグIDを確認する | 一度だけ |
| 定期投稿用フロー | 既存スレッドへ返信する | 定期 |
前提条件
- 投稿先のプライベートチャネルのメンバーである
- プライベートチャネルでタグを作成できる
- Power AutomateでTeamsコネクタを利用できる
- 「Microsoft Graph HTTP要求を送信する」アクションを利用できる
- 返信先となる親メッセージ(スレッドの先頭の投稿)を作成済みである
補足事項は次のとおりです。
- 投稿は、フローで使用するTeamsコネクションのユーザー名義で行われます
- 利用可否は、組織のポリシーや付与されている権限によって異なります
- 作成したフローの影響範囲は、通知を受け取るタグのメンバーです
- 組織のPower PlatformポリシーやDLPポリシーにより、利用可能なアクションが制限される場合があります
1. 標準アクションで試した結果
最初は、次の標準アクションで実装しました。
- 「チーム タグの @mention トークンを取得する」
- 「チャネル内のメッセージで応答する」
通常チャネルでは、対象のタグを選択すると、タグのメンバーが正しく表示されました。しかし、プライベートチャネルでは次の現象が発生しました。以下は筆者の環境で確認した現象です。
| 現象 | 対処 |
|---|---|
| Power Automateのタグ一覧に、プライベートチャネルのタグが表示されない | 手動投稿したメッセージの詳細からタグIDを取得し、Graph HTTP要求の本文に設定する(5〜6章、8章) |
| チーム単位で作成したタグを使うと、投稿はできるが、タグのメンバーが0人と表示され、通知もされない | 「チャネル タグの管理」で専用タグを作成し、そのタグIDを使う(2章) |
そこで、チーム単位のタグではなく、プライベートチャネル専用のタグを作成し、Microsoft Graph経由でメンションする方法に切り替えました。
2. プライベートチャネル専用のタグを作成する
Teamsで対象のプライベートチャネルを開き、チャネル名の右側にある「…」から、次のメニューを選択します。
チャネル タグの管理
「タグを作成」から、プライベートチャネル用のタグを作成します。本記事では、タグ名を次のように設定します。
運用メンバー(プライベートチャネル)
タグには、通知対象とするプライベートチャネルのメンバーを登録します。
3. テスト投稿を行う
作成したタグを使って、実際に使用する既存スレッドへの返信として、手動でテスト投稿します。
@運用メンバー(プライベートチャネル)
タグID取得用のテスト投稿です。
タグ名が通常の文字列ではなく、Teams上でメンションとして表示されていることを確認します。既存スレッドへの返信として投稿しておくと、親メッセージIDも同時に確認できます。
4. テスト投稿のメッセージIDを確認する
テスト投稿の「…」から「リンクをコピー」を選択します。返信メッセージのリンクには、おおむね次の情報が含まれます(見やすさのため改行しています。実際は1行です)。
https://teams.microsoft.com/l/message/{channel-id}/{reply-message-id}
?groupId={team-id}
&tenantId={tenant-id}
&createdTime={created-time}
&parentMessageId={parent-message-id}
確認する値は次のとおりです。
| 値 | リンク内の位置 |
|---|---|
| チームID | groupId |
| チャネルID |
/message/ の直後 |
| 返信メッセージID | チャネルIDの直後の数字 |
| 親メッセージID | parentMessageId |
本記事のサンプル値は、公開用の架空値です。
チームID:11111111-2222-3333-4444-555555555555
チャネルID:19:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx@thread.tacv2
返信メッセージID:1700000000001
親メッセージID:1700000000000
リンクの形式はTeamsの仕様変更で変わる可能性があります。次章以降のフロー出力でも同じ値を確認できるため、合っているかを照合してください。実際のIDは外部へ公開しないようにします。
5. タグID取得用フローを作成する
Power Automateで「インスタントクラウドフロー」を作成し、トリガーに「フローを手動でトリガーする」を使用します。続いて、Teamsの「メッセージ詳細を取得する」アクションを追加し、前章で確認したIDを次のように指定します。
| 項目 | 指定する値 |
|---|---|
| メッセージ | 返信メッセージID(例:1700000000001) |
| メッセージの種類 | チャネル |
| チーム | チームID |
| チャネル | チャネルID |
| 親メッセージ ID | 親メッセージID(例:1700000000000) |
既存スレッドへの返信を取得する場合は、「メッセージ」に返信メッセージID、「親メッセージ ID」に親メッセージIDを指定します。設定後、フローを保存して手動でテストします。
6. 実行結果からタグIDを確認する
フローの実行履歴を開き、「メッセージ詳細を取得する」の出力を確認します。必要に応じて「未加工出力の表示」を開き、ブラウザの検索機能で "tag" を検索します。出力には、次のような情報が含まれます。
{
"mentions": [
{
"id": 0,
"mentionText": "運用メンバー(プライベートチャネル)",
"mentioned": {
"tag": {
"@odata.type": "#microsoft.graph.teamworkTagIdentity",
"id": "ここに実際のタグIDが表示される",
"displayName": "運用メンバー(プライベートチャネル)"
}
}
}
]
}
控える値は mentions の中の mentioned.tag にある id と displayName です。同じ出力の channelIdentity から、チームIDとチャネルIDも確認できます。
{
"channelIdentity": {
"teamId": "11111111-2222-3333-4444-555555555555",
"channelId": "19:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx@thread.tacv2"
}
}
7. 定期投稿用フローを作成する
本番用の「スケジュール済みクラウドフロー」を作成し、トリガーに「Recurrence」を使用します。
たとえば、毎週金曜の会議に向けて、水曜17時に事前通知し、金曜9時に直前通知する場合は、フローを2本に分けます。1つのフローに設定できるトリガーは1つで、1つのRecurrenceでは、曜日ごとに異なる時刻を指定できないためです。
事前通知用の設定は次のとおりです。
頻度:週
間隔:1
曜日:水曜日
時刻:17:00
タイムゾーン:(UTC+09:00) 大阪、札幌、東京
直前通知用は、曜日を金曜日、時刻を09:00に変更します。投稿先、タグID、親メッセージIDは共通のため、1本目の動作確認後に「名前を付けて保存」で複製し、Recurrenceと本文だけ変更すると管理しやすくなります。
8. Microsoft Graph HTTP要求を追加する
Recurrenceの後ろに、Teamsの「Microsoft Graph HTTP要求を送信する」アクションを追加します。
URI
既存の親メッセージへの返信にするため、親メッセージIDを含めて /replies にPOSTします。
https://graph.microsoft.com/v1.0/teams/{team-id}/channels/{channel-id}/messages/{parent-message-id}/replies
サンプル値を当てはめた例は次のとおりです。
https://graph.microsoft.com/v1.0/teams/11111111-2222-3333-4444-555555555555/channels/19:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx@thread.tacv2/messages/1700000000000/replies
新規投稿と既存スレッドへの返信では、URIが異なります。指定するのは返信メッセージ自身のIDではなく、親メッセージIDです。/replies を付けずに /messages へPOSTすると、新しいスレッドとして投稿されます。
新規投稿:
POST /teams/{team-id}/channels/{channel-id}/messages
既存スレッドへの返信:
POST /teams/{team-id}/channels/{channel-id}/messages/{parent-message-id}/replies
メソッド
POST
コンテンツタイプ(詳細パラメーター)
application/json
本文
{
"body": {
"contentType": "html",
"content": "<at id=\"0\">運用メンバー(プライベートチャネル)</at><br><b>定例リマインド(資料更新のお願い)</b><br>次回の定例会に向けて、ご都合のつくタイミングでご確認・更新をお願いいたします。<br><br><b>■更新対象</b><br>・計画資料:<a href=\"https://example.sharepoint.com/document-a\">定例資料A</a><br>・状況管理:<a href=\"https://example.sharepoint.com/document-b.xlsx\">定例資料B.xlsx</a><br><br><b>■更新いただきたい事項</b><br>・状況のアップデート<br>・見込みのアップデート"
},
"mentions": [
{
"id": 0,
"mentionText": "運用メンバー(プライベートチャネル)",
"mentioned": {
"tag": {
"@odata.type": "#microsoft.graph.teamworkTagIdentity",
"id": "取得したタグID",
"displayName": "運用メンバー(プライベートチャネル)"
}
}
}
]
}
リンクは、URLをそのまま書かずに a タグで表示名を付けています。JSON文字列内では、href のダブルクォーテーションを \" とエスケープする必要があります。なお、SharePointのファイルへのリンクには、Teams上でプレビューが表示される場合があります。
9. メンションが機能しない場合の確認項目
メンションを成立させるには、本文中の <at> 要素に加えて、mentions にも対象を定義する必要があります。次の点を確認します。
-
<at id="0">のIDとmentions[].idが一致している -
<at>内の文字列とmentionTextが一致している -
mentionTextとタグのdisplayNameをそろえておくと確実です - プライベートチャネル用タグのIDを使用している
- チーム単位で作成した別のタグIDが混在していない
また、「メッセージ詳細を取得する」で404(NotFound)になる場合は、対象のメッセージが削除されていないか、返信メッセージIDと親メッセージIDを取り違えていないかを確認します。
10. 手動テストを行う
本番のスケジュールを待たず、Power Automateの「テスト」から手動実行します。本番通知との誤認を避けるため、テスト時は本文の先頭に次の一文を追加します。
<b>テスト投稿です。対応は不要です。</b><br>
次の3点を確認します。
- 指定した既存スレッドへの返信になっている
- タグのメンバー数が0人になっておらず、タグ名がメンションとして表示されている
- 対象者に通知されている
参考情報
プライベートチャネルでのタグメンションの基本的な考え方は、次の記事を参考にしました。
Microsoft Graphのチャネルメッセージ返信APIについては、Microsoft Learnを参照してください。URIと必要な権限はMicrosoft Learnの記載に、mentions でのタグの指定方法は筆者の環境での確認に基づきます。
まとめ
Power AutomateからTeamsのプライベートチャネルへタグメンション付きで投稿する場合、標準のタグ取得アクションでは、プライベートチャネル用のタグを選択できないことがあります。ポイントは次の4点です。
- 「チャネル タグの管理」から、プライベートチャネル専用のタグを作る
- タグを使った投稿のメッセージ詳細から、タグIDを取得する
-
mentionsを含むJSONを、Microsoft Graph HTTP要求で送信する -
/messages/{parent-message-id}/repliesを使い、既存スレッドへの返信として投稿する
これに、Recurrenceトリガーと a タグによるリンク表示を組み合わせることで、定期的な業務リマインドを、既存スレッドへ読みやすい形で集約できます。
