Trả lời nhanh

Trả lời nhanh cung cấp một cách mới để hiển thị nút cho người dùng. Trả lời nhanh hiển thị rõ ràng ở phía trên trình biên soạn với bàn phím được hiển thị ẩn hơn. Khi nhấn vào trả lời nhanh, tin nhắn được gửi trong cuộc trò chuyện kèm theo siêu dữ liệu do nhà phát triển xác định trong hồi đáp. Đồng thời, các nút bị loại bỏ để ngăn trường hợp người dùng có thể nhấn vào các nút đi kèm tin nhắn cũ trong cuộc trò chuyện.

Trả lời nhanh có thể chứa văn bản. Nếu muốn, bạn có thể thêm hình ảnh.

Bạn cũng có thể sử dụng Trả lời nhanh để nhắc người dùng nhập vị trí của họ.

Ví dụ

Chỉ văn bản

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Văn bản và hình ảnh

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED",
        "image_url":"http://petersfantastichats.com/img/red.png"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN",
        "image_url":"http://petersfantastichats.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Vị trí

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Please share your location:",
    "quick_replies":[
      {
        "content_type":"location",
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"

Trường

Đối tượng message

• Số lượng quick_replies tối đa được phép là 11

Đối tượng attachment

Trả lời nhanh hoạt động với tất cả các loại tin nhắn bao gồm tin nhắn văn bản, tệp hình ảnh và tệp mẫu đính kèm. Vui lòng tham khảo tài liệu về API Gửi để biết thêm thông tin về cách sử dụng đối tượng attachment.

Đối tượng quick_reply

• title có giới hạn 20 ký tự, sau đó sẽ bị cắt bớt
• payload có giới hạn 1000 ký tự
• Nếu content_type là location, thì title và payload sẽ không được sử dụng
• Hình ảnh của image_url phải có kích thước tối thiểu là 24x24 và sẽ được cắt cũng như thay đổi kích thước

Hồi đáp

Khi nhấn Trả lời nhanh, một tin nhắn văn bản sẽ được gửi tới Hồi đáp đã nhận tin nhắn qua webhook của bạn. Nội dung tin nhắn sẽ tương ứng với tiêu đề của Trả lời nhanh. Đối tượng tin nhắn cũng sẽ chứa trường có tên quick_reply bao gồm dữ liệu payload trên Trả lời nhanh.

{
  "sender": {
    "id": "USER_ID"
  },
  "recipient": {
    "id": "PAGE_ID"
  },
  "timestamp": 1464990849275,
  "message": {
    "mid": "mid.1464990849238:b9a22a2bcb1de31773",
    "seq": 69,
    "text": "Red",
    "quick_reply": {
      "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
    }
  }
}    

Khi người dùng chia sẻ vị trí của họ, hồi đáp sẽ có dạng như sau:

{
  "object": "page",
  "entry": [
    {
      "id": "PAGE_ID",
      "time": 1472672934319,
      "messaging": [
        {
          "sender": {
            "id": "USER_ID"
          },
          "recipient": {
            "id": "PAGE_ID"
          },
          "timestamp": 1472672934259,
          "message": {
            "mid": "mid.1472672934017:db566db5104b5b5c08",
            "seq": 297,
            "attachments": [
              {
                "title": "Facebook HQ",
                "url": "https://www.facebook.com/l.php?u=https%....5-7Ocxrmg",
                "type": "location",
                "payload": {
                  "coordinates": {
                    "lat": 37.483872693672,
                    "long": -122.14900441942
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}