学ぶ (英語版)
ドキュメント (英語版)
サポート (英語のみ)
コミュニティ (英語版)

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

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

Nexthinkは、サードパーティのドキュメントや外部の更新によって生じる不整合性の正確さを制御しません。

エラーや矛盾をNexthinkサポートに報告してください。

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

MS Teamsで

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

  1. 作成したチャネルの三点リーダーをクリックし、ワークフローを選択します。

  2. ポップアップから、webhookリクエストが受信されたときにチャネルに投稿するオプションを検索し選択します。 以下の画像を参照してください。

  1. ワークフローに名前を付け、ワークフロー接続を定義します。

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

  1. 新しいワークフローを作成するには、「ワークフローを追加」ボタンを選択します。

  2. 将来の参考のために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；

  1. 「ワークフローを管理」を選択します：

  • 出力形式が「添付ファイル」に設定されていることを確認してください

  • Adaptiveカードをコンテンツとして定義してください；

  • プライベートチームチャネルでは、ドロップダウンを使用して投稿者: ユーザーを設定してください。 それ以外の場合、Fow Botを選択できます。

Power AutomatorからのURLをデコードしてからNexthinkのWebhook設定に貼り付ける必要があります。

Entra IDで

コネクタ資格情報の認証OAuth 2.0を必要としない場合は、Nexthinkでセクションにジャンプしてください。

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

  1. 新しいアプリケーションを登録するには、自身のEntra IDインスタンスに移動します。

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

  1. アプリケーションに名前をつけ、サポートされるアカウントタイプを定義してください。

  2. アプリケーションを登録し、将来のコネクタ資格情報の認証付き設定の際に参照するためにアプリケーションIDをコピーします。

  3. 新しいクライアントシークレットをクリックし、経験の日時を定義します；

  4. 将来のコネクタ資格情報の認証付き設定の際に参照するために秘密の値（IDではない）をコピーします。；

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

  1. API 権限タブに移動し、サインインユーザーとしてMicrosoft Flowにアクセス権限を追加します。

  2. 登録されたアプリの概要に戻り、エンドポイントタブに移動してください。

  3. 将来のNexthinkでのWebhook設定の際に参照するために**OAuth 2.0トークンエンドポイント(v2)**を保存します。

Nexthinkで

NexthinkのWebインターフェイスで：

認証なしでMSチームのコネクター資格情報を設定する

コネクター資格情報設定ページで、MS Teamsに設定された受信Webhookの情報を使用してフィールドを埋めます：

  1. プロトコルのドロップダウンからHTTPSを選択してください。

  2. https://xxxxx.your-instance.logic.azure.com:443のルートURLをMS TeamsからのURLのURLアドレスフィールドに貼り付けてください。

  3. 認証のドロップダウンから**No Auth (なし)**オプションを選択してください。

  4. 資格情報を保存します。

認証ありでMSチームのコネクター資格情報を設定する

コネクター資格情報設定ページで、MS Teamsに設定された受信Webhookの情報を使用してフィールドを埋めます。

  1. プロトコルのドロップダウンからHTTPSを選択してください。

  2. https://xxxxx.your-instance.logic.azure.com:443のルートURLをMS TeamsからのURLのURLアドレスフィールドに貼り付けてください。

  3. 認証のドロップダウンからOAuth 2.0 - クライアントクレデンシャルオプションを選択してください。

  4. アクセストークンURL、クライアントID、クライアントシークレットをEntra IDアプリケーション登録からの値で入力します；

  5. 資格情報を保存します。\

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

Webhook設定ページから、MS Teamsで作成した接続およびNexthinkに定義されたコネクター資格情報を使用してフィールドを埋めてください：

  1. Webhook 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.reve APPEND`рат hollow recovery_values, alert.context, device_view_link , issue_view_link

  1. **認証】のドロップダウンから、MS Teamsの設定済みコネクター資格情報（認証ありの場合with authentication、認証無しならwithout authentication）を選択します。

  2. MethodのドロップダウンからPOSTを選択します。

  3. MS Teams設定からのルートURLアドレスなしのURLエンドポイントをリソース・フィールドに貼り付けてください。 例えば：/workflows/XXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=?????&sp=/triggers/manual/run&sv=1.0&sig=XXXXXXXXXXXXXXX；

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

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

{
  "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": "View in Nexthink",
                "url": "{{alert.alert.issue_view_link}}"
              }
            ]
          }
        ]
      }
    }
  ]
}

  1. テスト送信を行い、メッセージがMS Teamsにプッシュされるか確認します。

Last updated

Was this helpful?