Basic

Prev Next

Available in Classic and VPC

This document describes the Basic component of the response components of a chatbot answer.

The Basic component consists of the following three basic components.

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

Text component

The Text component consists of the title, subtitle, description, and URL.

Text component response body

The following is the response body of the Text component.

Field Type Required Description
type String - Component type
  • Only text is available among the 3 basic components for the Text component
title String - Component title
  • Short bold text
subTitle String - Subcomponent title
  • Short gray text
data Object - Text component configuration information
data.description String - Component detailed descriptions
  • Long text
data.url String - Component hyperlink URL
  • <e.g.> ncloud.com
data.urlAlias String - Component hyperlink URL alias
  • Text where the hyperlink appears
    • <e.g.> NAVER Cloud
data.action Action - Component action information

Text component response example

The following is a sample response of the Text component.

{ 
    "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 component

The Image component consists of an image, along with title, subtitle, description, and URL.

Image component response body

The following is the response body of the Image component.

Field Type Required Description
type String - Component type
  • Only image is available among the 3 basic components for the Image component
title String - Component title
  • Short bold text
subTitle String - Subcomponent title
  • Short gray text
data Object - Image component configuration information
data.imageUrl String - Image URL
  • Must be a URL of https format
data.alt String - Image description tooltip
  • Short hints when hovering over an image
data.imagePosition String - Image position
  • top (default) | bottom | left | right
    • top: topmost
    • bottom: bottommost
    • left: leftmost
    • right: rightmost
data.description String - Image detailed description
data.url String - Image hyperlink URL
  • Placed at the bottom of description
  • <e.g.> ncloud.com
data.urlAlias String - Image hyperlink URL alias
  • Text where the hyperlink appears
    • <e.g.> NAVER Cloud
data.action Action - Component action information

Image component response example

The following is a sample response of the Image component.

{
    "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 component

The Button component consists of a button with title, subtitle, description, and URL along with an image. The Quick Buttons component is also included in the Button component.

Button component response body

The following is the response body of the Button component.

Field Type Required Description
type String - Component type
  • Only button is available among the 3 basic components for the Button component
title String - Component title
  • Short bold text displayed on the button
subTitle String - Subcomponent title
  • Short gray text
data String - Button component configuration information
data.type String - Button type
  • basic | imageButton
    • basic: basic button
    • imageButton: button configured with an image
data.iconUrl String - Button icon URL
  • Must be a URL of https format
data.action Action - Component action information

Button component response example

The following is a sample response of the Button component.

Basic Button

The following is a sample response of 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

The following is a sample response of 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 component

This section describes the Quick Buttons component. This is the pinned group button at the bottom of the chat window. It is included in the button component.

Quick Buttons response body

The following is the response body of Quick Buttons.

Field Type Required Description
type String - Component type
  • Only button is available among the 3 basic components for the Button component
title String - Component name
data Object - Component configuration information
data.type String - Component type
data.action Object - Component action information
data.action.type String - Component action type
data.action.data Object - Component action details
data.action.data.postback String - Text postbacked to the chatbot
data.action.data.displayText String - Quick Button name to be displayed on the chatbot
data.action.data.postbackFull String - Text postbacked to the chatbot for Quick Button execution

Quick Buttons response example

The following is a sample response of 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" 
          }
        }
      }
    }
  ]
}