빠른 답장

빠른 답장은 제목 및 이미지(선택 사항)와 함께 작성 도구의 바로 위에 표시되는 대화 내 버튼을 최대 13개까지 제공합니다. 또한 빠른 답장을 사용하여 사용자의 위치, 이메일 주소, 전화번호를 요청할 수도 있습니다.

빠른 답장을 누르면 버튼이 해제되고 해당 버튼의 제목이 대화에 메시지로 게시됩니다. messages 이벤트는 버튼 제목과 선택적 페이로드를 포함하는 Webhooks로 전송됩니다.

빠른 답장 보내기

빠른 답장을 보내려면 quick_replies 배열을 문자 메시지에 추가하고, 최대 13개의 빠른 답장 버튼을 정의하는 개체를 포함합니다.

지원되는 빠른 답장 유형은 다음과 같습니다.

• 텍스트
• 전화번호
• 이메일

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>"    

텍스트 빠른 답장

제목 옆에 아이콘으로 표시되는 이미지(선택 사항)와 함께 텍스트 빠른 답장을 보낼 수도 있습니다. 빠른 답장의 content_type을 text로 지정하면 비어 있지 않은 title을 지정해야 합니다.

구문

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Webhooks 이벤트

빠른 답장을 누르면 개발자의 Webhooks 메시지 수신 콜백에 문자 메시지가 전송됩니다.

이벤트의 text 속성은 빠른 답장의 제목에 해당합니다. 또한 메시지 개체에는 빠른 답장의 payload 데이터가 포함된 quick_reply라는 이름의 필드가 있습니다.

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "1254459154682919"
          },
          "recipient": {
            "id": "682498171943165"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
            },
            "mid": "m_AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P",
            "text": "Green"
          }
        }
      ]
    }
  ]
}

사용자 전화번호 빠른 답장

사용자 전화번호 빠른 답장을 사용하면 사용자에게 전화번호를 요청할 수 있습니다. 전화번호 빠른 답장을 보내면 Messenger 플랫폼은 화면에 표시된 빠른 답장에 사용자 프로필 정보의 전화번호를 자동으로 미리 채웁니다.

사용자 프로필에 전화번호가 없을 경우 빠른 답장이 표시되지 않습니다.

봇에서는 사용자가 빠른 답장을 클릭할 때까지 전화번호를 수신하지 않습니다.

빠른 답장을 선택하면 정보가 한 번 전송되지만 향후 해당 정보에 액세스할 수 있는 권한이 부여된 것은 아닙니다.

구문

{
  "content_type":"user_phone_number"
}

Webhooks 이벤트

사용자가 빠른 답장을 누르면 전화번호가 messages Webhooks 이벤트의 payload 속성에 전달됩니다.

{
  "object": "page",
  "entry": [
    {
      "id": "

사용자 이메일 빠른 답장

사용자 이메일 빠른 답장을 사용하면 사용자에게 이메일을 요청할 수 있습니다. 이메일 빠른 답장이 전송되면 Messenger 플랫폼은 화면에 표시된 빠른 답장에 사용자 프로필 정보의 이메일 주소를 자동으로 미리 채웁니다.

사용자 프로필에 이메일 주소가 없으면 빠른 답장이 표시되지 않습니다.

봇에서는 사용자가 빠른 답장을 클릭할 때까지 이메일 주소를 수신하지 않습니다.

빠른 답장을 선택하면 정보가 한 번 전송되지만 향후 해당 정보에 액세스할 수 있는 권한이 부여된 것은 아닙니다.

구문

{
  "content_type":"user_email"
}

Webhooks 이벤트

사용자가 빠른 답장을 누르면 이메일 주소가 messages Webhooks 이벤트의 payload 속성에 전달됩니다.

{
  "object": "page",
  "entry": [
    {
      "id": "

모범 사례