Basic
    • PDF

    Basic

    • PDF

    기사 요약

    Classic/VPC 환경에서 이용 가능합니다.

    챗봇 답변의 응답 컴포넌트 중 Basic 컴포넌트에 대해 설명합니다.

    Basic 컴포넌트는 다음 3가지 기본 컴포넌트로 구성됩니다.

    위 컴포넌트는 각 특징에 맞게 챗봇의 응답을 챗봇 빌더에서 설정할 수 있으며, 챗봇 빌더를 통해 설정한 응답 결과를 JSON 형태로 반환합니다.

    Text 컴포넌트

    Text 컴포넌트는 제목(Title), 하위 제목(Sub Title), 설명(Description)과 URL으로 구성됩니다.

    Text 컴포넌트 응답 바디

    Text 컴포넌트의 응답 바디는 다음과 같습니다.

    필드타입필수 여부설명
    typeStringRequired컴포넌트 유형
    • Text 컴포넌트일 경우 3가지 기본 컴포넌트 중 text만 사용 가능
    titleStringOptional컴포넌트 제목
    • 단문의 굵은 텍스트 (Short bold text)
    subTitleStringOptional하위 컴포넌트 제목
    • 단문의 회색 텍스트 (Short gray text)
    dataObjectOptional텍스트(Text) 컴포넌트 구성 정보
    data.descriptionStringOptional컴포넌트 상세 설명
    • 장문의 텍스트
    data.urlStringOptional컴포넌트 하이퍼링크 URL
    • <예시> ncloud.com
    data.urlAliasStringOptional컴포넌트 하이퍼링크 URL 별칭
    • 하이퍼링크가 보여지는 텍스트
      • <예시> 네이버 클라우드
    data.actionActionOptional컴포넌트 액션(Action) 정보
    • 각 액션마다 세부 내용이 상이하므로 자세한 설명은 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 컴포넌트의 응답 바디는 다음과 같습니다.

    필드타입필수 여부설명
    typeStringRequired컴포넌트 유형
    • Image 컴포넌트일 경우 3가지 기본 컴포넌트 중 image만 사용 가능
    titleStringOptional컴포넌트 제목
    • 단문의 굵은 텍스트 (Short bold text)
    subTitleStringOptional하위 컴포넌트 제목
    • 단문의 회색 텍스트 (Short gray text)
    dataObjectOptional이미지(Image) 컴포넌트 구성 정보
    data.imageUrlStringRequired이미지 URL
    • 반드시 https 형식의 URL이어야 함
    data.altStringOptional이미지 설명 툴팁
    • 이미지에 마우스를 올렸을 때 표시되는 짧은 힌트
    data.imagePositionStringOptional이미지 위치
    • top (기본값) | bottom | left | right
      • top: 가장 위쪽
      • bottom: 가장 아래쪽
      • left: 가장 왼쪽
      • right: 가장 오른쪽
    data.descriptionStringOptional이미지 상세 설명
    data.urlStringOptional이미지 하이퍼링크 URL
    • description의 아래쪽에 위치
    • <예시> ncloud.com
    data.urlAliasStringOptional이미지 하이퍼링크 URL 별칭
    • 하이퍼링크가 보여지는 텍스트
      • <예시> 네이버 클라우드
    data.actionActionOptional컴포넌트 액션(Action) 정보
    • 각 액션마다 세부 내용이 상이하므로 자세한 설명은 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 컴포넌트의 응답 바디는 다음과 같습니다.

    필드타입필수 여부설명
    typeStringRequired컴포넌트 유형
    • Button 컴포넌트일 경우 3가지 기본 컴포넌트 중 button만 사용 가능
    titleStringOptional컴포넌트 제목
    • 버튼에 보여지는 단문의 굵은 텍스트 (Short bold text)
    subTitleStringOptional하위 컴포넌트 제목
    • 단문의 회색 텍스트 (Short gray text)
    dataStringRequired버튼(Button) 컴포넌트 구성 정보
    data.typeStringRequired버튼 종류
    • basic | imageButton
      • basic: 기본 버튼
      • imageButton: 이미지로 구성된 버튼
    data.iconUrlStringOptional버튼 아이콘 URL
    • 반드시 https 형식의 URL이어야 함
    data.actionActionOptional컴포넌트 액션(Action) 정보
    • 각 액션마다 세부 내용이 상이하므로 자세한 설명은 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의 응답 바디는 다음과 같습니다.

    필드타입필수 여부설명
    typeStringRequired컴포넌트 유형
    • Button 컴포넌트일 경우 3가지 기본 컴포넌트 중 button만 사용 가능
    titleStringOptional컴포넌트 이름
    dataObjectOptional컴포넌트 구성 정보
    data.typeStringConditional컴포넌트 유형
    data.actionObjectConditional컴포넌트 액션(Action) 정보
    data.action.typeStringConditional컴포넌트 액션 유형
    data.action.dataObjectConditional컴포넌트 액션(Action) 상세 정보
    • 각 액션마다 세부 내용이 상이하므로 자세한 설명은 Action 컴포넌트 참조
    data.action.data.postbackStringConditional챗봇에 포스트백한 텍스트
    data.action.data.displayTextStringConditional챗봇에 표시될 퀵버튼(Quick Button) 이름
    data.action.data.postbackFullStringConditional퀵버튼 실행을 위해 챗봇에 포스트백한 텍스트

    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" 
              }
            }
          }
        }
      ]
    }
    

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.