Action

Prev Next

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

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

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

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

Postback 컴포넌트

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

Postback 컴포넌트 응답 바디

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

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

Postback 컴포넌트 응답 예시

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

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

Utterance 컴포넌트

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

Utterance 컴포넌트 응답 바디

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

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

Utterance 컴포넌트 응답 예시

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

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

Link 컴포넌트

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

Link 컴포넌트 응답 바디

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

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

Link 컴포넌트 응답 예시

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

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

Phone 컴포넌트

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

참고

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

Phone 컴포넌트 응답 바디

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

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

Phone 컴포넌트 응답 예시

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

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

Welcome 컴포넌트

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

Welcome 컴포넌트 응답 바디

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

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

Welcome 컴포넌트 응답 예시

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

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