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

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

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

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

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

MS Teamsで

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

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

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

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

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

2. 新しいワークフローを作成するためにワークフローの追加ボタンを選択します。

3. 将来的な参照用に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&#x20

4. ワークフローの管理を選択します:

   • 出力フォーマットが添付ファイルに設定されていることを確認します

   • アダプティブカードがコンテンツとして定義されていることを確認します。&#x20

   • プライベートチームチャネルの場合、ドロップダウンを使用してユーザーとして投稿を設定します。 それ以外の場合は、フォウ ボットを選択できます。

Nexthinkでwebhook設定の際にPower AutomatorからURLをデコードする必要があります。

Entra IDで

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

Microsoft Entra IDで以下の手順に従います:

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

   • 管理 > アプリ登録 > 新規登録

2. アプリケーションに名前を付け、サポートされるアカウントタイプを定義します。

3. アプリケーションを登録し、Nexthinkで認証を持つコネクタ資格情報を構成する際に参照するためのアプリケーションIDをコピーします。

4. 新しいクライアントシークレットをクリックし、エクスペリエンスの日付を定義します。&#x20

5. Nexthinkで認証を持つコネクタ資格情報を構成する際の作成後の参照用として秘密値（IDではない）をコピーします。&#x20

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

6. API許可タブに移動し、署名されているユーザーとしてMicrosoft Flowへのアクセス許可を追加します。

7. 登録されたアプリの概要に戻り、エンドポイントタブに移動します。

8. Nexthinkでのwebhook設定の未来の参照用に OAuth 2.0 トークンエンドポイント (v2) を保存します。

Nexthinkで

Nexthinkのwebインターフェースから:

• MS Teamへのアウトゴーイングwebhook用にコネクタ資格情報を設定します。

  • 認証なし: No Auth (None)

  • OAuth 2.0認証付き

• MSチャネルでメッセージを投稿するwebhookを設定してテストします

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

コネクタ資格情報設定ページから、MS Teamsで設定された着信webhookからの情報を使用してフィールドを入力します:

1. プロトコルのドロップダウンからHTTPSオプションを選択します。

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

3. 認証のドロップダウンから**No Auth (None)**オプションを選択します。

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

認証付きでMS Team用のコネクタ資格情報を設定する

コネクタ資格情報設定ページから、MS Teamsで設定された着信webhookからの情報を使用してフィールドを入力します:

1. プロトコルのドロップダウンからHTTPSオプションを選択します。

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

3. 認証のドロップダウンからOAuth 2.0 - クライアント資格情報オプションを選択します。

4. Entra IDのアプリケーション登録からの値を使用してアクセス トークン URL、 クライアントID 、および クライアント シークレットを入力します。&#x20

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

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

webhook設定ページから、MS Teamsで作成した接続とNexthinkで定義したコネクタ資格情報を使用してフィールドを入力します:

1. webhook NQL条件を設定するドキュメンテーションに従いNQL条件を入力します。 以下のクエリを参照してください。

   • NQL条件に入力すると、システムがペイロードのための許可されたプレースホルダーをリストします。&#x20

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

1. 資格情報ドロップダウンから、ケースに応じて認証ありまたは認証なしのMS Team用に構成されたコネクタ資格情報を選択します。

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

3. ルート URLアドレスを除いて、MS Teams構成からのURLエンドポイントをリソースフィールドに貼り付けます。 例: /workflows/XXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=?????&sp=/triggers/manual/run&sv=1.0&sig=XXXXXXXXXXXXXXX &#x20

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

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

   • 以下のペイロード例では、アラートデータモデル変数の特殊なプレースホルダーを使用していることに注意してください。

MicrosoftのOffice 365にアクショナブルメッセージカードを投稿するドキュメントを参照して、コネクタ経由のアクショナブルメッセージに関する詳細情報を確認してください。

{
  "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にプッシュされるか確認します。