---
title: "Action"
slug: "ai-application-service-chatbot-action"
updated: 2026-09-17T09:15:53Z
published: 2026-09-17T09:15:53Z
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/ai-application-service-chatbot-action#Postback%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Utterance](/docs/ai-application-service-chatbot-action#Utterance%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Link](/docs/ai-application-service-chatbot-action#Link%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Phone](/docs/ai-application-service-chatbot-action#Phone%EC%BB%B4%ED%8F%AC%EB%84%8C%ED%8A%B8)
- [Welcome](/docs/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 | - | 발화 아이디 |
| `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" 
    } 
}
```