Action
    • PDF

    Action

    • PDF

    기사 요약

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

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

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

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

    Postback 컴포넌트

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

    Postback 컴포넌트 응답 바디

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

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

    Postback 컴포넌트 응답 예시

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

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

    Utterance 컴포넌트

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

    Utterance 컴포넌트 응답 바디

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

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

    Utterance 컴포넌트 응답 예시

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

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

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

    Link 컴포넌트 응답 바디

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

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

    Link 컴포넌트 응답 예시

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

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

    Phone 컴포넌트

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

    참고

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

    Phone 컴포넌트 응답 바디

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

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

    Phone 컴포넌트 응답 예시

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

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

    Welcome 컴포넌트

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

    Welcome 컴포넌트 응답 바디

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

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

    Welcome 컴포넌트 응답 예시

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

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

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

    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.