เอกสารนี้นี้ได้รับการอัพเดตแล้ว
คำแปลเป็น ภาษาไทย ยังไม่เสร็จสมบูรณ์
ภาษาอังกฤษที่อัพเดต: 24 เม.ย. 2023

เทมเพลตทั่วไป

เทมเพลตทั่วไปจะช่วยให้คุณสามารถส่งข้อความที่มีการจัดโครงสร้างซึ่งมีรูปภาพ ข้อความ และปุ่มได้ เทมเพลตทั่วไปที่มีการระบุเทมเพลตไว้หลายรายการในอาร์เรย์ 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":"

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

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

คุณสมบัติ

recipient

คำอธิบายของผู้รับข้อความ คำขอทั้งหมดต้องมีคุณสมบัติอย่างใดอย่างหนึ่งต่อไปนี้เพื่อระบุถึงผู้รับ

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

recipient.id

สตริง

ID ผู้ใช้ใน IG (IGSID) ของผู้รับข้อความ

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>

อาร์เรย์ของอ็อบเจ็กต์ element ที่อธิบายอินสแตนซ์ของเทมเพลตทั่วไปที่จะส่ง การระบุองค์ประกอบหลายรายการจะส่งภาพสไลด์ของเทมเพลตที่สามารถเลื่อนในแนวนอนได้ รองรับองค์ประกอบสูงสุด 10 รายการ

message.attachment.payload.elements

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

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

title

สตริง

ชื่อที่จะแสดงในเทมเพลต จำกัดอักขระอยู่ที่ 80 ตัว

subtitle

สตริง

ระบุหรือไม่ก็ได้ คำบรรยายที่จะแสดงในเทมเพลต จำกัดอักขระอยู่ที่ 80 ตัว

image_url

สตริง

ระบุหรือไม่ก็ได้ URL ของรูปภาพที่จะแสดงในเทมเพลต

default_action

อ็อบเจ็กต์

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

buttons

อาร์เรย์<button>

ระบุหรือไม่ก็ได้ อาร์เรย์ของปุ่มเพื่อต่อท้ายเทมเพลต รองรับปุ่มสูงสุดได้ถึง 3 ปุ่มต่อองค์ประกอบ 1 รายการ ระบบรองรับเฉพาะปุ่ม postback และ web_url เท่านั้น