빠른 답장 참고 자료

빠른 답장을 사용하면 메시지에서 버튼을 보내서 메시지를 받는 사람으로부터 입력을 받을 수 있습니다. 빠른 답장을 누르면 버튼의 값이 대화에서 전송되고 Messenger 플랫폼이 messages 이벤트를 Webhooks로 보냅니다. 빠른 답장은 보내기 API로 전송하는 메시지 유형입니다. 메시지 전송에 대한 자세한 내용은 메시지를 참조하세요.

사용법에 대한 자세한 내용은 빠른 답장을 참조하세요.

요청 예시

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

응답 예시

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

속성

속성	유형	설명
`text`	문자열	빠른 답장과 함께 전송할 비어 있지 않은 메시지 텍스트입니다. `text` 또는 `attachment`를 설정해야 합니다.
`attachment`	개체	빠른 답장과 함께 전송할 첨부 파일입니다. `text` 또는 `attachment`를 설정해야 합니다.
`quick_replies`	배열<`quick_reply`>	전송할 빠른 답장 버튼을 설명하는 개체의 배열입니다. 최대 13개의 빠른 답장이 지원됩니다.

`quick_reply`

속성	유형	설명
`content_type`	문자열	다음 중 하나에 해당해야 합니다. `text`: 텍스트 버튼을 전송합니다. `user_phone_number`: 받는 사람이 자신의 계정과 연결된 전화번호를 보낼 수 있는 버튼을 전송합니다. `user_email`: 받는 사람이 계정과 연결된 이메일을 보낼 수 있는 버튼을 전송합니다.
`title`	문자열	`content_type`이 'text'일 경우 필수입니다. 빠른 답장 버튼에 표시할 텍스트입니다. 20자로 제한됩니다.
`payload`	문자열, 숫자	`content_type`이 'text'일 경우 필수입니다. `messaging_postbacks` Webhooks 이벤트를 통해 나에게 다시 전송될 맞춤 데이터입니다. 1,000자로 제한됩니다. `image_url`이 설정된 경우 빈 문자열로 설정할 수 있습니다.
`image_url`	문자열	*선택 사항.* 텍스트 빠른 답장에 대한 빠른 답장 버튼에 표시할 이미지의 URL입니다. 이미지는 24px x 24px 이상이어야 합니다. 그보다 큰 이미지는 자동으로 잘려서 크기가 조정됩니다. `title`이 빈 문자열인 경우 필수입니다.