Câu trả lời nhanh

Câu trả lời nhanh giúp bạn lồng ghép một nhóm gồm tối đa 13 nút vào cuộc trò chuyện. Nút này (bao gồm tên và một hình ảnh tùy chọn) sẽ xuất hiện rõ ràng phía trên trình biên soạn. Bạn cũng có thể dùng câu trả lời nhanh để yêu cầu dữ liệu về vị trí, địa chỉ email và số điện thoại của một người.

Khi nhấn vào một câu trả lời nhanh, các nút sẽ biến mất và tên nút đã nhấn được đăng lên cuộc trò chuyện dưới dạng tin nhắn. Một sự kiện messages sẽ được gửi đến webhook của bạn. Webhook này chứa tên nút và phần tải dữ liệu không bắt buộc.

Gửi câu trả lời nhanh

Để gửi một câu trả lời nhanh, hãy thêm mảng quick_replies vào tin nhắn văn bản và thêm các đối tượng xác định tối đa 13 nút trả lời nhanh.

Chúng tôi hỗ trợ các loại câu trả lời nhanh sau:

• Văn bản
• Số điện thoại
• Email

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

Câu trả lời nhanh bằng văn bản

Bạn cũng có thể gửi câu trả lời nhanh bằng văn bản cùng với hình ảnh tùy chọn xuất hiện dưới dạng một biểu tượng bên cạnh tên nút. Nếu chỉ định content_type cho một câu trả lời nhanh là text thì bạn phải chỉ định một title không trống.

Cú pháp

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Sự kiện webhook

Khi nhấn vào câu trả lời nhanh, một tin nhắn văn bản sẽ được gửi đến webhook Hồi đáp đã nhận tin nhắn của bạn.

Thuộc tính text của sự kiện sẽ tương ứng với tên của Câu trả lời nhanh. Đối tượng tin nhắn cũng sẽ chứa một trường có tên quick_reply bao gồm dữ liệu payload về Câu trả lời nhanh.

{
  "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"
          }
        }
      ]
    }
  ]
}

Câu trả lời nhanh về số điện thoại của người dùng

Câu trả lời nhanh về số điện thoại của người dùng cho phép bạn yêu cầu người dùng cung cấp số điện thoại. Khi câu trả lời nhanh về số điện thoại được gửi đi, Nền tảng Messenger sẽ tự động điền trước câu trả lời nhanh được hiển thị bằng số điện thoại lấy từ thông tin trên trang cá nhân của người dùng.

Nếu trang cá nhân của người dùng không có số điện thoại, câu trả lời nhanh sẽ không hiển thị.

Bot sẽ không nhận được số điện thoại cho đến khi người dùng nhấp vào câu trả lời nhanh.

Việc chọn câu trả lời nhanh sẽ truyền tải thông tin một lần mà không cấu thành quyền truy cập thông tin trong tương lai.

Cú pháp

{
  "content_type":"user_phone_number"
}

Sự kiện webhook

Khi người dùng nhấn vào câu trả lời nhanh, số điện thoại sẽ được chuyển qua thuộc tính payload của sự kiện webhook messages.

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

Câu trả lời nhanh về email của người dùng

Câu trả lời nhanh về email của người dùng cho phép bạn yêu cầu người dùng cung cấp email. Khi câu trả lời nhanh về email được gửi đi, Nền tảng Messenger sẽ tự động điền trước câu trả lời nhanh được hiển thị bằng email lấy từ thông tin trên trang cá nhân của người dùng.

Nếu trang cá nhân của người dùng không có địa chỉ email, câu trả lời nhanh sẽ không hiển thị.

Bot sẽ không nhận được email cho đến khi người dùng nhấp vào câu trả lời nhanh.

Việc chọn câu trả lời nhanh sẽ truyền tải thông tin một lần mà không cấu thành quyền truy cập thông tin trong tương lai.

Cú pháp

{
  "content_type":"user_email"
}

Sự kiện webhook

Khi người dùng nhấn vào câu trả lời nhanh, địa chỉ email sẽ được chuyển qua thuộc tính payload của sự kiện webhook messages.

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

Cách làm tốt nhất