MS Teams チャンネルへのメッセージ投稿

このドキュメントは外部ソースを参照しています。

Nexthinkは、サードパーティのドキュメントや外部の更新による正確性を保証しません。

誤りや不一致があった場合は、Nexthinkサポートに報告してください。

このドキュメントでは、Webhookを使用してMS Teamsチャンネルにメッセージを投稿する方法を説明します。

MS Teamsにおける

新しいMS Teamsチャンネルを作成した後、Microsoft Power Automateを使用して新しいワークフローを設定します。

作成したチャンネルの三点ドットをクリックし、ワークフローを選択します。
ポップアップから、Webhook要求を受信した時にチャンネルに投稿オプションを探して選択します。下の画像を参照してください。

ワークフローの名前を設定し、ワークフロー接続を定義します。

NexthinkのWebhookを使用して通知するためのMS Teamsのチャンネルを定義します。

ワークフローを追加ボタンを選択して、新しいワークフローを作成します。
将来の参照のためにURLをコピーします。それは、コネクタ証明書とNexthinkのWebインターフェースでのWebhook設定のためのものです。下の画像を参照してください。

URLの例: https://xxxxx.your-instance.logic.azure.com:443/workflows/XXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=yhejWbe6e03M9-cvU-hXXXXXXXXXXXXX

ワークフローの管理を選択します。

出力形式がattachmentsに設定されていることを確認します。
Adaptive cardとしてcontentが定義されていることを確認してください。
プライベートチームチャンネルには、ドロップダウンを使用して投稿者: ユーザーを設定します。それ以外の場合は、Fow Botを選択することができます。

Power AutomatorからURLをデコードしてから、NexthinkでのWebhook設定にペーストしてください。

Entra IDにおいて

In Nexthinkセクションにジャンプし、コネクタ証明書にOAuth 2.0の認証が不要な場合は続行してください。

Microsoft Entra IDで以下の手順に従ってください:

Entra IDインスタンスに移動し、新しいアプリケーションを登録します。

管理 > アプリ登録 > 新しい登録

アプリケーションの名前を付け、サポートするアカウントタイプを定義します。
アプリケーションを登録し、今後の参照用にアプリケーションIDをコピーして、コネクタ証明書を認証付きで構成する際に使用します。
新しいクライアントシークレットをクリックし、経験の日付を定義します。
コネクタ証明書を認証付きで構成する際に使用するため、今後の参照用にシークレット値（IDではありません）をコピーします。

シークレット値は作成後のみコピーできます。

API権限タブに移動し、サインインユーザーとしてMicrosoft Flowにアクセス許可を追加します。
登録したアプリのオーバービューに戻り、エンドポイントタブに移動します。
Webhookの設定の際に使用するため、今後の参照用に**OAuth 2.0トークンエンドポイント(v2)**を保存してください。

Nexthinkにおいて

Nexthinkウェブインターフェースから:

MS Team向けのアウトゴーイングWebhook用のコネクタ証明書を設定します。
- 認証なし: No Auth (なし)
- OAuth 2.0認証付き
MSチャンネルにメッセージを投稿するWebhookを設定しテストします。

認証なしでMS Teamのコネクタ証明書を設定する

コネクタ証明書設定ページから、MS Teamsで設定されたインカミングWebhookの情報を使ってフィールドを記入します:

プロトコルドロップダウンからHTTPSオプションを選択します。
MS TeamsからURLのルートhttps://xxxxx.your-instance.logic.azure.com:443をURLアドレスフィールドに貼り付けます。
認可ドロップダウンから**No Auth (なし)**オプションを選択してください。
資格情報を保存します。

認証付きでMS Teamのコネクタ証明書を設定する

コネクタ証明書設定ページから、MS Teamsで設定されたインカミングWebhookの情報を使ってフィールドを記入します:

プロトコルドロップダウンからHTTPSオプションを選択します。
MS TeamsからURLのルートhttps://xxxxx.your-instance.logic.azure.com:443をURLアドレスフィールドに貼り付けます。
認可ドロップダウンからOAuth 2.0 - クライアント機密情報オプションを選択します。
Entra IDアプリケーション登録の値を使用して、アクセストークンURL、クライアントID、クライアントシークレットを入力します。
資格情報を保存します。

