> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks/configuring-webhook-fields_-method-resource-and-payload.md).

# Webhookフィールドの設定: メソッド、リソース、ペイロード

Webhookを設定する主な利点は、アラートやイベントからのNexthinkデータを、送信先に応じて、さまざまなサードパーティツールにプッシュできることです。

[Webhook設定](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks.md) ページでは、サードパーティツールでのアクションを実行するために重要な3つのフィールドがあります。

* **メソッド**
* **リソース**
* **ペイロード**

以下のセクションでは、サードパーティツール上でのアクション実行のための属性設定について説明します。

## メソッドの選択 <a href="#configuringwebhookfields-method-resource-andpayload-selectingthemethod" id="configuringwebhookfields-method-resource-andpayload-selectingthemethod"></a>

[Webhook設定](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks.md)ページから、資格情報を選択した後：

1. **メソッド** ドロップダウンから **POST**、**PUT**、または **PATCH** のいずれかを選択してください。以下の表を参照してください。
2. オプションとして、各メソッドの意味を明確に把握するために、関連するサードパーティソフトウェアのドキュメントを確認してください。
   * すべての販売者とサードパーティツールプロバイダーがすべてのメソッドを同様に使用するとは限りません。

{% hint style="info" %}
REST標準はHTTP上で使用され、ウェブフック用リクエストメソッドを提供し、標準インターフェース制約の主要部分を構成します。
{% endhint %}

| HTTPメソッド | CRUD\* | 説明                                                                                |
| -------- | ------ | --------------------------------------------------------------------------------- |
| POST     | 作成     | POSTは、新しいリソースを作成するために最も頻繁に利用されます。                                                 |
| PUT      | 更新/置換  | PUTはその更新機能のために最も頻繁に使用されます。既知のリソースURIにPUTし、リクエストボディに元のリソースの更新された表現を含めることができます。     |
| PATCH    | 更新/修正  | PATCHは修正機能のために使用されます。 PATCHリクエストには、リソースの変更すべき部分だけを含めればよく、完全なリソースを必ずしも含める必要はありません。 |

\*\_CRUD\_は、作成、読み取り、更新、削除の略語です。

## リソースフィールドの入力 <a href="#configuringwebhookfields-method-resource-andpayload-fillingintheresourcefieldresource" id="configuringwebhookfields-method-resource-andpayload-fillingintheresourcefieldresource"></a>

リソースに関する特別な考慮事項:

* リソースはエンドポイントを通じてアクセス可能なデータセットで、APIと共に使用されます。
* リソースは他のリソースと関連し、実行可能な操作に制限があります。
* リソースは、関連するデータや、操作可能なオブジェクトに基づくエンドポイントグループとして提示されます。
* リソースには簡単な名前が付けられ、ユーザーが正しいエンドポイントを見つけやすくなっています。しかし、これにより重要な機能を見逃す可能性があります。

[ウェブフック設定](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks.md) ページから **Resource** 値を追加するには:

1. 指定されたサードパーティREST APIのアクションである **リソース** 値を貼り付けます。
   * URIは追加しないでください。それはウェブフック[資格情報](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/connector-credentials.md)に定義された **インスタンスURL** に連結されます。
   * **リソース** 値には、サードパーティツールが要求するパラメータ (key=value) を含めることができます。
