빠른 답장

사용자가 빠른 답장(quick reply) 버튼이 포함된 메시지를 수신하면, 해당 버튼은 채팅 화면 아래에 나타난다.
사용자는 버튼 중 하나를 눌러 응답할 수 있다.

어느 유형의 메시지에든 13개의 빠른 답장 버튼을 설정할 수 있다.

빠른 답장에서 사용 가능한 동작은 다음과 같다.

postback action
message action
URI action
camera action(iOS와 Android에서만 기능 동작)
camera roll action(iOS와 Android에서만 기능 동작)
location action(iOS와 Android에서만 기능 동작)

빠른 답장 버튼의 시작 부분에는 아이콘을 지정할 수 있다.

버튼의 타입이 'camera', 'cameraRoll', 'location'일 때 아이콘이 설정되어 있지 않으면 기본 아이콘이 표시된다.
버튼의 타입이 'postback', 'message', 'uri'이면 아이콘을 생략할 수 있다.

참고
클라이언트 v2.6 이상에서만 노출된다.

structure_quickreply

그림1 빠른 답장 구조

Request Content {#quickreply-request}

common {#quickreply-request-common}

파리미터	타입	필수 여부	설명
quickReply	object	N	빠른 답장 객체
quickReply.items	array	Y	빠른 답장 버튼 객체 최대 13개
quickReply.items[].imageUrl	string	N	버튼 앞에 표시될 아이콘 URL(PNG 형식, HTTPS만 허용). imageUrl, imageResourceId 중 하나만 지정해야 하며, 필수는 아니다. camera, camera roll, location일 때는 설정하지 않으면 기본 아이콘이 표시된다. 최대 크기: 1MB 최대 글자수: 1000자
quickReply.items[].action	Action Object	Y	버튼을 눌렀을 때 동작

resourceId, multi language {#quickreply-request-resourceid-multilang}

파라미터	타입	필수 여부	설명
quickReply.items[].i18nImageUrl	array	N	다국어 이미지 URL 목록
quickReply.items[].i18nImageUrl[].language	string	Y	다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US
quickReply.items[].i18nImageUrl[].thumbnailImageUrl	string	Y	이미지 URL(PNG 형식, HTTPS만 허용) 최대 크기: 1MB 최대 글자수: 1000자
quickReply.items[].imageResourceId	string	N	이미지 리소스 ID imageUrl, imageResourceId 중 하나만 지정해야 하며, 필수는 아니다. 최대 크기: 1MB
quickReply.items[].i18nImageResourceIds[]	array	N	다국어 이미지 리소스 ID 목록
quickReply.items[].i18nImageResourceIds[].language	string	Y	다국어 언어 코드 • ko_KR • ja_JP • zh_CN • zh_TW • en_US
quickReply.items[].i18nImageResourceIds[].imageResourceId	string	Y	이미지 리소스 ID 최대 크기: 1MB

Request Example {#quickreply-request-example}

example_quickreply

quick reply structure {#quickreply-structure}

"quickReply": {  "items": [    {      "imageUrl": "https://www.example.com/a.png",      "action": {        "type": "message",        "label": "Send message",        "text": "send message"      }    },    {      "action": {        "type": "camera",        "label": "Open camera"      }    }  ]}

주의
quickReply 속성을 단독으로 사용될 수 없으며
아래 예시처럼 메시지 발송에 포함하여 사용하여야 한다.

text with quick reply {#quickreply-request-example-text}

{  "content": {    "type": "text",    "text": "Please select your favorite food category!",    "quickReply": {      "items": [        {          "imageUrl": "https://www.example.com/a.png",          "action": {            "type": "message",            "label": "sushi",            "text": "Sushi"          }        },        {          "imageUrl": "https://www.example.com/b.png",          "action": {            "type": "message",            "label": "Italian",            "text": "Italian"          }        },        {          "action": {            "type": "camera",            "label": "Open Camera"          }        }      ]    }  }}

flexible template with quick reply {#quickreply-request-example-flex}

{  "content": {    "type": "flex",    "altText": "This is a flexible template with quick reply",    "contents": {      "type": "bubble",      "size": "mega",      "hero": {        "type": "box",        "layout": "vertical",        "contents": [          {            "type": "text",            "text": "YOU ARE INVITED!",            "size": "xl",            "color": "#ffffff",            "weight": "bold",            "align": "center",            "wrap": true          }        ],        "backgroundColor": "#81DBA0",        "paddingAll": "15px"      }    },    "quickReply": {      "items": [        {          "imageUrl": "https://www.example.com/a.png",          "action": {            "type": "message",            "label": "Accept",            "text": "Accept"          }        },        {          "imageUrl": "https://www.example.com/b.png",          "action": {            "type": "message",            "label": "Decline",            "text": "Decline"          }        }      ]    }  }