快速回覆參考資料

快速回覆可讓您在訊息中傳送按鈕，藉此獲得訊息接收者的回覆。當有人點按快速回覆後，按鈕的值會在對話中傳送，而 Messenger 平台會將 messages 事件傳送至您的 Webhook。快速回覆是一種利用傳送 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` 為「文字」，則為必要項目。顯示於快速回覆按鈕上的文字。上限為 20 個字元。
`payload`	字串、數字	如果 `content_type` 為「文字」，則為必要項目。將經由 `messaging_postbacks` Webhook 事件傳回給您的自訂資料。上限為 1000 個字元。如果已設定 `image_url`，可設定為空白字串。
`image_url`	字串	*選用。*顯示於文字快速回覆的快速回覆按鈕圖像網址。圖片大小的下限為 24 像素 x 24 像素。若圖像較大，系統會將之自動裁剪並調整大小。如果 `title` 是空白字串，則為必要項目。