ข้อมูลอ้างอิงเกี่ยวกับข้อความตอบกลับด่วน

ข้อความตอบกลับด่วนช่วยให้คุณสามารถรับอินพุตจากผู้รับข้อความได้โดยการส่งปุ่มต่างๆ ไปพร้อมกับข้อความ เมื่อผู้รับแตะที่ข้อความตอบกลับด่วน ระบบจะส่งค่าที่ปรากฏอยู่บนปุ่มเข้าไปในการสนทนา และแพลตฟอร์ม Messenger จะส่งเหตุการณ์ messages ไปยัง Webhook ของคุณ ข้อความตอบกลับด่วนคือข้อความประเภทหนึ่งที่ส่งด้วย Send API โปรดดูรายละเอียดทั้งหมดเกี่ยวกับการส่งข้อความที่ข้อความ

โปรดดูรายละเอียดการใช้งานทั้งหมดที่ข้อความตอบกลับด่วน

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ

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

คุณสมบัติ

คุณสมบัติ ประเภท คำอธิบาย

text

สตริง

ข้อความแบบไม่ว่างเปล่าที่จะส่งไปพร้อมกับข้อความตอบกลับด่วน โดยคุณจะต้องตั้งค่า text หรือ attachment

attachment

อ็อบเจ็กต์

ไฟล์แนบที่จะส่งไปพร้อมกับข้อความตอบกลับด่วน โดยคุณจะต้องตั้งค่า text หรือ attachment

quick_replies

อาร์เรย์<quick_reply>

อาร์เรย์ของอ็อบเจ็กต์ที่อธิบายถึงปุ่มข้อความตอบกลับด่วนที่จะส่ง ระบบรองรับข้อความตอบกลับด่วนสูงสุด 13 ข้อความ

quick_reply

คุณสมบัติ ประเภท คำอธิบาย

content_type

สตริง

ต้องเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • text: ส่งปุ่มข้อความ
  • user_phone_number: ส่งปุ่มที่ทำให้ผู้รับสามารถส่งหมายเลขโทรศัพท์ที่ผูกกับบัญชีของตน
  • user_email: ส่งปุ่มที่ทำให้ผู้รับสามารถส่งอีเมลที่ผูกกับบัญชีของตน

title

สตริง

จำเป็นต้องระบุหาก content_type เป็น "text" ข้อความที่จะแสดงในปุ่มข้อความตอบกลับด่วน จำกัดอักขระอยู่ที่ 20 ตัว

payload

สตริง, ตัวเลข

จำเป็นต้องระบุหาก content_type เป็น "text" ข้อมูลแบบกำหนดเองที่จะส่งกลับถึงคุณผ่านเหตุการณ์ Webhook messaging_postbacks จำกัดอักขระอยู่ที่ 1,000 ตัว


อาจตั้งค่าเป็นสตริงที่ว่างเปล่าหากตั้งค่า image_url

image_url

สตริง

ระบุหรือไม่ก็ได้ URL ของรูปภาพที่จะแสดงในปุ่มข้อความตอบกลับด่วนสำหรับข้อความตอบกลับด่วนแบบตัวอักษร รูปภาพควรมีขนาดขั้นต่ำ 24 x 24 พิกเซล ระบบจะครอบตัดและย่อรูปภาพที่มีขนาดใหญ่กว่านี้โดยอัตโนมัติ


จำเป็นต้องระบุหาก title เป็นสตริงที่ว่างเปล่า