Action

Prev Next

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

챗봇 답변의 응답 컴포넌트 중 액션(Action)에 대해 설명합니다. 액션은 모든 컴포넌트(구성 요소)에 대한 공통 데이터로, 컴포넌트를 클릭했을 때 수행할 작업을 정의합니다.

액션(Action)은 다음 5가지 기본 컴포넌트로 구성됩니다.

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

Postback 컴포넌트

Postback 컴포넌트는 텍스트(postbackText)를 챗봇에 포스트백하고, 포스트백 텍스트를 사용자의 채팅으로 표시합니다.

Postback 컴포넌트 응답 바디

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

필드 타입 필수 여부 설명
type String - 컴포넌트 유형
  • Postback 컴포넌트일 경우 postback만 사용 가능
data Object - 포스트백 컴포넌트 구성 정보
data.postback String - 사용자 채팅에 표시되는 텍스트
  • 챗봇에 전송 시 기존 기능에는 영향이 없으나 일부 새로운 기능을 미지원할 수 있음
data.postbackFull String - 챗봇으로 보낼 전체 포스트백 텍스트

Postback 컴포넌트 응답 예시

Postback 컴포넌트의 응답 예시는 다음과 같습니다.

{
    "action": 
    {
        "type": "postback",
        "data": 
        {
            "postback": "Button Name",
            "postbackFull": "_T_Button Name" 
         }
    }
}

Utterance 컴포넌트

Utterance 컴포넌트는 텍스트(postbackText)를 챗봇에 포스트백하고, 발화 텍스트를 사용자의 채팅으로 표시합니다.

Utterance 컴포넌트 응답 바디

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

필드 타입 필수 여부 설명
type String - 컴포넌트 유형
  • Utterance 컴포넌트일 경우 utterance만 사용 가능
data Object - 발화(Utterance) 컴포넌트 구성 정보
data.utteranceId Integer - 발화 아이디
data.text String - 채팅창에 사용자의 입력으로 표시되는 텍스트
data.postback String - 챗봇으로 보낼 포스트백 텍스트

Utterance 컴포넌트 응답 예시

Utterance 컴포넌트의 응답 예시는 다음과 같습니다.

{
    "type": "utterance",
    "data" : 
    {
        "utteranceId" : 1,
        "text" : "text show in chat window",
        "postback" : "postback text"
    }
}

Link 컴포넌트

Link 컴포넌트는 컴포넌트 클릭 시 해당 URL로 이동합니다.

Link 컴포넌트 응답 바디

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

필드 타입 필수 여부 설명
type String - 컴포넌트 유형
  • Link 컴포넌트일 경우 link만 사용 가능
data Object - 링크(Link) 컴포넌트 구성 정보
data.url String - URL 주소
data.mobileUrl String - 모바일 URL 주소

Link 컴포넌트 응답 예시

Link 컴포넌트의 응답 예시는 다음과 같습니다.

{
    "type": "link",
    "data" : 
    {
        "url" : "http://www.ncloud.com",
        "mobileUrl" : "http://m.ncloud.com"
    }
}

Phone 컴포넌트

Phone 컴포넌트는 컴포넌트 클릭 시 다이얼 페이지로 이동합니다.

참고

Phone 컴포넌트는 모바일 환경에서만 지원합니다.

Phone 컴포넌트 응답 바디

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

필드 타입 필수 여부 설명
type String - 컴포넌트 유형
  • Phone 컴포넌트일 경우 phone만 사용 가능
data Object - 전화(Phone) 컴포넌트 구성 정보
data.number String - 전화번호
data.name String - 전화번호부에 등록된 이름

Phone 컴포넌트 응답 예시

Phone 컴포넌트의 응답 예시는 다음과 같습니다.

{
    "type": "phone",
    "data" :   
    { 
        "number" : "400-1111-1111", 
        "name" : "Customer service" 
    }
}

Welcome 컴포넌트

Welcome 컴포넌트는 컴포넌트 클릭 시 열린 이벤트(Open Event)를 전송합니다.

Welcome 컴포넌트 응답 바디

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

필드 타입 필수 여부 설명
type String - 컴포넌트 유형
  • Welcome 컴포넌트일 경우 welcome만 사용 가능
data Object - 웰컴(Welcome) 컴포넌트 구성 정보
data.postback String - 열린 이벤트(Open Event)에서 챗봇으로 전송된 포스트백 텍스트

Welcome 컴포넌트 응답 예시

Welcome 컴포넌트의 응답 예시는 다음과 같습니다.

{ 
    "type": "welcome", 
    "data" : 
    { 
        "postback" : "postback text, optional" 
    } 
}