MSチャンネル用のWebhookを設定する

Webhook設定ページから、MS Teamsで作成した接続とNexthinkで定義したコネクタ証明書の情報を使ってフィールドを記入します:

Webhook NQL条件の設定ドキュメントに従ってNQL条件を記入してください。以下のクエリを参照してください。

NQL条件を記入した後、システムがペイロード用の許可されているプレースホルダーの一覧を提示します。

alert.alerts
| where monitor.tags contains "web-applications"
| where alert.context contains "*Salesforce*" or alert.context contains "*Microsoft*"
| list alert.monitor.name, alert.status, monitor.tags, alert.context, trigger_time, recovery_time, alert.monitor.thresholds, monitor.priority, alert.trigger_values, alert.trigger_reference_value, alert.recovery_values, alert.context, device_view_link , issue_view_link

認証のある場合とない場合で、資格情報ドロップダウンからMS Team用の設定済みコネクタ証明書を選択します。
メソッドドロップダウンからPOSTを選択します。
MS Teams設定からルートURLアドレスを除いたURLエンドポイントをリソースフィールドに貼り付けます。たとえば: /workflows/XXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=?????&sp=/triggers/manual/run&sv=1.0&sig=XXXXXXXXXXXXXXX

URLがエンコードされていないことを確認してください。

ペイロードに送信したいメッセージを追加します。下記の例を参照してください。

下のペイロード例では、特別なプレースホルダーとしてのアラートデータモデル変数が使用されています。

{
  "type": "message",
  "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.0",
        "msteams": {
          "width": "Full"
        },
        "body": [{
            "type": "TextBlock",
            "text": "Nexthink Alert",
            "id": "Title",
            "spacing": "Medium",
            "horizontalAlignment": "Center",
            "size": "ExtraLarge",
            "weight": "Bolder",
            "color": "Accent"
          }, {
            "type": "Container",
            "items": [{
                "type": "TextBlock",
                "text": "{{alert.alert.context.application.name}},{{alert.monitor.name}}",
                "wrap": true,
                "color": "Default",
                "size": "Medium"
              }
            ],
            "style": "emphasis"
          }, {
            "type": "FactSet",
            "facts": [{
                "title": "Assigned to",
                "value": "Infrastructure Team"
              }, {
                "title": "Triggered on: ",
                "value": "{{alert.alert.trigger_time}}"
              }, {
                "title": "Application Name",
                "value": "{{alert.alert.context.application.name}}"
              },
            ]
          }, {
            "type": "TextBlock",
            "text": "Condition breached:",
            "wrap": true
          }, {
            "type": "Table",
            "columns": [{
                "width": 1
              }, {
                "width": 1
              }, {
                "width": 1
              }, {
                "width": 1
              }
            ],
            "rows": [{
                "type": "TableRow",
                "cells": [{
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Metric name",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Threshold",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Metric value",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "Baseline Value",
                        "wrap": true
                      }
                    ]
                  }
                ]
              }, {
                "type": "TableRow",
                "cells": [{
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[0].alias}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.monitor.thresholds[0].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[0].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_reference_value}}",
                        "wrap": true
                      }
                    ]
                  }
                ]
              }, {
                "type": "TableRow",
                "cells": [{
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[1].alias}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.monitor.thresholds[1].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "{{alert.alert.trigger_values[1].value}}",
                        "wrap": true
                      }
                    ]
                  }, {
                    "type": "TableCell",
                    "items": [{
                        "type": "TextBlock",
                        "text": "",
                        "wrap": true
                      }
                    ]
                  }
                ]
              }
            ],
            "showGridLines": false
          }, {
            "type": "ActionSet",
            "actions": [{
                "type": "Action.OpenUrl",
                "title": "Nexthinkで見る",
                "URL": "{{alert.alert.issue_view_link}}"
              }
            ]
          }
        ]
      }
    }
  ]
}

メッセージがMS Teamsにプッシュされることを確認するためにテスト送信します。

Last updated 12 days ago

Was this helpful?