Classic/VPC 환경에서 이용 가능합니다.
챗봇 답변의 응답 컴포넌트 중 Basic 컴포넌트에 대해 설명합니다.
Basic 컴포넌트는 다음 3가지 기본 컴포넌트로 구성됩니다.
- Text
- Image
- Button (Button 컴포넌트는 Quick Buttons 컴포넌트를 포함합니다.)
위 컴포넌트는 각 특징에 맞게 챗봇의 응답을 챗봇 빌더에서 설정할 수 있으며, 챗봇 빌더를 통해 설정한 응답 결과를 JSON 형태로 반환합니다.
Text 컴포넌트
Text 컴포넌트는 제목(Title), 하위 제목(Sub Title), 설명(Description)과 URL으로 구성됩니다.
Text 컴포넌트 응답 바디
Text 컴포넌트의 응답 바디는 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
type |
String | Required | 컴포넌트 유형
|
title |
String | Optional | 컴포넌트 제목
|
subTitle |
String | Optional | 하위 컴포넌트 제목
|
data |
Object | Optional | 텍스트(Text) 컴포넌트 구성 정보 |
data.description |
String | Optional | 컴포넌트 상세 설명
|
data.url |
String | Optional | 컴포넌트 하이퍼링크 URL
|
data.urlAlias |
String | Optional | 컴포넌트 하이퍼링크 URL 별칭
|
data.action |
Action | Optional | 컴포넌트 액션(Action) 정보
|
Text 컴포넌트 응답 예시
Text 컴포넌트의 응답 예시는 다음과 같습니다.
{
"type": "text",
"title": "optional, short bold text",
"subTitle": "optional, short gray text",
"data" :
{
"description" : "optional, a long text content",
"url" : "optional, a hyperlink at the bottom of description",
"urlAlias" :"optional, hyperlink show this alias",
"action": {Action Data}
}
}
Image 컴포넌트
Image 컴포넌트는 이미지와 함께 제목(Title), 하위 제목(Sub Title), 설명(Description), URL로 구성됩니다.
Image 컴포넌트 응답 바디
Image 컴포넌트의 응답 바디는 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
type |
String | Required | 컴포넌트 유형
|
title |
String | Optional | 컴포넌트 제목
|
subTitle |
String | Optional | 하위 컴포넌트 제목
|
data |
Object | Optional | 이미지(Image) 컴포넌트 구성 정보 |
data.imageUrl |
String | Required | 이미지 URL
|
data.alt |
String | Optional | 이미지 설명 툴팁
|
data.imagePosition |
String | Optional | 이미지 위치
|
data.description |
String | Optional | 이미지 상세 설명 |
data.url |
String | Optional | 이미지 하이퍼링크 URL
|
data.urlAlias |
String | Optional | 이미지 하이퍼링크 URL 별칭
|
data.action |
Action | Optional | 컴포넌트 액션(Action) 정보
|
Image 컴포넌트 응답 예시
Image 컴포넌트의 응답 예시는 다음과 같습니다.
{
"type": "image",
"title": "optional, short bold text",
"subTitle": "optional, short gray text",
"data" :
{
"imageUrl" : "https://ssl.pstatic.net/CloudFunctions.png",
"alt" : "optional, short hint show when hover on image",
"imagePosition" : "top",
"description" : "optional, details info of image",
"url" : "optional, a hyperlink at the bottom of description",
"urlAlias" : "optional, hyperlink show this alias",
"action": {Action Data}
}
}
Button 컴포넌트
Button 컴포넌트는 이미지와 함께 제목(Title), 하위 제목(Sub Title), 설명(Description), URL로 버튼(Button)을 구성합니다. Quick Button 컴포넌트도 Button 컴포넌트에 포함됩니다.
Button 컴포넌트 응답 바디
Button 컴포넌트의 응답 바디는 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
type |
String | Required | 컴포넌트 유형
|
title |
String | Optional | 컴포넌트 제목
|
subTitle |
String | Optional | 하위 컴포넌트 제목
|
data |
String | Required | 버튼(Button) 컴포넌트 구성 정보 |
data.type |
String | Required | 버튼 종류
|
data.iconUrl |
String | Optional | 버튼 아이콘 URL
|
data.action |
Action | Optional | 컴포넌트 액션(Action) 정보
|
Button 컴포넌트 응답 예시
Button 컴포넌트의 응답 예시는 다음과 같습니다.
Basic Button
Basic Button의 응답 예시는 다음과 같습니다.
{
"type": "button",
"title": "optional, text show on button",
"subTitle": "optional, short gray text",
"data" :
{
"type": "basic",
"iconUrl" : "https://ssl.pstatic.net/CloudFunctions.png",
"action": {Action Data}
}
}
Image Button
Image Button의 응답 예시는 다음과 같습니다.
{
"type": "button",
"title": "optional, text show on button",
"subTitle": "optional, short gray text",
"data" :
{
"type": "imageButton",
"iconUrl" : "https://ssl.pstatic.net/CloudFunctions.png",
"action": {Action Data}
}
}
Quick Buttons 컴포넌트
Quick Buttons 컴포넌트에 대해 설명합니다. 채팅창 하단에 있는 그룹 고정 버튼입니다. button 컴포넌트에 포함됩니다.
Quick Buttons 응답 바디
Quick Buttons의 응답 바디는 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
type |
String | Required | 컴포넌트 유형
|
title |
String | Optional | 컴포넌트 이름 |
data |
Object | Optional | 컴포넌트 구성 정보 |
data.type |
String | Conditional | 컴포넌트 유형
|
data.action |
Object | Conditional | 컴포넌트 액션(Action) 정보 |
data.action.type |
String | Conditional | 컴포넌트 액션 유형
|
data.action.data |
Object | Conditional | 컴포넌트 액션(Action) 상세 정보
|
data.action.data.postback |
String | Conditional | 챗봇에 포스트백한 텍스트 |
data.action.data.displayText |
String | Conditional | 챗봇에 표시될 퀵버튼(Quick Button) 이름 |
data.action.data.postbackFull |
String | Conditional | 퀵버튼 실행을 위해 챗봇에 포스트백한 텍스트 |
Quick Buttons 응답 예시
Quick Buttons의 응답 예시는 다음과 같습니다.
{
"quickButtons": [
{
"type": "button",
"title": "Button Name",
"data": {
"type": "basic",
"action": {
"type": "postback",
"data": {
"postback": "UnexpiredForm\u241e47954\u241e0",
"displayText": "Button Name",
"postbackFull": "_T_UnexpiredForm\u241e47954\u241e0"
}
}
}
}
]
}