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

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

เนื้อหา

URI คำขอ

https://graph.facebook.com/v19.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 ปุ่มต่อองค์ประกอบ