사용자가 메시지나 메뉴 내의 버튼 등을 누를 때 실행되는 액션을 정의한다.
액션은 다음과 같다.
액션별로 사용 가능한 위치가 제한된다.
| 액션 유형 | 사용 가능한 위치 |
|---|---|
| Postback action | Carousel Image Carousel Quick Reply Rich Menu |
| Message action | Button Template List Template Carousel Image Carousel Quick Reply Persistent Menu Rich Menu |
| URI action | Button Template List Template Carousel Image Carousel Quick Reply Persistent Menu Rich Menu |
| Camera action | Quick Reply |
| Camera roll action | Quick Reply |
| Location action | Quick Reply |
| Copy action | Button Template List Template Carousel Image Carousel Quick Reply Persistent Menu Rich Menu |
이 액션과 관련된 항목을 누르면 data 파라미터에 지정된 문자열이 포함된 Postback Event가 Callback으로 반환된다.
참고
- 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| type | string | Y | "postback"으로 고정 |
| label | string | 설명 확인 | 항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 |
| data | string | Y | postback.data 속성의 callback을 통해 반환되는 문자열 최대 글자수: 300자 |
| displayText | string | 설명 확인 | 사용자가 보낸 메시지로 채팅에 표시되는 텍스트. 입력하지 않으면 텍스트가 표시되지 않는다. 단, Quick Reply에서는 필숫값이다. 최대 글자수: 300자 |
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| i18nLabels | array | N | 다국어 레이블 목록 |
| i18nLabels[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nLabels[].label | string | Y | 항목에 표시되는 레이블. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 |
| i18nDisplayTexts | array | N | 다국어 디스플레이 텍스트 목록 |
| i18nDisplayTexts[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nDisplayTexts[].displayText | string | Y | 사용자가 보낸 메시지로 채팅에 표시되는 텍스트 최대 글자수: 300자 |
{ "type": "postback", "label": "Buy", "data": "action=buy&itemid=111", "displayText": "Buy"이 액션과 관련된 항목을 누르면 text 속성의 문자열이 메시지로 전송되고 Message Event가 Callback으로 전송된다.
참고
- 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| type | string | Y | "message"로 고정 |
| label | string | 설명 확인 | 항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴(persistent menu) 최대 글자수: 1000자 |
| text | string | 설명 확인 | 항목을 누를 때 전송되는 텍스트. 캐러셀, 이미지 캐러셀, 리치 메뉴, Quick Reply에서 필숫값으로 사용되며, 버튼 템플릿, 리스트 템플릿, 고정 메뉴에서는 label값으로 대체된다. 최대 글자수: 300자 |
| postback | string | N | message.postback 속성으로 반환되는 문자열 최대 글자수: 1000자 |
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| i18nLabels | array | N | 다국어 레이블 목록 |
| i18nLabels[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nLabels[].label | string | Y | 항목에 표시되는 레이블. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
| i18nTexts | array | N | 다국어 텍스트 목록 |
| i18nTexts[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nTexts[].text | string | Y | 항목을 누를 때 전송되는 텍스트. 캐러셀, 이미지 캐러셀, 리치 메뉴, Quick Reply에서 필숫값으로 사용되며, 버튼 템플릿, 리스트 템플릿, 고정 메뉴에서는 label값으로 대체된다. 최대 글자수: 300자 |
{ "type": "message", "label": "Yes", "text": "Yes"}이 액션과 관련된 항목을 누르면 uri 속성에 지정된 URI가 열린다.
참고
- 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| type | string | Y | "uri"로 고정 |
| label | string | 설명 확인 | 항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
| uri | string | Y | 항목을 누를 때 URI가 열린다. 'http', 'https' 스키마를 지원한다. 최대 글자수: 1000자 |
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| i18nLabels | array | N | 다국어 레이블 목록 |
| i18nLabels[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nLabels[].label | string | Y | 항목에 표시되는 레이블. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
{ "type": "uri", "label": "View details", "uri": "http://example.com"}이 액션이 지정된 버튼을 누르면 카메라 화면이 열린다.
참고
- 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
- 모바일 버전에서만 사용할 수 있다.
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| type | string | Y | "camera"로 고정 |
| label | string | Y | 버튼의 레이블 최대 글자수: 20자 |
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| i18nLabels | array | N | 다국어 레이블 목록 |
| i18nLabels[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nLabels[].label | string | Y | 항목에 표시되는 레이블. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
{ "type": "camera", "label": "Camera"}이 액션이 지정된 버튼을 누르면 카메라 롤 화면이 열린다.
참고
- 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
- 모바일 버전에서만 사용할 수 있다.
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| type | string | Y | "cameraRoll"로 고정 |
| label | string | Y | 버튼의 레이블 최대 글자수: 20자 |
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| i18nLabels | array | N | 다국어 레이블 목록 |
| i18nLabels[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nLabels[].label | string | Y | 항목에 표시되는 레이블. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
{ "type": "cameraRoll", "label": "Camera roll"}이 액션이 지정된 버튼을 누르면 위치 정보 화면이 열린다.
참고
- 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다.
- 모바일 버전에서만 사용할 수 있다.
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| type | string | Y | "location"으로 고정 |
| label | string | Y | 버튼의 레이블 최대 글자수: 20자 |
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| i18nLabels | array | N | 다국어 레이블 목록 |
| i18nLabels[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nLabels[].label | string | Y | 항목에 표시되는 레이블. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
{ "type": "location", "label": "Location"}이 액션이 지정된 버튼을 누르면 copyText 파라미터에 지정된 텍스트가 클립보드에 복사된다.
참고
- 각 액션별로 사용 가능한 위치가 제한된다. 자세한 내용은 액션목록의 표를 참고한다. 주의
- 이 액션은 v3.6부터 지원된다.
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| type | string | Y | "copy"로 고정 |
| label | string | 설명 확인 | 항목에 표시되는 레이블. 리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다. 리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
| copyText | string | Y | 항목을 누를 때 클립보드로 복사된다. 최대 글자수: 1000자 |
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| i18nLabels | array | N | 다국어 레이블 목록 |
| i18nLabels[].language | string | Y | 다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US |
| i18nLabels[].label | string | Y | 항목에 표시되는 레이블. • 기본 최대 글자수: 20자 • 이미지 캐러셀 최대 글자수: 12자 • 고정 메뉴 최대 글자수: 1000자 |
{"type": "copy","label": "Copy This","copyText": "This is a copied text."}