---
sourceDocument: オーストラリアへの影響
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/impact

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリアへの影響

ft:clusterId :

    - ipact

bundleId :

    - ipact


---

# アラート統合のカスタムペイロード

# アラート統合のカスタムペイロード {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

Instance Observer 統合を使用すると、 ServiceNow およびサードパーティの統合用のカスタム JSON 要求ペイロードを定義および管理できます。
通知ペイロードに追加のフィールドを含めたり、ターゲットシステムで不要な特定のデータを除外したり、特定のサードパーティ API 要件や内部ビジネスロジックに合わせてペイロードをフォーマットしたりできるようになり、顧客側で複雑なスクリプト化された REST API を用意する必要がなくなります。

* デフォルトのペイロードを使用するか、必要に応じてカスタマイズして追加データを含めます。
* 必要に応じて、左側のエディターウィンドウに表示されるデフォルトのペイロードを変更します。
* 各パラメーターはキーと値で構成されているため、キーまたは値、またはその両方を変更します。
* 右側の \[プレビュー\] セクションには、レンダリング後に予想される JSON ペイロードが表示されます。
* JSON が無効な場合は、エラーが強調表示され、保存するオプションが無効になります。
{#custom-payload-help-guide-impact__ul_c33_xdz_bfc}

## デフォルトの口ひげペイロードテンプレート {#custom-payload-help-guide-impact__section_xvl_sfz_bfc}

    {
      "alert_number": "{{alert_number}}",
      "alert_type": "{{alert_type}}",
      "alert_name": "{{alert_name}}",
      "alert_time": "{{alert_time}}",
      "instance": "{{instance}}",
      "description": "{{description}}",
      "alert_created": "{{alert_created}}"
    }

## 例:デフォルトペイロード + カスタムパラメーター {#custom-payload-help-guide-impact__section_lnr_c3z_bfc}

    {
    "alert_number": "{{alert_number}}",
      "alert_type": "{{alert_type}}",
      "alert_name": "{{alert_name}}",
      "alert_time": "{{alert_time}}",
      "instance": "{{instance}}",
      "description": "{{description}}",
      "alert_created": "{{alert_created}}",
      "Custom_message": "{{alert_name}}' of type {{alert_type}} generated for {{instance}} at {{alert_time}}. Please review.",
      "Severity": "High"
    }

## カスタムパラメーターと制限 {#custom-payload-help-guide-impact__section_jky_hjz_bfc}

\[custom_parameter\] フィールドでは、JSON テンプレートにカスタムメッセージを挿入できます。また、カスタムパラメーターのサンプルに示すように、既存のパラメーターを使用することもできます。  
制限事項は次のとおりです。

* 必須:テンプレートを保存するための少なくとも 1 つ、最大で 20 のパラメーター。
* 最大:13 個のカスタムパラメーター。
* 超過すると、次の警告が表示されます。 テンプレートには、少なくとも 1 つのデフォルトキーと最大 20 個のキーが必要です。デフォルトを適用するには、\[デフォルトにリセット\] を調整または選択します。
{#custom-payload-help-guide-impact__ul_ln1_pjz_bfc}

## 構文リファレンスのカスタムパラメーターのサンプル {#custom-payload-help-guide-impact__section_yhl_slz_bfc}

"Information": "{{alert_time}}の{{instance}}に対してアラート{{alert_name}}がトリガーされました。説明:{{description}}"

"Alert_message": "{{alert_type}}タイプの新しいアラート「{{alert_name}}」が{{instance}}の{{instance}}に対して{{alert_time}}で生成されました。確認してください。(Resolution requires field is inconsistent with case priority. Please review.)」

"Event_type": "重大度 - 高! {{alert_name}} が {{instance}} に対して {{alert_time}} でトリガーされました。説明:{{description}}"

## サードパーティの要求本文マッピング {#custom-payload-help-guide-impact__section_cgb_1wm_cfc}

一部のサードパーティ統合では、特定のキー名が必要です。デフォルトのペイロードは、想定される形式に合わせて変更できます。  
例:サードパーティの要求本文:

    {
      "endTime": 1,
      "entitySelector": "string",
      "eventType": "AVAILABILITY_EVENT",
      "properties": {},
      "startTime": 1,
      "timeout": 1,
      "title": "string"
    }

## サードパーティの形式に合わせて変更された IO ペイロード {#custom-payload-help-guide-impact__section_gzv_xvm_cfc}

## アクションと検証 {#custom-payload-help-guide-impact__section_wsz_xmz_bfc}

変更を元に戻す
:   最後に保存されたコンテンツを復元します。

デフォルト値にリセット
:   テンプレートをデフォルトのペイロードにリセットします。

シンタックスバリデーター
:   保存する前に JSON の有効性を確認します。エラーにより保存できません。

テスト統合
:   Webhook 統合を検証するためのサンプル通知を送信します。