---
title: "Action"
slug: "ai-application-service-chatbot-action"
updated: 2026-09-17T09:57:17Z
published: 2026-09-17T09:57:17Z
canonical: "api.ncloud-docs.com/ai-application-service-chatbot-action"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Action

Classic/VPC環境で利用できます。

チャットボット返答のレスポンスコンポーネントのうち、アクション(Action)について説明します。アクションはすべてのコンポーネント(構成要素)の共通データで、コンポーネントをクリックすると実行する作業を定義します。

アクション(Action)は、次の5つの基本コンポーネントで構成されます。

- [Postback](/docs/ja/ai-application-service-chatbot-action#Postback%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Utterance](/docs/ja/ai-application-service-chatbot-action#Utterance%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Link](/docs/ja/ai-application-service-chatbot-action#Link%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Phone](/docs/ja/ai-application-service-chatbot-action#Phone%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Welcome](/docs/ja/ai-application-service-chatbot-action#Welcome%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)

上記のコンポーネントはそれぞれの特徴に合わせてチャットボットのレスポンスをチャットボットビルダで設定することができ、チャットボットビルダで設定したレスポンス結果を JSON形式で返します。

## Postbackコンポーネント

Postbackコンポーネントはテキスト(`postbackText`)をチャットボットにポストバックし、ポストバックテキストをユーザーのチャットに表示します。

### Postbackコンポーネントのレスポンスボディ

Postbackコンポーネントのレスポンスボディは次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `type` | String | - | コンポーネントのタイプ - Postbackコンポーネントの場合、`postback`のみ使用可能 |
| `data` | Object | - | ポストバックコンポーネントの構成情報 |
| `data.postback` | String | - | ユーザーのチャットに表示されるテキスト - チャットボットに送信時、既存の機能には影響しないが、一部の新機能をサポートしない場合がある |
| `data.postbackFull` | String | - | チャットボットに送る全ポストバックテキスト |

### Postbackコンポーネントのレスポンス例

Postbackコンポーネントのレスポンスのサンプルコードは次の通りです。

```
{
    "action": 
    {
        "type": "postback",
        "data": 
        {
            "postback": "Button Name",
            "postbackFull": "_T_Button Name" 
         }
    }
}
```

## Utteranceコンポーネント

Utteranceコンポーネントはテキスト(`postbackText`)をチャットボットにポストバックし、発話テキストをユーザーのチャットに表示します。

### Utteranceコンポーネントのレスポンスボディ

Utteranceコンポーネントのレスポンスボディは次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `type` | String | - | コンポーネントのタイプ - Utteranceコンポーネントの場合、`utterance`のみ使用可能 |
| `data` | Object | - | 発話(Utterance)コンポーネントの構成情報 |
| `data.utteranceId` | Integer | - | 発話 ID |
| `data.text` | String | - | ユーザーの入力によりチャット画面に表示されるテキスト |
| `data.postback` | String | - | チャットボットに送るポストバックテキスト |

### Utteranceコンポーネントのレスポンス例

Utteranceコンポーネントのレスポンスのサンプルコードは次の通りです。

```
{
    "type": "utterance",
    "data" : 
    {
        "utteranceId" : 1,
        "text" : "text show in chat window",
        "postback" : "postback text"
    }
}
```

## Linkコンポーネント

Linkコンポーネントは、コンポーネントをクリックするとその URLに移動します。

### Linkコンポーネントのレスポンスボディ

Linkコンポーネントのレスポンスボディは次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `type` | String | - | コンポーネントのタイプ - Linkコンポーネントの場合、`link`のみ使用可能 |
| `data` | Object | - | リンク(Link)コンポーネントの構成情報 |
| `data.url` | String | - | URLアドレス |
| `data.mobileUrl` | String | - | モバイル URLアドレス |

### Linkコンポーネントのレスポンス例

Linkコンポーネントのレスポンスのサンプルコードは次の通りです。

```
{
    "type": "link",
    "data" : 
    {
        "url" : "http://www.ncloud.com",
        "mobileUrl" : "http://m.ncloud.com"
    }
}
```

## Phoneコンポーネント

Phoneコンポーネントは、コンポーネントをクリックするとダイヤルページに移動します。

参考

Phoneコンポーネントはモバイル環境でのみサポートします。

### Phoneコンポーネントのレスポンスボディ

Phoneコンポーネントのレスポンスボディは次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `type` | String | - | コンポーネントのタイプ - Phoneコンポーネントの場合、`phone`のみ使用可能 |
| `data` | Object | - | 電話(Phone)コンポーネントの構成情報 |
| `data.number` | String | - | 電話番号 |
| `data.name` | String | - | 電話帳に登録されている名前 |

### Phoneコンポーネントのレスポンス例

Phoneコンポーネントのレスポンスのサンプルコードは次の通りです。

```
{
    "type": "phone",
    "data" :   
    { 
        "number" : "400-1111-1111", 
        "name" : "Customer service" 
    }
}
```

## Welcomeコンポーネント

Welcomeコンポーネントは、コンポーネントをクリックするとオープンイベント(Open Event)を送信します。

### Welcomeコンポーネントのレスポンスボディ

Welcomeコンポーネントのレスポンスボディは次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `type` | String | - | コンポーネントのタイプ - Welcomeコンポーネントの場合、`welcome`のみ使用可能 |
| `data` | Object | - | ウェルカム(Welcome)コンポーネントの構成情報 |
| `data.postback` | String | - | オープンイベント(Open Event)からチャットボットに送信されたポストバックテキスト |

### Welcomeコンポーネントのレスポンス例

Welcomeコンポーネントのレスポンスのサンプルコードは次の通りです。

```
{ 
    "type": "welcome", 
    "data" : 
    { 
        "postback" : "postback text, optional" 
    } 
}
```