- 인쇄
- PDF
Basic
- 인쇄
- PDF
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"
}
}
}
}
]
}