- 인쇄
- PDF
Action
- 인쇄
- PDF
Classic/VPC 환경에서 이용 가능합니다.
챗봇 답변의 응답 컴포넌트 중 액션(Action)에 대해 설명합니다. 액션은 모든 컴포넌트(구성 요소)에 대한 공통 데이터로, 컴포넌트를 클릭했을 때 수행할 작업을 정의합니다.
액션(Action)은 다음 5가지 기본 컴포넌트로 구성됩니다.
위 컴포넌트는 각 특징에 맞게 챗봇의 응답을 챗봇 빌더에서 설정할 수 있으며, 챗봇 빌더를 통해 설정한 응답 결과를 JSON 형태로 반환합니다.
Postback 컴포넌트
Postback 컴포넌트는 텍스트(postbackText
)를 챗봇에 포스트백하고, 포스트백 텍스트를 사용자의 채팅으로 표시합니다.
Postback 컴포넌트 응답 바디
Postback 컴포넌트의 응답 바디는 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
type | String | Required | 컴포넌트 유형
|
data | Object | Required | 포스트백 컴포넌트 구성 정보 |
data.postback | String | Required | 사용자 채팅에 표시되는 텍스트
|
data.postbackFull | String | Required | 챗봇으로 보낼 전체 포스트백 텍스트 |
Postback 컴포넌트 응답 예시
Postback 컴포넌트의 응답 예시는 다음과 같습니다.
{
"action":
{
"type": "postback",
"data":
{
"postback": "Button Name",
"postbackFull": "_T_Button Name"
}
}
}
Utterance 컴포넌트
Utterance 컴포넌트는 텍스트(postbackText
)를 챗봇에 포스트백하고, 발화 텍스트를 사용자의 채팅으로 표시합니다.
Utterance 컴포넌트 응답 바디
Utterance 컴포넌트의 응답 바디는 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
type | String | Required | 컴포넌트 유형
|
data | Object | Required | 발화(Utterance) 컴포넌트 구성 정보 |
data.utteranceId | Integer | Required | 발화 아이디 |
data.text | String | Required | 채팅창에 사용자의 입력으로 표시되는 텍스트 |
data.postback | String | Required | 챗봇으로 보낼 포스트백 텍스트 |
Utterance 컴포넌트 응답 예시
Utterance 컴포넌트의 응답 예시는 다음과 같습니다.
{
"type": "utterance",
"data" :
{
"utteranceId" : 1,
"text" : "text show in chat window",
"postback" : "postback text"
}
}
Link 컴포넌트
Link 컴포넌트는 컴포넌트 클릭 시 해당 URL로 이동합니다.
Link 컴포넌트 응답 바디
Link 컴포넌트의 응답 바디는 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
type | String | Required | 컴포넌트 유형
|
data | Object | Required | 링크(Link) 컴포넌트 구성 정보 |
data.url | String | Required | URL 주소 |
data.mobileUrl | String | Required | 모바일 URL 주소 |
Link 컴포넌트 응답 예시
Link 컴포넌트의 응답 예시는 다음과 같습니다.
{
"type": "link",
"data" :
{
"url" : "http://www.ncloud.com",
"mobileUrl" : "http://m.ncloud.com"
}
}
Phone 컴포넌트
Phone 컴포넌트는 컴포넌트 클릭 시 다이얼 페이지로 이동합니다.
Phone 컴포넌트는 모바일 환경에서만 지원합니다.
Phone 컴포넌트 응답 바디
Phone 컴포넌트의 응답 바디는 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
type | String | Required | 컴포넌트 유형
|
data | Object | Required | 전화(Phone) 컴포넌트 구성 정보 |
data.number | String | Required | 전화번호 |
data.name | String | Optional | 전화번호부에 등록된 이름 |
Phone 컴포넌트 응답 예시
Phone 컴포넌트의 응답 예시는 다음과 같습니다.
{
"type": "phone",
"data" :
{
"number" : "400-1111-1111",
"name" : "Customer service"
}
}
Welcome 컴포넌트
Welcome 컴포넌트는 컴포넌트 클릭 시 열린 이벤트(Open Event)를 전송합니다.
Welcome 컴포넌트 응답 바디
Welcome 컴포넌트의 응답 바디는 다음과 같습니다.
필드 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
type | String | Required | 컴포넌트 유형
|
data | Object | Required | 웰컴(Welcome) 컴포넌트 구성 정보 |
data.postback | String | Required | 열린 이벤트(Open Event)에서 챗봇으로 전송된 포스트백 텍스트 |
Welcome 컴포넌트 응답 예시
Welcome 컴포넌트의 응답 예시는 다음과 같습니다.
{
"type": "welcome",
"data" :
{
"postback" : "postback text, optional"
}
}