2. 必要に応じて、**リソース** にプレースホルダ `{{variable_name}}` を追加してください。このページの[ペイロード内のプレースホルダーとしてのデータモデル変数の使用](#configuringwebhookfields-method-resource-andpayload-usingdatamodelvariablesasplaceholdersinthepayloa) セクションを参照してください。

### 有効なリソース値の例 <a href="#configuringwebhookfields-method-resource-andpayload-examplesofvalidresourcevalues" id="configuringwebhookfields-method-resource-andpayload-examplesofvalidresourcevalues"></a>

| ベンダーAPI URL                                                  | Webhook内のリソース値              |
| ------------------------------------------------------------ | --------------------------- |
| <https://webhook.atlassian.net/rest/servicedeskapi/request>  | rest/servicedeskapi/request |
| <https://api.4me.com/v1/requests>                            | v1/requests                 |
| <https://api.qualtrics.com/2482a48f62473-users>              | API/v3/users                |
| <https://ven01063.service-now.com/api/now/v1/table/incident> | api/now/v1/table/incident   |
| <https://api.4me.com/v1/requests?api\\_=>                    | v1/requests?api\_=          |

## ペイロードの作成 <a href="#configuringwebhookfields-method-resource-andpayload-writingthepayloadpayload" id="configuringwebhookfields-method-resource-andpayload-writingthepayloadpayload"></a>

**ペイロード** は、HTTP内でPOST/PUT/PATCHメソッドとともに送信されるデータパックです。

[Webhook設定](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks.md) ページから **ペイロード** 値を記述するには:

1. APIをリクエストする際にサーバーに送信する重要な情報を**ペイロード**に含めてください。
   * オプションとして、**ペイロード**は、Webhookで使用しているツールに依存する関連サードパーティフィールドと値を確認してください。
2. 必要に応じて、[ペイロード内のプレースホルダーとしてのNexthinkデータモデル変数](#configuringwebhookfields-method-resource-andpayload-usingdatamodelvariablesasplaceholdersinthepayloa) `{{variable_name}}` を使用してください。
   * Webhook **NQL条件** の入力後、システムはNexthink Webインターフェースで **許可されたプレースホルダー** を表示します。
3. このページに掲載されている [複数のプロバイダーからのメソッド、リソース、ペイロードの例](#configuringwebhookfields-method-resource-andpayload-examplesofmethod-resourceandpayloadfrommultiplep) を参考にしてください。

{% hint style="info" %}
**ペイロード**フィールドはJSON形式のみを受け入れます。
{% endhint %}

### ペイロード内でのデータモデル変数のプレースホルダーとしての使用 <a href="#configuringwebhookfields-method-resource-andpayload-usingdatamodelvariablesasplaceholdersinthepayloa" id="configuringwebhookfields-method-resource-andpayload-usingdatamodelvariablesasplaceholdersinthepayloa"></a>

Nexthinkからサードパーティツールにデータをプッシュする大きな利点の一つは、発生したイベントに関する情報を渡すことができるという点です。

**ペイロード**内でNexthinkデータモデル変数をプレースホルダーとして使用するには:

1. ペイロードに報告される任意のフィールド内で `{{variable_name}}` プレースホルダーを使用してNexthink変数を参照してください。
2. [Webhook NQL条件](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks/configuring-webhook-nql-conditions.md) の入力後、Nexthink Webインターフェースで **許可されたプレースホルダー** が表示されます。
   * ペイロードのプレースホルダーは、Nexthink変数を埋め込む [Webhook NQL条件](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks/configuring-webhook-nql-conditions.md) と整合する必要があります。
3. さらに、プレースホルダーで利用可能な Nexthink 変数を判断するために [NQL データモデル](/platform/platform/ja/understanding-key-data-platform-concepts/nql-data-model.md) を確認することができます。
   * なお、NQLデータモデルは、namespace > table > field で組織されています。
   * 例えば、プレースホルダー `{{alert.monitor.name}}` は、`alerts` namespace 内の `monitor` テーブルの `name` フィールドを含むものです。詳細については、[データ組織](/platform/platform/ja/understanding-key-data-platform-concepts/data-organization.md)に関するドキュメントを参照してください。
4. サードパーティツールで生成される出力を読みやすくユーザーフレンドリーにするために、プレースホルダーに 'as(format = text)' を追加してください。例えば、 `{{remote_action.execution.outputs.as(format = text)}}` 。
5. 必要に応じて、NQLデータモデルで厳密には定義されていない特別なプレースホルダーを使用してください。これらはこのページで説明されており、Nexthink Webインターフェースの **許可されたプレースホルダー** にも参照されています。

* [アラートデータモデル変数用特別プレースホルダー](#configuringwebhookfields-method-resource-andpayload-specialplaceholdersforalertsdatamodelvariablesal)
* [リモートアクションデータモデル変数用特別プレースホルダー](#configuringwebhookfields-method-resource-andpayload-specialplaceholdersforremoteactionsdatamodelvari)

以下の画像は、Nexthinkデータモデル変数を参照するプレースホルダーを含むペイロードの例です。このケースでは、システムが **許可されたプレースホルダー**をどのようにリストするかに注意してください。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-f4f4256d4c180735749ff342edf4c2484d15fe49%2Fmethod-resource-payload-123456789.png?alt=media" alt="Allowed placeholders from the webhook configuration page." width="760"><figcaption></figcaption></figure>

{% hint style="info" %}
システムは、空の値や無効な値と置き換えることはできません。この場合、`{{variable_name}}`がそのまま表現されます。
{% endhint %}

### アラートデータモデル変数用特別プレースホルダー <a href="#configuringwebhookfields-method-resource-andpayload-specialplaceholdersforalertsdatamodelvariablesal" id="configuringwebhookfields-method-resource-andpayload-specialplaceholdersforalertsdatamodelvariablesal"></a>

この表には、NQLデータプロパティで厳密には定義されていないアラート用の特別なプレースホルダーが含まれています。

| NQLデータモデルのプロパティ                                                                                                                                                                     | 特別プレースホルダー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `alert.monitor.thresholds`                                                                                                                                                          | <p>各配列アイテムには <code>エイリアス</code> (メトリクス名) と対応する <code>値</code> があります:</p><p><code>{{alert.monitor.thresholds\[n].alias}}</code></p><p><code>{{alert.monitor.thresholds\[n].values}}</code></p><p><code>\[n]</code> の値を整数に置き換えます。 <code>\[n]</code> 値の数は、モニターで定義されている<a href="/platform/platform/ja/user-guide/alerts-and-diagnostics/setting-up-and-managing-monitors/customizing-built-in-monitors.md">メトリックしきい値</a>の数によって決まります:</p><p>• <code>\[0]</code> 値は常に使用できます。</p><p>• <code>\[1]</code> 以上の値はオプションです。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `alert.trigger_values`                                                                                                                                                              | <p>各配列アイテムには <code>エイリアス</code> (メトリクス名) と対応する <code>値</code> があります:</p><p><code>{{alert.alert.trigger\_values\[n].alias}}</code></p><p><code>{{alert.alert.trigger\_values\[n].value}}</code></p><p><code>\[n]</code> の値を整数に置き換えます: <code>\[0]</code> 、<code>\[1]</code> など。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `alert.trigger_reference_value`                                                                                                                                                     | <p><code>{{alert.alert.trigger\_reference\_value}}</code></p><p><code>reference\_value</code> の計算について詳しくは、<a href="/platform/platform/ja/user-guide/alerts-and-diagnostics/setting-up-and-managing-monitors/customizing-built-in-monitors.md">組み込みモニターのカスタマイズ</a>のドキュメントにある<em>タイプ</em>セクションの<em>メトリックの変更</em>項目を参照してください。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `alert.context`                                                                                                                                                                     | <p><code>{{alert.alert.context}}</code></p><p><code>{{alert.alert.context.\<property name>}}</code></p><p><code>{{alert.alert.context.\<property name>.label}}</code></p><p><code>{{alert.alert.context.\<property name>.data\_path}}</code></p><p><code>{{alert.alert.context.\<property name>.data\_type}}</code></p><p>以下の例を参照してください\*:</p><p><code>{{alert.alert.context.binary.name}}</code></p><p><code>{{alert.alert.context.binary.name.label}}</code></p><p><code>{{alert.alert.context.binary.name.data\_path}}</code></p><p><code>{{alert.alert.context.binary.name.data\_type}}</code></p><p>\*<code>context</code> フィールドには、<a href="/platform/platform/ja/user-guide/alerts-and-diagnostics/setting-up-and-managing-monitors/creating-custom-monitors.md">モニターの NQL クエリおよび条件</a>で定義されているデータモデルプロパティのみが含まれます。</p><p>したがって、<code>context</code>フィールドは、アラートに関連するバイナリ、デバイス、またはユーザーの名前を含む可能性があります。</p>                                                                                                                                                                                  |
| <p><code>alert.alert.issue\_view\_link</code></p><p><code>alert.alert.device\_view\_link</code></p><p><code>alert.alerts.links</code></p><p>これらのプロパティは現在、NQLデータモデルにはリストされていません。</p> | <p><code>alert.alert.issue\_view\_link</code> は、アラートに関連付けられた<a href="/platform/platform/ja/user-guide/alerts-and-diagnostics/getting-started-with-alerts/responding-to-alerts/diagnostics-for-alerted-issues.md">トラブルシューティングダッシュボード</a>へのリンクを提供します。ウェブフックの<strong>NQL条件</strong>で <code>issue\_view\_link</code> フィールドを <code>リスト</code> 条件に追加する必要があります。</p><p><code>alert.alert.device\_view\_link</code>は、<a href="/platform/platform/ja/user-guide/device-view.md">デバイスビュー</a>へのリンクを提供します。ウェブフックの <strong>NQL 条件</strong> で <code>device\_view\_link</code> フィールドを <code>リスト</code> 条件に追加する必要があります。</p><p>アラート設定に応じて、<code>alert.alerts.links</code> プレースホルダーは、アラートに関連付けられた<a href="/platform/platform/ja/user-guide/device-view.md">デバイスビュー</a>または<a href="/platform/platform/ja/user-guide/alerts-and-diagnostics/getting-started-with-alerts/responding-to-alerts/diagnostics-for-alerted-issues.md">トラブルシューティングダッシュボード</a>へのリンクを提供します。<br>この場合、ウェブフック <strong>NQL条件</strong> の <code>リスト</code> 条件に <code>device\_view\_link</code> および <code>issue\_view\_link</code> を追加する必要があります。</p> |

### リモートアクションデータモデル変数専用の特別なプレースホルダー <a href="#configuringwebhookfields-method-resource-andpayload-specialplaceholdersforremoteactionsdatamodelvari" id="configuringwebhookfields-method-resource-andpayload-specialplaceholdersforremoteactionsdatamodelvari"></a>

この表には、NQLデータプロパティで厳密には定義されていないリモートアクション用の特別なプレースホルダーが含まれています。

| NQLデータモデルのプロパティ                                                                                    | 特別プレースホルダー                                                                                                                                                     |
| -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `remote_action.execution.outputs`                                                                  | <p><code>{{remote\_action.execution.outputs.\<property name>}}</code></p><p>例えば:</p><p><code>{{remote\_action.execution.outputs.MeteredConnection}}</code></p> |
| `remote_action.execution.inputs`                                                                   | <p><code>{{remote\_action.execution.inputs.\<property name>}}</code></p><p>例えば:</p><p><code>{{remote\_action.execution.inputs.InputPath}}</code></p>           |
| <p><code>remote\_action.execution.account\_name</code></p><p>このプロパティは現在、NQLデータモデルにはリストされていません。</p> | <p><code>{{remote\_action.execution.account\_name}}</code></p><p>このプレースホルダーは、リモートアクションを実行したユーザー/従業員を提供します。</p>                                                 |

## 複数のプロバイダーとツールのメソッド、リソース、およびペイロードの例 <a href="#configuringwebhookfields-method-resource-andpayload-examplesofmethod-resourceandpayloadfrommultiplep" id="configuringwebhookfields-method-resource-andpayload-examplesofmethod-resourceandpayloadfrommultiplep"></a>

{% hint style="info" %}
複数のサードパーティツールのフルウェブフック設定については、[Webhookのユースケースセットアップ](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup.md)ドキュメントを参照してください。
{% endhint %}

### ITSM ツール <a href="#configuringwebhookfields-method-resource-andpayload-itsmtools" id="configuringwebhookfields-method-resource-andpayload-itsmtools"></a>

#### **ServiceNowに対するインシデントの作成**

メソッド: `POST`

リソース: `api/now/v1/table/incident`

ペイロード:

```
{
 "assignment_group":"Application Team",
 "business_service":"MS Teams",
 "caller_id":"Nexthink Alert",
 "description":"Alert created from the Alerts team,",
 "impact":"5",
 "short_description":"Alert for testing purposes David G {{alert.monitor.name}}",
 "sys_created_by":"Nexthink Integration test David G.",
 "urgency":4
}
```

[こちらのガイドラインを参照](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/creating-an-incident-in-servicenow.md)して、アラートやイベントを検出し、それをServiceNowに送信してインシデントを作成するWebhooksを設定してください。

#### **AmplifyからServiceNowインシデントチケットの更新**

メソッド: `PATCH`

リソース: `api/now/v1/table/incident/{{remote_action.execution.external_reference}}`

ペイロード (メッセージ):

```
{"work_notes": "Remote action {{remote_action.execution.outputs.as(format = text)}} was triggered for this ticket from Amplify user {{remote_action.execution.account_name}} at {{remote_action.execution.request_time}}"}
```

`"work_notes"` に `as(format = text)` 関数を含めて、リモートアクションの出力を読みやすい形式で表示するようにしてください。

[こちらのガイドラインを参照](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/updating-servicenow-from-amplify.md)して、AmplifyからServiceNow実行アクションログを更新するWebhooksを設定してください。

#### **ServiceNow に問題を作成する**

メソッド: `POST`

リソース: `api/now/v1/table/problem`

ペイロード:

```
{
 "impact":"1",
 "urgency":"2",
 "category":"Hardware",
 "short_description":"The alert: {{alert.monitor.name}} has been raised by Nexthink",
 "description":"The Alert {{alert.monitor.name}} has been raised automatically by Nexthink at {{alert.monitor.time}}. The NQL query that triggered the alert is https://tinyurl.com/29k9xy8d",
 "assignment_group":"Application Team",
 "business_service":"MS Teams",
}
```

#### **BMC にインシデントを作成する**

メソッド: `POST`

リソース: `api/arsys/v1/entry/HPD:IncidentInterface_Create?fields=values(Incident Number , Request ID, First_Name)`

ペイロード:

```
{
 "values": {
 "First_Name": "Allen",
 "Last_Name": "Allbrook",
 "Description": "REST API: Nexthink alert {{alert.monitor.name}} has been triggered",
 "Impact": "1-Extensive/Widespread",
 "Urgency": "1-Critical",
 "Status": "Assigned",
 "Reported Source": "Direct Input",
 "Service_Type": "User Service Restoration" 
 }
}
```

#### **4me にインシデントを作成する**

メソッド: `POST`

リソース: `v1/requests`

ペイロード:

```
{
"category":"incident",
"subject":"This is a result triggered by the alert {{alert.monitor.name}}",
"impact":"low",
"service_instance_id":"147488",
"ci":"21819154",
"ci_id":"21819154",
"note":"The alert has been triggered at {{alert.alert.trigger_time}} with the following values: {{alert.alerts.trigger_values[0].alias}}: {{alert.alerts.trigger_values[0].value}}, {{alert.alerts.trigger_values[1].alias}}: {{alert.alerts.trigger_values[1].value}}"
}
```

#### **Jira Service Desk にサービスリクエストを作成する**

メソッド: `POST`

リソース: `rest/servicedeskapi/request`

ペイロード:

```
{
 "serviceDeskId": "1",
 "requestTypeId": "5",
 "requestFieldValues": {
 "summary": "Request JSD help via REST",
 "description": "I need a new *mouse* for my Mac"
  }
}
```

### アラートツール <a href="#configuringwebhookfields-method-resource-andpayload-alertingtools" id="configuringwebhookfields-method-resource-andpayload-alertingtools"></a>

#### **Pager Duty にインシデントを作成する**

メソッド: `POST`

リソース: `incidents`

ペイロード:

```
{
 "incident": {
 "type": "incident",
 "title": "api incident for nexthink alert {{alert.monitor.name}}",
 "service": {
 "id": "PXZF637",
 "summary": null,
 "type": "service_reference",
 "self": null,
 "html_url": null
    },
 "priority": {
 "id": "high",
 "summary": null,
 "type": "priority_reference",
 "self": null,
 "html_url": null
    },
 "urgency": "high",
 "body": {
 "type": "incident_body",
 "details": "string"
    },
 "incident_key": "incident_{{alert.alert.trigger_time}}",
 "escalation_policy": {
 "id": "P14MFQ2",
 "summary": null,
 "type": "escalation_policy_reference",
 "self": null,
 "html_url": null
    },
 "conference_bridge": {
 "conference_number": "string",
 "conference_url": "string"
    }
  }
}
```

### メッセージングツール <a href="#configuringwebhookfields-method-resource-andpayload-messagingtools" id="configuringwebhookfields-method-resource-andpayload-messagingtools"></a>

#### **MS Teams チャンネルにメッセージを投稿する**

メソッド: `POST`

リソース: `/workflows/XXXXXXXXXXXXXXXXXXX/triggers/manual/paths/invoke?api-version=?????&sp=/triggers/manual/run&sv=1.0&sig=XXXXXXXXXXXXXXX`

ペイロード:

```
{
    "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
                                }
                            ]
                        }
                    ]
                },
                {
                    "type": "TableRow",
                    "cells": [
                        {
                            "type": "TableCell",
                            "items": [
                                {
                                    "type": "TextBlock",
                                    "text": "",
                                    "wrap": true
                                }
                            ]
                        },
                        {
                            "type": "TableCell",
                            "items": [
                                {
                                    "type": "TextBlock",
                                    "text": "",
                                    "wrap": true
                                }
                            ]
                        },
                        {
                            "type": "TableCell",
                            "items": [
                                {
                                    "type": "TextBlock",
                                    "text": "",
                                    "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}}"
                }
            ]
        }
                ] 
            }
        }
    ]
}
```

[このガイドラインに従い](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/posting-a-message-to-an-ms-teams-channel.md#postingamessagetoanmsteamschannel-comment-1085538388) MS Teams での受信リクエストのセットアップを行います。

#### **特定の Slack チャンネルにメッセージを投稿する**

メソッド: `POST`

リソース: `services/T01S01V0HB3/B02GY9BKZ7G/DIDFWXuCAeFfqkgNntQqJV7e`

ペイロード:

```
{
 "channel":"C01R6KV8CA3",
 "text":"There is an alert {{alert.monitor.name}} that is affecting the digital experience",
 "attachments":[
        {
 "text":"Who should take a look at it?",
 "fallback":"You could be telling the computer exactly what it can do with a lifetime supply of chocolate.",
 "color":"#3AA3E3",
 "attachment_type":"default",
 "callback_id":"select_simple_1234",
 "actions":[
             {"name":"winners_list",
 "text":"Who should take care of the alert?",
 "type":"select",
 "data_source":"users"
              }
            ]
        }
    ]
}
```

[このガイドラインに従い](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/sending-data-to-a-slack-channel.md) Slack の受け取りリクエストを設定します。

#### **Zoom にメッセージを投稿する**

メソッド: `POST`

リソース: `chat/webhooks/incomingwebhook/dSUcla-dQaGYgqGuBk3BsQ`.

上記の URL リソースは、Zoom 内で直接設定されたエンドポイント URL にのみ依存しているため、参考用です。

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

```
[
{
"text":"input message",
"img":["file1","file2"]
}
] 
```

[このガイドラインに従い](/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/posting-a-message-in-zoom.md) Zoom の受信リクエストを設定します。

### プロダクティビティツール <a href="#configuringwebhookfields-method-resource-andpayload-productivitytools" id="configuringwebhookfields-method-resource-andpayload-productivitytools"></a>

#### **特定のプロジェクトに Jira でバグを作成する**

メソッド: `POST`

リソース: `services/T01S01V0HB3/B02GY9BKZ7G/DIDFWXuCAeFfqkgNntQqJV7e`

ペイロード:

```
{
 "fields": {
 "project":
       {
 "key": "WHKBUG"
       },
 "summary": "User is experience bad audio quality call",
 "description": "Nexthink alert {{alert.monitor.name}} has been triggered",
 "issuetype": {
 "name": "Bug"
        },
 "priority":{
 "name": "{{alert.alert.priority}}"
        },      
 "timetracking":
        {
 "originalEstimate": "1d 2h",
 "remainingEstimate": "3h 25m"
        }
    }
}
```

### データプラットフォーム <a href="#configuringwebhookfields-method-resource-andpayload-dataplatforms" id="configuringwebhookfields-method-resource-andpayload-dataplatforms"></a>

#### **Splunk のイベントコレクターにイベントを送信する**

メソッド: `POST`

リソース: `services/collector?index=_main`

ペイロード:

```
{
 "event": "metric",
 "source": "metrics",
 "sourcetype":"perflog",
 "fields": {
 "event_name":"System crash",
 "event_label":"{{device_performance.system_crash.label}}",
 "event_error_code":"{{device_performance.system_crash.error_code}}",
 "event_time":"{{device_performance.system_crash.time}}",
 "region": "us-west-1",
 "datacenter": "dc2",
 "rack": "63",
 "os": "Ubuntu16.10",
 "arch": "x64",
 "team": "LON",
 "service": "6",
 "service_version": "0",
 "service_environment": "test",
 "path": "/dev/sda1",
 "fstype": "ext3"
  }
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.nexthink.com/platform/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/managing-webhooks/configuring-webhook-fields_-method-resource-and-payload.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.