快速回覆

快速回覆可讓您在撰寫工具上方，顯眼地提供一組最多 13 個對話內按鈕，其中包含標題及選用圖像。您還可使用快速回覆要求用戶提供地點、電子郵件地址與電話號碼。

當用戶點按快速回覆時，按鈕會消失，而所點按之按鈕的標題會發佈為對話訊息。內含按鈕標題和選用承載的 messages 事件將會傳送至您的 Webhook。

傳送快速回覆

若要傳送快速回覆，請在文字訊息中加入 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>"
}

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

最佳作法