Power Automateでチームメンション・チャネルメンションを使う方法

チームメンション・チャネルメンションを送る方法は？

まずPower Automateのメンションの基本のおさらいしましょう。

Power Automateのメンションを付けるにはTeamsコネクタの「ユーザーの@mentionトークンを取得する」アクションを使うのが基本で一番簡単かと思います。

しかし、このアクションはチームメンション・チャネルメンション・タグメンションなどには対応していないため、チーム全員へメンションを付けるには不便です。（2021年12月現在）

以前書いた記事ではループ処理を使って強引にチームメンバー全員のメンショントークンを付ける方法を紹介しましたがこの方法では宛先メンバーの数が増えるとメンショントークンの文字列がずらーっと並んでしまい不格好でした。（下記の記事参照ください）

Microsoft 365 groupsコネクタの「HTTP要求を送信します」アクションを使います。

そこで、上記の方法以外でチームメンション・チャネルメンションを使用する方法を調べたところMicrosoft Graph APIを使ってメンション付きメッセージを送信する方法があるということがわかりました。

Graph APIとは、Microsoftが提供するAPIでTeamsなどのMicrosoftの様々なクラウドサービスにアクセスするための窓口的役割を担っています。Graph APIにHTTP Requestを送信すればTeamsにメンション付きメッセージを送信できるようです。

では「Power AutomateからHTTP Reqestを送信する方法はどのようなコネクタがあるのか？」ということなのですが、いくつかあるのですが今回はMicrosoft 365 groupsコネクタの「HTTP要求を送信します」アクションを使う方法を紹介します。このアクションはプレミアムコネクタではありませんので、Microsoft 365に付属するPower Automate for Microsoft 365のライセンスの範囲でも使用することができます。有料版Power Automateを契約していない環境でご利用されている方にオススメの方法です。

Graph APIの参考ページ

この記事で紹介する内容は下記のGraph APIのリファレンスを参考にしました。

事前準備

チームIDとチャネルIDを取得しましょう。

Graph APIからチームメンション・チャネルメンション付きメッセージを送信するには、チームIDとチャネルIDが必要です。チームIDはチームを識別するための固有のID・チャネルIDです。

チームIDとチャネルIDを取得する方法は？

TeamsアプリからチームID・チャネルIDを取得する方法

Graph API ExplorerからチームID・チャネルIDを取得する方法

Power Automate フロー作成手順

「HTTP要求を送信します」アクションのまとめ

チームメンションとチャネルメンションの違い

「HTTP要求を送信します」アクションのJSONのここが違います。

▲図の赤枠の部分が異なります。

                    "conversation": {
                        "id": "チームID",
                        "conversationIdentityType": "team"
                    }

                        "conversation": {
                            "id": "チャネルID",
                            "conversationIdentityType": "channel"
                        }

エラー「Neither Body nor adaptive card content contains marker for mention with Id ‘0’. Add ‘****’ to the body or an adaptive card.」

Neither Body nor adaptive card content contains marker for mention with Id ‘0’. Add ‘****’ to the body or an adaptive card.

▲Power Automateに上記のエラーがでた場合、JSONの中身に誤りがある可能性があります。下記を参考にしてください。

▲bodyの中のContentで使用するid・メンションテキストと、mentionsに設定しているid・mentionTextは揃えてください（上図）。逆にいうと、ここが揃えてあればチーム名とは異なるメンションテキストでチームメンションできます。例えば私はtejilaboというチームに所属していますが、そのチームに「チームメンバー各位」というメンションテキストでチームメンションすることができます。

エンドポイントURI

URI
https：//graph.microsoft.com/beta/teams/{チームID}/channels/{チャネルID}/ messages

▲チームメンションもチャネルメンションも、どちらを使用する場合もGraph APIのエンドポイントは同じです。

メッセージ本文に渡すHTMLを簡単に書く方法は？

Graph APIを使用する場合、メッセージ本文はHTMLで書かないといけません。（Mrakdownも使えるかもしれませんが使い方わかりませんでした）HTMLタグを使って自分で記述しても良いのですが面倒です。楽をする方法として「オンラインHTMLエディタ」という無料サービスを利用してHTMLを生成する方法を紹介します。

タグメンションを付ける方法は？

Power Automateからタグメンションを付けてメッセージを送信する方法はわかりませんでした。わかれば記事を書こうと思います。

Microsoft 365 グループに設定した役職などの属性を使ってメンションを付ける方法は下記の記事が参考になるかもしれません。

まとめ

Power Automate学習教材

Microsoft 365/ Power Automate / Power Platform / Google Apps Script…