0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Power Automate】Teamsのプライベートチャネルの既存スレッドへ、タグメンション付きで定期返信する

0
Last updated at Posted at 2026-11-17

はじめに

Microsoft Teams(以下、Teams)のプライベートチャネルで、次のような定期リマインドを自動化したい場面がありました。

  • 毎週決まった日時に投稿する
  • プライベートチャネル内のタグをメンションする
  • 新しいスレッドを毎回作らず、既存スレッドへ返信する
  • URLをそのまま表示せず、ファイル名などの表示名付きリンクにする

Power Automateには、Teamsのタグメンショントークンを取得するアクションや、チャネル内のメッセージに返信するアクションがあります。しかし、プライベートチャネルでは標準アクションだけでは実現できませんでした。また、Microsoft Graphで新規投稿する例は見つかりますが、既存スレッドへの返信まで扱った例は少なかったため、本記事にまとめます。

対象読者は、Teamsを利用していて、Power Automateの基本操作(フローの作成、テスト実行、実行履歴の確認)を一通り行ったことがある方です。

全体の流れ

  1. プライベートチャネル専用のタグを作成する
  2. タグを使ったテスト投稿を行い、メッセージIDを確認する
  3. タグID取得用フローを実行し、タグIDを確認する
  4. 定期投稿用フローで、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. 標準アクションで試した結果

最初は、次の標準アクションで実装しました。

  1. 「チーム タグの @mention トークンを取得する」
  2. 「チャネル内のメッセージで応答する」

通常チャネルでは、対象のタグを選択すると、タグのメンバーが正しく表示されました。しかし、プライベートチャネルでは次の現象が発生しました。以下は筆者の環境で確認した現象です。

現象 対処
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上でプレビューが表示される場合があります。

スクリーンショットGraphHTTP.png

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点です。

  1. 「チャネル タグの管理」から、プライベートチャネル専用のタグを作る
  2. タグを使った投稿のメッセージ詳細から、タグIDを取得する
  3. mentions を含むJSONを、Microsoft Graph HTTP要求で送信する
  4. /messages/{parent-message-id}/replies を使い、既存スレッドへの返信として投稿する

これに、Recurrenceトリガーと a タグによるリンク表示を組み合わせることで、定期的な業務リマインドを、既存スレッドへ読みやすい形で集約できます。

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?