แพลตฟอร์ม Messenger
 
 
 

ตอบด่วน

“ตอบด่วน” คือวิธีใหม่ในการนำเสนอปุ่มแก่ผู้ใช้ “ตอบด่วน” จะปรากฏขึ้นอย่างสะดุดตาที่ด้านบนของช่องเขียนโดยจะเด่นกว่าแป้นพิมพ์ เมื่อแตะ “ตอบด่วน” ระบบจะส่งข้อความในการสนทนาโดยมีเมตาดาต้าที่ผู้พัฒนากำหนดในการเรียกกลับ นอกจากนี้ ปุ่มจะถูกยกเลิกเพื่อป้องกันปัญหาที่ผู้ใช้อาจแตะบนปุ่มที่ติดมากับข้อความเก่าในบทสนทนาได้

“ตอบด่วน” จะประกอบไปด้วยข้อความ แต่คุณสามารถเลือกที่จะเพิ่มภาพได้

นอกจากนี้คุณยังสามารถใช้ “ตอบด่วน” เพื่อขอตำแหน่งที่ตั้งของบุคคลหนึ่งได้ิอีกด้วย

ตัวอย่าง

เฉพาะข้อความ

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"

ข้อความและภาพ

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"

ตำแหน่งที่ตั้ง

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"

ฟิลด์

อ็อบเจ็กต์ message

ชื่อคุณสมบัติ คำอธิบาย ต้องระบุ

text

ข้อความ

ต้องมีการตั้งค่า text หรือ attachment

attachment

อ็อบเจ็กต์ attachment

ต้องมีการตั้งค่า text หรือ attachment

quick_replies

อาร์เรย์ของquick_replyที่จะส่งพร้อมกับข้อความ

N

  • quick_repliesถูกจำกัดไว้ที่ 11

อ็อบเจ็กต์ attachment

ชื่อคุณสมบัติ คำอธิบาย ต้องระบุ

type

ประเภทเอกสารแนบอาจเป็นimageหรือtemplateก็ได้

Y

payload

เพย์โหลดของเอกสารแนบ

Y

“ตอบด่วน” ใช้งานได้กับข้อความทุกประเภท ไม่ว่าจะเป็นข้อความตัวอักษร รูปภาพ และเอกสารแนบเทมเพลต โปรดดูเอกสารประกอบการส่ง API เพื่อรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้อ็อบเจ็กต์ attachment

อ็อบเจ็กต์ quick_reply

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

content_type

textหรือlocation

สตริง

Y

title

คำอธิบายปุ่ม

สตริง

เฉพาะเมื่อcontent_typeเป็นtextเท่านั้น

payload

ข้อมูลแบบกำหนดเองที่ระบบจะส่งกลับถึงคุณผ่าน Webhook

สตริง

เฉพาะเมื่อcontent_typeเป็นtextเท่านั้น

image_url

URL ของภาพสำหรับการตอบด่วนtext

สตริง

N

  • titleจำกัดความยาวที่ 20 อักขระและจะถูกตัดให้สั้นหลังความยาวนั้น
  • payloadจำกัดความยาวที่ 1000 อักขระ
  • หากcontent_typeเป็นlocationtitle และpayloadจะไม่นำมาใช้
  • ภาพสำหรับ image_url ควรมีขนาด 24x24 และจะถูกครอบตัดและปรับขนาด

การเรียกกลับ

เมื่อแตะ “ตอบด่วน” ระบบจะส่งข้อความตัวอักษรไปยังการเรียกกลับข้อความที่ได้รับของ Webhook ของคุณ โดยเนื้อหาของข้อความจะเกี่ยวข้องกับชื่อของ “ตอบด่วน” นอกจากนี้ อ็อบเจ็กต์ของข้อความจะยังมีฟิลด์ชื่อ quick_reply ที่มีข้อมูล payload บน “ตอบด่วน”

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

เมื่อบุคคลแชร์ตำแหน่งที่ตั้ง การเรียกกลับจะมีลักษณะดังนี้

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