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 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 API Gửi. Để 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/v19.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.