---
title: "Action"
slug: "ai-application-service-chatbot-action"
updated: 2026-09-17T09:35:51Z
published: 2026-09-17T09:35:51Z
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

Available in Classic and VPC

This document describes the actions in the response component of a chatbot answer. Actions are common data for all components that define what to do when a component is clicked.

An action consists of the following five basic components.

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

These components allow you to set the chatbot's response to each feature in Chatbot Builder, and return the response results in JSON format.

## Postback component

The Postback component posts text (`postbackText`) to the chatbot and displays the postback text as the user's chat.

### Postback component response body

The following is the response body of the Postback component.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | String | - | Component type - Only `postback` is available for the Postback component |
| `data` | Object | - | Postback component configuration information |
| `data.postback` | String | - | Text displayed in user chat - Sending to chatbot does not impact existing features, but may not support some new features |
| `data.postbackFull` | String | - | Entire postback text to send to the chatbot |

### Postback component response example

The following is a sample response of the Postback component.

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

## Utterance component

The Utterance component posts back text (`postbackText`) to the chatbot and displays the utterance text as the user's chat.

### Utterance component response body

The following is the response body of the Utterance component.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | String | - | Component type - Only `utterance` is available for the Utterance component |
| `data` | Object | - | Utterance component configuration information |
| `data.utteranceId` | Integer | - | Utterance ID |
| `data.text` | String | - | Text that appears as user input in the chat |
| `data.postback` | String | - | Postback text to send to the chatbot |

### Utterance component response example

The following is a sample response of the Utterance component.

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

## Link component

The Link component navigates to its URL when the component is clicked.

### Link component response body

The following is the response body of the Link component.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | String | - | Component type - Only `link` is available for the Link component |
| `data` | Object | - | Link component configuration information |
| `data.url` | String | - | URL address |
| `data.mobileUrl` | String | - | Mobile URL address |

### Link component response example

The following is a sample response of the Link component.

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

## Phone component

The Phone component takes you to the dial page when you click the component.

Note

The Phone component is only supported in mobile environments.

### Phone component response body

The following is the response body of the Phone component.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | String | - | Component type - Only `phone` is available for the Phone component |
| `data` | Object | - | Phone component configuration information |
| `data.number` | String | - | Phone number |
| `data.name` | String | - | Name registered in contacts |

### Phone component response example

The following is a sample response of the Phone component.

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

## Welcome component

The Welcome component sends an open event when the component is clicked.

### Welcome component response body

The following is the response body of the Welcome component.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | String | - | Component type - Only `welcome` is available for the Welcome component |
| `data` | Object | - | Welcome component configuration information |
| `data.postback` | String | - | Postback text sent to the chatbot from the open event |

### Welcome component response example

The following is a sample response of the Welcome component.

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