快速回覆

快速回覆可讓您在對話中顯示多達 13 種按鈕，這些按鈕包含標題與選用圖像，並會顯示在撰寫工具上方的顯眼位置。您亦可使用快速回覆來要求用戶提供位置、電郵地址與手機號碼。

用戶點按快速回覆時，按鈕就會消失，而原本被點按按鈕上的標題就會以訊息的形式在對話中發佈。系統會向包含此按鈕標題和選用裝載的 Webhook 傳送 messages 事件。

傳送快速回覆

如要傳送快速回覆，請在文字訊息中新增 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/v21.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>"
}

Webhook 事件

用戶點按快速回覆後，系統就會傳送文字訊息至您的 webhook 訊息已接收回呼。

事件的 text 屬性將對應快速回覆的標題。訊息物件還會包含名為 quick_reply 的欄位，當中含有快速回覆的 payload 數據。

{
  "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 平台會自動在顯示的快速回覆中預先填入對方個人檔案資料中的手機號碼。

如果對方的個人檔案中沒有手機號碼，系統就不會顯示快速回覆。

在用戶點擊快速回覆前，BOT（機械人程式）都不會收到手機號碼。

選擇快速回覆只會傳送資訊一次，而且不代表系統日後授權存取該項資訊。

語法

{
  "content_type":"user_phone_number"
}

Webhook 事件

用戶點按快速回覆時，系統將透過 messages webhook 事件的 payload 屬性傳遞手機號碼。

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

用戶電郵地址快速回覆

用戶電郵地址快速回覆可讓您要求用戶提供電郵地址。系統傳送電郵地址快速回覆後，Messenger 平台會自動在顯示的快速回覆中預先填入對方個人檔案資料中的電郵地址。

如果對方的個人檔案中沒有電郵地址，系統就不會顯示快速回覆。

在用戶點擊快速回覆前，BOT（機械人程式）都不會收到電郵地址。

選擇快速回覆只會傳送資訊一次，而且不代表系統日後授權存取該項資訊。

語法

{
  "content_type":"user_email"
}

Webhook 事件

用戶點按快速回覆時，系統將透過 messages webhook 事件的 payload 屬性傳遞電郵地址。

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

最佳操作實例