Power AutomateのTeams Webhookを使ってみた

通常、API経由でTeamsに通知をするのはMicrosoft Graph経由もしくはPower Automateのプレミアムコネクタなどが必要になります。ただ、簡単な処理をスクリプトで実行したいという場合はどちらもハードルが高いです。

このようなケースでは、Power AutomateのTeams Webhook機能を使えば、比較的簡単にTeams通知を行うことができます。

本記事では、Power AutomateのTeams Webhook機能を利用して、PowerShellスクリプトからTeamsにメッセージを投稿する方法をご紹介します。

必要なツール

  • PowerShell
  • Azure CLI
  • Power Automateライセンス(プレミアムコネクタは利用しません)

前提知識

  • PowerShellの操作に慣れている方
  • Power Automateの操作に慣れている方

実行する手順

1のみPower Automateの画面での操作で、2以降はPowerShellでの操作になります。

1. Power Automateのフローを作成

今回は最小構成のため、利用するのは以下の2つのみです。

以下はTeams Webhook 要求を受信したときの詳細画面の設定です。「フローをトリガーできるユーザー」はセキュリティを考慮して「自分のテナントのすべてのユーザー」にします。また、HTTP URLはこの後の手順で利用するので控えておきます。(画像内の赤枠)

チャットやチャネルにカードを投稿するでは「アダプティブカード」入力欄には「添付ファイル アダプティブカード」を選択します。

2. アクセストークンを取得

手順1でトリガーの詳細設定で『このフローを呼び出せるユーザー』を組織内のユーザーに限定したため、次の手順で取得するアクセストークンが必要になります。

PowerShellを開き、まだサインインしていなければログインします。

az login

次にサインインしている環境が正しいかを確認します。

az account show

最後に認証用のアクセストークンを取得します。

$token = az account get-access-token --resource "https://service.flow.microsoft.com/" --query accessToken -o tsv

3. 送信するJSONファイルの準備

アダプティブカードの形式で送信します。 メモ帳など任意のエディタで、送信したいJSONファイルを作成します。

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.0",
        "body": [
          {
            "type": "TextBlock",
            "text": "こんにちは"
          }
        ]
      }
    }
  ]
}

4. Power Automateに送信

以下をPowerShellで実行すると、Power Automate経由でTeamsに投稿されます。

※手順2と同じPowerShellセッション内で実行してください

$url = "[手順1で取得したURL]"
$body = Get-Content -Raw -Encoding UTF8 "[手順3で作成したJSONファイルのパス]"

Invoke-WebRequest -Uri $url -Method Post `
  -Headers @{ Authorization = "Bearer $token" } `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

まとめ

今までTeamsに通知するのは制約が多くて難しかったのですが、ローカルからであればこの方法で実現できるのでとても便利な機能だと思います。

単体のスクリプトから実行したり、スキルにしてAIエージェントと合わせて使ったりするのもよいと思いました。

是非皆さんも試してみてください。

執筆担当者プロフィール
古川 貴浩

古川 貴浩(日本ビジネスシステムズ株式会社)

アプリケーション開発をしています。.NETやAI関連が好きです。

担当記事一覧