Action Objects

사용자가 메시지나 메뉴 내의 버튼 등을 누를 때 실행되는 액션을 정의한다.

액션 목록 {#actions}

액션은 다음과 같다.

  • Postback action
  • Message action
  • URI action
  • Camera action
  • Camera roll action
  • Location action
  • Copy action

액션별로 사용 가능한 위치가 제한된다.

액션 유형사용 가능한 위치
Postback actionCarousel
Image Carousel
Quick Reply
Rich Menu
Message actionButton Template
List Template
Carousel
Image Carousel
Quick Reply
Persistent Menu
Rich Menu
URI actionButton Template
List Template
Carousel
Image Carousel
Quick Reply
Persistent Menu
Rich Menu
Camera actionQuick Reply
Camera roll actionQuick Reply
Location actionQuick Reply
Copy actionButton Template
List Template
Carousel
Image Carousel
Quick Reply
Persistent Menu
Rich Menu

Postback Action {#postback}

이 액션과 관련된 항목을 누르면 data 파라미터에 지정된 문자열이 포함된 Postback Event가 Callback으로 반환된다.

참고

  • 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.

common {#postback-common}

파라미터타입필수 여부설명
typestringY"postback"으로 고정
labelstring설명 확인항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
datastringYpostback.data 속성의 callback을 통해 반환되는 문자열
최대 글자수: 300자
displayTextstring설명 확인사용자가 보낸 메시지로 채팅에 표시되는 텍스트. 입력하지 않으면 텍스트가 표시되지 않는다.
단, Quick Reply에서는 필숫값이다.
최대 글자수: 300자

multi language {#postback-multilang}

파라미터타입필수 여부설명
i18nLabelsarrayN다국어 레이블 목록
i18nLabels[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nLabels[].labelstringY항목에 표시되는 레이블.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
i18nDisplayTextsarrayN다국어 디스플레이 텍스트 목록
i18nDisplayTexts[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nDisplayTexts[].displayTextstringY사용자가 보낸 메시지로 채팅에 표시되는 텍스트
최대 글자수: 300자

Request Example {#postback-example}

{  "type": "postback",  "label": "Buy",  "data": "action=buy&itemid=111",  "displayText": "Buy"

Message Action {#message}

이 액션과 관련된 항목을 누르면 text 속성의 문자열이 메시지로 전송되고 Message Event가 Callback으로 전송된다.

참고

  • 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.

common {#message-common}

파라미터타입필수 여부설명
typestringY"message"로 고정
labelstring설명 확인항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴(persistent menu) 최대 글자수: 1000자
textstring설명 확인항목을 누를 때 전송되는 텍스트. 캐러셀, 이미지 캐러셀, 리치 메뉴, Quick Reply에서 필숫값으로 사용되며, 버튼 템플릿, 리스트 템플릿, 고정 메뉴에서는 label값으로 대체된다.
최대 글자수: 300자
postbackstringNmessage.postback 속성으로 반환되는 문자열
최대 글자수: 1000자

multi language {#message-multilang}

파라미터타입필수 여부설명
i18nLabelsarrayN다국어 레이블 목록
i18nLabels[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nLabels[].labelstringY항목에 표시되는 레이블.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자
i18nTextsarrayN다국어 텍스트 목록
i18nTexts[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nTexts[].textstringY항목을 누를 때 전송되는 텍스트. 캐러셀, 이미지 캐러셀, 리치 메뉴, Quick Reply에서 필숫값으로 사용되며, 버튼 템플릿, 리스트 템플릿, 고정 메뉴에서는 label값으로 대체된다.
최대 글자수: 300자

Request Example {#message-example}

{  "type": "message",  "label": "Yes",  "text": "Yes"}

URI Action {#uri}

이 액션과 관련된 항목을 누르면 uri 속성에 지정된 URI가 열린다.

참고

  • 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.

common {#uri-common}

파라미터타입필수 여부설명
typestringY"uri"로 고정
labelstring설명 확인항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자
uristringY항목을 누를 때 URI가 열린다. 'http', 'https' 스키마를 지원한다.
최대 글자수: 1000자

multi language {#uri-multilang}

파라미터타입필수 여부설명
i18nLabelsarrayN다국어 레이블 목록
i18nLabels[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nLabels[].labelstringY항목에 표시되는 레이블.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자

Request Example {#uri-example}

{  "type": "uri",  "label": "View details",  "uri": "http://example.com"}

Camera Action {#camera}

이 액션이 지정된 버튼을 누르면 카메라 화면이 열린다.

참고

  • 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
  • 모바일 버전에서만 사용할 수 있다.

common {#camera-common}

파라미터타입필수 여부설명
typestringY"camera"로 고정
labelstringY버튼의 레이블
최대 글자수: 20자

multi language {#camera-multilang}

파라미터타입필수 여부설명
i18nLabelsarrayN다국어 레이블 목록
i18nLabels[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nLabels[].labelstringY항목에 표시되는 레이블.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자

Request Example {#camera-example}

{  "type": "camera",  "label": "Camera"}

Camera Roll Action {#cameraroll}

이 액션이 지정된 버튼을 누르면 카메라 롤 화면이 열린다.

참고

  • 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
  • 모바일 버전에서만 사용할 수 있다.

common {#cameraroll-common}

파라미터타입필수 여부설명
typestringY"cameraRoll"로 고정
labelstringY버튼의 레이블
최대 글자수: 20자

multi language {#cameraroll-multilang}

파라미터타입필수 여부설명
i18nLabelsarrayN다국어 레이블 목록
i18nLabels[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nLabels[].labelstringY항목에 표시되는 레이블.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자

Request Example {#cameraroll-example}

{  "type": "cameraRoll",  "label": "Camera roll"}

Location Action {#location}

이 액션이 지정된 버튼을 누르면 위치 정보 화면이 열린다.

참고

  • 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
  • 모바일 버전에서만 사용할 수 있다.

common {#location-common}

파라미터타입필수 여부설명
typestringY"location"으로 고정
labelstringY버튼의 레이블
최대 글자수: 20자

multi language {#location-multilang}

파라미터타입필수 여부설명
i18nLabelsarrayN다국어 레이블 목록
i18nLabels[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nLabels[].labelstringY항목에 표시되는 레이블.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자

Request Example {#location-example}

{  "type": "location",  "label": "Location"}

Copy Action {#copy}

이 액션이 지정된 버튼을 누르면 copyText 파라미터에 지정된 텍스트가 클립보드에 복사된다.

참고

  • 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다. 주의
  • 이 액션은 v3.6부터 지원된다.

common {#copy-common}

파라미터타입필수 여부설명
typestringY"copy"로 고정
labelstring설명 확인항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자
copyTextstringY항목을 누를 때 클립보드로 복사된다.
최대 글자수: 1000자

multi language {#copy-multilang}

파라미터타입필수 여부설명
i18nLabelsarrayN다국어 레이블 목록
i18nLabels[].languagestringY다국어 언어 코드
• ko_KR • ja_JP • zh_CN • zh_TW • en_US
i18nLabels[].labelstringY항목에 표시되는 레이블.
• 기본 최대 글자수: 20자
• 이미지 캐러셀 최대 글자수: 12자
• 고정 메뉴 최대 글자수: 1000자

Request Example {#copy-example}

{"type": "copy","label": "Copy This","copyText": "This is a copied text."}