すべてのプロダクト
Search
ドキュメントセンター

Chat App Message Service:HTTP リクエスト

最終更新日:Mar 07, 2026

このトピックでは、[HTTP リクエスト] コンポーネントの設定方法について説明します。このコンポーネントは、指定された URL に Hypertext Transfer Protocol (HTTP) リクエストを送信します。

コンポーネント情報

コンポーネントアイコン

コンポーネント名

HTTP请求@1x

HTTP リクエスト

前提条件

既存のフローのキャンバスページに移動するか、新しいフローを作成します。

  • 既存のフローのキャンバスページに移動します。

    Chat Flow > Flow Management タブで、編集したいフローの Flow Name をクリックして、フローのオーケストレーションページに移動します。

    image

  • 新しいフローを作成してキャンバスページに移動します。詳細については、「フローの作成」をご参照ください。

操作手順

  1. キャンバス上の [HTTP リクエスト] コンポーネントアイコンをクリックすると、右側にコンポーネント設定エリアが表示されます。

    image

  2. 必要に応じてコンポーネントを設定します。詳細については、「設定項目」をご参照ください。

  3. 設定後、Save をクリックします。表示されるダイアログボックスで、Save をクリックします。

    image

設定項目

設定項目

説明

Request Method

サポートされているメソッド:

  • POST

  • GET

image

Timeout

リクエストの応答タイムアウト期間を設定します。

URL

リクエストを受信する URL を設定します。

Content Type

リクエストメソッドとして POST を選択した場合、Content Type を設定します。サポートされているタイプ:

  • application/json

  • application/x-www-form-urlencoded

Failure Branch

リクエストが失敗した場合のフローを処理するには、失敗ブランチを開きます。

image

Request Header Configuration

次の情報を入力します:

  • キー

image

Request Body Configuration

リクエストメソッドが POST の場合、リクエストボディを設定します:

キーと値

  • キー

Raw:Raw 値を手動で入力します。

詳細については、「リクエストボディの設定例と説明」をご参照ください。

image

Request Path Configuration

リクエストメソッドが GET の場合、リクエストパスを設定します:

  • キー

image

Response Variable Configuration

変数名が応答内の JSON オブジェクトのキーと一致することを確認してください。

image

リクエストボディの設定例と説明

リクエストボディは、Key ValueOriginal Value の 2 つの設定方法をサポートしています。

  • Key Value:このメソッドは、単純なリクエストボディ構造に使用します。以下に例を示します:

    最初のキーと値のペアのキーを MyName に、値を haiwei.dhw に設定します。2 番目のキーと値のペアのキーを customerName に、値を {{customerName}} 変数に設定します。

    コンテンツタイプが application/json の場合、データ形式は `{"myName": "haiwei.dhw", "customerName": "{{customerName}}"}` です。コンテンツタイプが application/x-www-form-urlencoded の場合、データ形式は `"myName=haiwei.dhw&customerName={{customerName}}"` です。

    image

  • Original Value: 複雑なリクエスト構造の場合にこの方法を使用します。リクエストボディ全体を自由に編集できます。生のリクエストボディの値は、選択されたコンテンツタイプ(application/json または application/x-www-form-urlencoded)と一致している必要があります。

    application/json

    コンテンツタイプが application/json の場合、Raw リクエストボディの例を以下に示します:

    {
      "customerNames": [
        {
          "name": "{{customerName}}",
          "type": "vip",
          "intentional": true,
          "intentionLevel": 5
        }
      ],
      "myName": "haiwei.dhw",
      "someConplicatedStructure": {
        "a": {
          "b": "c"
        }
      }
    }

    image.png

    application/x-www-form-urlencoded

    コンテンツタイプが application/x-www-form-urlencoded の場合、Raw リクエストボディの例を以下に示します:

    customerNames[0][name]={{customerName}}&customerNames[0]
    [type]=vip&customerNames[0]
    [intentional]=true&customerNames[0]
    [intentionLevel]=5&myName=haiwei.dhw&someConplicatedStructure[a][b]=c

    image.png