Microsoft Teamsウェブトリガー
- 最終更新日2026/01/13
Microsoft Teamsウェブトリガー
Microsoft Teamsウェブトリガーを使用することで、Microsoft Teamsのチャットやチャネルで発生するイベントに基づいてタスクを自動化できます。 ウェブトリガーは、Microsoft Teams 内で発生する特定のイベントを監視します。 イベントが発生すると、トリガーは設定されたアクションを開始します。
概要
Microsoft Teams のウェブトリガーを使用すると、Microsoft Teams 内で発生するダイレクトチャットメッセージ、グループチャットメッセージ、チャネルのメンバーシップ変更などのイベントに基づいてトリガーを作成できます。 Microsoft Teams でイベントが発生するとすぐにワークフローをトリガーするためにトリガーを使用でき、重要なコミュニケーションの手動監視と応答時間を短縮できます。 Microsoft Teams のウェブトリガーで利用可能なオプションを活用することで、チケットの割り当て、チャットメッセージからの情報抽出、関係者への通知メールスレッドの開始などの事例に対応したトリガーベースの自動化を構築できます。
Microsoft Teams アプリケーションでイベントが発生してから、そのイベントに基づいて自動化を開始するトリガーまでの遅延は30秒未満です。 セッションへのイベント配信が失敗した場合、トリガーは自動的にイベントの取得を再試行します。
Microsoft Teams のウェブトリガーには、メッセージをフィルタリングするためにキーワードを使用するオプションがあります。 フィルター オプションを使用すると、特定のキーワードに基づいて自動化をトリガーする必要がある事例において、トリガーの設定が可能です。 このオプションは、指定されたキーワードを含むメッセージに対するイベントの応答を制限します。
トリガーは、Microsoft サーバーからのイベント応答ペイロード情報を構造化された JSON 形式でキャプチャします。 このペイロードには、データを検証するための認証情報が含まれています。 監査ログ ページでレスポンス ペイロードをキーとバリューのペアとして表示できます。 このキーと値のペア情報を、セッション内の後続のアクションの入力として使用できます。
認証
Microsoft Teams のウェブトリガーは、OAuthを使用して、Microsoft 365への接続を認証します。 Microsoft TeamsのためにMicrosoft Entraに適用されるパラメータを使用してOAuth接続を設定します。 OAuth 接続の設定について詳しくは、OAuth 接続を作成するを参照してください。
Microsoft Teams ウェブトリガーは、Microsoft Azure証明書を使用して Microsoft アカウントサブスクリプションを認証し、Microsoft サーバーからの受信データを復号化します。 Microsoft Azure ポータルにログインし、証明書を作成します。 Microsoft Azure ポータルでの証明書作成に関する詳細は、Microsoft Learn ポータルの Certificate creation methods を参照してください。 証明書の管理の詳細については、Managing encryption keysを参照してください。
Credential Vault に作成した証明書を追加していることを確認します。 Credential Vault に証明書データを追加するには、次の手順を実行してください:
- 証明書ファイルを任意のテキストエディタで開きます。
- 証明書ファイルの全内容をコピーします。
- Control Room に管理者としてログインします。
- に移動し、資格情報を作成 をクリックします。
- 資格情報に適切な資格情報名と説明を入力してください。
- 属性 セクションの 属性名 に適切な名前を入力してください。
- 標準を選択し、属性の入力セクションの値フィールドに証明書の内容を貼り付けてください。
- 資格情報を作成をクリックして、Credential Vaultに証明書データを保存します。
サポートされているイベント
次のイベントは、個人チャットとチームチャットのトリガー設定の両方でサポートされています。
| イベント | 内容 |
|---|---|
| チャットメッセージが追加された場合 | 新しいメッセージを受信した場合。 |
| チャットメッセージが更新された場合 | 既存のチャットメッセージが編集されたとき。 |
| チャットメッセージが削除された場合 | 既存のチャットメッセージが削除されたとき。 |
チームメンバーシップトリガー設定でサポートされているイベントは次のとおりです：
| イベント | 内容 |
|---|---|
| 新しいチームメンバーが加わった場合 | 選択したチームに新しいメンバーを追加する際、チームオーナーが行います。 |
| チームメンバーが更新された場合 | チームオーナーが既存のチームメンバーの詳細を編集する時。 |
| チームメンバーが解任された場合 | チームオーナーが選択したチームからチームメンバーを削除する時。 |
前提条件
次の前提条件が満たされていることを確認してください。
- Bot Creator または 市民開発者 のライセンス。
- イベント トリガー および マイ Bot を表示 権限。
- チェックイン および チェックアウト 権限が自動化が存在するフォルダーに必要です。
- アカウントのためのアクティブな OAuth 接続Microsoft 365。
- Microsoft Azure 証明書。
設定
Microsoft Teams のWebトリガーで利用可能な設定は次のとおりです。
- Control Room OAuth 接続
- ピック オプションを使用し、OAuth 接続を選択 モーダルの指示に従って、OAuth 接続を選択してください。 OAuthは、Control RoomとMicrosoft 365アカウント間の接続を認証します。
- チャット
- このオプションを使用して、個別のチャットに基づいてトリガーを設定します。 チャット名は、チャット受信者の表示名ではなく、チャット受信者のメール ID に基づいて機能します。
- イベントを聞く: トリガーがリッスンする必要があるイベントタイプを指定してください。
- チャット名： チャット名を入力してください。 チャット名を取得する ボタンを使用して、チャット モーダルを使用してチャットを選択することもできます。
- フィルター: チェックボックスを有効にし、メッセージをフィルタリングするためのキーワードを入力してください。
- チーム＆チャンネル
-
チームチャット： チーム チャット オプションを使用して、Teams のチャネルに投稿されたメッセージをトリガーとして設定します。 このオプションで利用できる設定は次のとおりです。
- 1つまたは複数のイベントを選択： トリガーが監視する必要があるイベントタイプを1つ以上指定してください。
- チーム名: チーム名を入力してください。 チーム名を選択ボタンを使用して、Teamsモーダルを使用してチームを選択することもできます。
- チャンネル名: チャネル名を入力してください。 チャネル名を選択 を使用して、チャネル モーダルからチームを選択することも可能です。
- フィルター: チェックボックスを有効にし、メッセージをフィルタリングするためのキーワードを入力してください。
-
チームメンバー： チームメンバーシップオプションを使用して、チーム内のメンバーシップの変更に基づいてトリガーを構成します。 このオプションで利用できる設定は次のとおりです。
- 会員オプション： トリガーが監視する必要があるイベントタイプを1つ以上指定してください。
- チーム名: チーム名を入力してください。 チーム名を選択ボタンを使用して、Teamsモーダルを使用してチームを選択することもできます。
- 証明書
- 認証と暗号化のために 証明 オプションを使用して証明書を選択します。
- 資格情報: 選択 オプションを使用し、資格情報を選択 モーダルの指示に従って、Credential Vault に保存されている Microsoft Azure 証明書を選択してください。
- 安全でない文字列: 不安全な文字列 オプションを使用して、証明書ファイルの内容を入力フィールドに直接入力します。
- レスポンス
- トリガー応答データを レコード 変数に保存するには、レスポンス オプションを使用してください。 新しい変数を作成するか、既存の変数を選択してこの応答データを保存できます。
監査ログ でトリガー応答データを読み取る
トリガー応答データには、変更が発生したイベントレコードのすべての情報が含まれています。 このレスポンスデータはキーと値のペア形式で保存されています。 このデータを抽出し、自動化内の他のアクションの入力として利用できます。 Bot の実行が完了すると、トリガーデータ情報は トリガーによって実行された Bot イベントタイプとして 監査ログ に記録されます。