ข้อมูลอ้างอิงเกี่ยวกับเทมเพลตทั่วไป

เทมเพลตทั่วไปจะอนุญาตให้ส่งข้อความที่มีการจัดโครงสร้างที่มีรูปภาพ ข้อความ และปุ่ม เทมเพลตทั่วไปที่มีการระบุหลายเทมเพลตไว้ในอาร์เรย์ elements จะส่งเทมเพลตเหล่านั้นมาในรูปแบบภาพสไลด์แบบเลื่อนในแนวนอน ซึ่งแต่ละรายการจะประกอบด้วยรูปภาพ ข้อความ และปุ่ม โปรดดูรายละเอียดการนำไปใช้ที่ครบถ้วนสมบูรณ์ที่เทมเพลตทั่วไป

URI คำขอ

https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://petersfancybrownhats.com/company_image.png",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://petersfancybrownhats.com/view?item=103",
              "messenger_extensions": false,
              "webview_height_ratio": "tall",
              "fallback_url": "https://petersfancybrownhats.com/"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://petersfancybrownhats.com",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"DEVELOPER_DEFINED_PAYLOAD"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

ตัวอย่างการตอบสนอง

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

คุณสมบัติ

`recipient`

คำอธิบายของผู้รับข้อความ คำขอทั้งหมดต้องรวม “id” “phone_number” หรือ “user_ref” อย่างใดอย่างหนึ่ง

คุณสมบัติ	ประเภท	คำอธิบาย
`recipient.id`	สตริง	`PSID`, `phone_number` หรือ `user_ref` ของผู้รับข้อความอย่างใดอย่างหนึ่ง
`recipient.phone_number`	สตริง	*ระบุหรือไม่ก็ได้* หมายเลขโทรศัพท์มือถือของผู้รับที่อยู่ในรูปแบบ +1(212)555-2368 บอทของคุณต้องได้รับการอนุมัติสำหรับการจับคู่ลูกค้าเพื่อส่งข้อความด้วยวิธีนี้
`recipient.user_ref`	สตริง	*ระบุหรือไม่ก็ได้*`user_ref` จากปลั๊กอินกล่องกาเครื่องหมาย
`recipient.name`	อ็อบเจ็กต์	*ระบุหรือไม่ก็ได้* ต้องใช้หากตั้งค่า `phone_number` เท่านั้น ระบุชื่อของบุคคลในรูปแบบ: `{"first_name":"John", "last_name":"Doe"}` การใส่ชื่อจะเพิ่มโอกาสที่จะจับคู่สำเร็จ

`message`

Description of the message to be sent.

Property	Type	Description
`message.attachment`	Object	An object describing attachments to the message.

`message.attachment`

Property	Type	Description
`type`	String	Value must be `template`
`payload`	Object	`payload` ของเทมเพลต

`message.attachment.payload`

ชื่อคุณสมบัติ	ประเภท	คำอธิบาย
`template_type`	สตริง	ค่าต้องเป็น `generic`
`elements`	อาร์เรย์<`element`>	อาร์เรย์ที่มีอ็อบเจ็กต์องค์ประกอบ 1 รายการที่อธิบายสื่อในข้อความ รองรับองค์ประกอบสูงสุด 1 รายการ
`sharable`	บูลีน	*ระบุหรือไม่ก็ได้* ตั้งค่าเป็น `true` เพื่อเปิดใช้งานปุ่มแชร์แบบเนทีฟใน Messenger สำหรับข้อความเทมเพลต มีค่าเริ่มต้นเป็น `false`

`message.attachment.payload.elements`

เทมเพลตทั่วไปจะรองรับองค์ประกอบสูงสุด 10 รายการต่อข้อความ ต้องตั้งค่าคุณสมบัติเพิ่มเติมนอกเหนือจาก title อย่างน้อยหนึ่งรายการ

ชื่อคุณสมบัติ	ประเภท	คำอธิบาย
`title`	สตริง	ชื่อที่จะแสดงในเทมเพลต จำกัดอักขระอยู่ที่ 80 ตัว
`subtitle`	สตริง	*ระบุหรือไม่ก็ได้* คำบรรยายที่จะแสดงในเทมเพลต จำกัดอักขระอยู่ที่ 80 ตัว
`image_url`	สตริง	*ระบุหรือไม่ก็ได้* URL ของรูปภาพที่จะแสดงในเทมเพลต
`default_action`	อ็อบเจ็กต์	*ระบุหรือไม่ก็ได้* การดำเนินการเริ่มต้นจะเริ่มขึ้นเมื่อมีการเลือกเทมเพลต ยอมรับคุณสมบัติที่เหมือนกันกับปุ่ม URL ยกเว้น `title`
`buttons`	อาร์เรย์<`button`>	*ระบุหรือไม่ก็ได้* อาร์เรย์ของปุ่มเพื่อต่อท้ายเทมเพลต รองรับปุ่มสูงสุดได้ถึง 3 ปุ่มต่อองค์ประกอบ