Tài liệu tham khảo về Câu trả lời nhanh

Khi sử dụng Câu trả lời nhanh, bạn có thể gửi kèm các nút trong tin nhắn để hỏi thông tin từ người nhận. Khi mọi người nhấn vào nút câu trả lời nhanh, giá trị của nút này sẽ được gửi trong cuộc trò chuyện đó, đồng thời Nền tảng Messenger sẽ gửi một sự kiện messages đến webhook của bạn. Câu trả lời nhanh là một loại tin nhắn được gửi bằng Send API. Để biết đầy đủ chi tiết về cách gửi tin nhắn, hãy xem phần Tin nhắn.

Để biết đầy đủ chi tiết về cách sử dụng, hãy xem phần Câu trả lời nhanh.

Yêu cầu mẫu

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

Phản hồi mẫu

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

Thuộc tính

Thuộc tính Loại Mô tả

text

Chuỗi

Tin nhắn có nội dung để gửi cùng với câu trả lời nhanh. Phải đặt text hoặc attachment.

attachment

Đối tượng

Một tệp đính kèm để gửi cùng với câu trả lời nhanh. Phải đặt text hoặc attachment.

quick_replies

Mảng<quick_reply>

Mảng đối tượng mô tả các nút trả lời nhanh sẽ gửi. Hỗ trợ tối đa 13 câu trả lời nhanh.

quick_reply

Thuộc tính Loại Mô tả

content_type

Chuỗi

Phải là một trong các loại sau

  • text: Gửi nút văn bản
  • user_phone_number: Gửi một nút để người nhận có thể gửi số điện thoại được liên kết với tài khoản của họ.
  • user_email: Gửi một nút để người nhận có thể gửi email được liên kết với tài khoản của họ.

title

Chuỗi

Bắt buộc nếu content_type là "text" (văn bản). Văn bản sẽ hiển thị trên nút trả lời nhanh. Giới hạn 20 ký tự.

payload

Chuỗi, số

Bắt buộc nếu content_type là "text" (văn bản). Dữ liệu tùy chỉnh sẽ được gửi trả lại cho bạn qua sự kiện webhook messaging_postbacks. Giới hạn 1000 ký tự.


Có thể đặt là một chuỗi trống nếu đã đặt image_url.

image_url

Chuỗi

Không bắt buộc. URL của hình ảnh sẽ hiển thị trên nút trả lời nhanh đối với câu trả lời nhanh dạng văn bản. Hình ảnh phải có kích thước tối thiểu là 24px x 24px. Hình ảnh lớn hơn sẽ tự động bị cắt và thay đổi kích thước.


Bắt buộc nếu title là một chuỗi trống.