message_echoes
การเรียกกลับนี้จะเกิดขึ้นเมื่อมีการส่งข้อความโดยเพจของคุณ คุณอาจได้รับข้อความ text
หรือข้อความที่มีไฟล์แนบ (image
, video
, audio
, template
หรือ fallback
) เพย์โหลดจะรวม metadata
ที่กำหนดเองซึ่งเป็นทางเลือกที่ส่งโดยผู้ส่ง และ app_id
ที่เกี่ยวข้อง
คุณสามารถสมัครรับข้อมูลจากการเรียกกลับนี้ได้โดยเลือกช่อง message_echoes
ในขณะที่ตั้งค่า Webhook ของคุณ
ระบบรองรับข้อความหลากหลายประเภท ดังนี้
{ "sender":{ "id":"<PAGE_ID>" }, "recipient":{ "id":"<PSID>" }, "timestamp":1457764197627, "message":{ "is_echo":true, "app_id":1517776481860111, "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>", "mid":"mid.1457764197618:41d102a3e1ae206a38", ... } }
{ "object": "page", "entry": [ { "id": "<PAGE_ID>", "time": 1570053170926, "standby": [ { "sender": { "id": "<PAGE_ID>" }, "recipient": { "id": "<PSID>" }, "timestamp": 1570053170673, "message": { "mid": "qT7ywaKpO9kkQR7Gv-nM8LIfLZDamVrALniheUYEDdHJXjDXEAyaS1xxONzb2Iv-DFzmTihfWJV012P5pK0AhQ", "is_echo": true, "app_id": <APPID>, "attachments": [ { "title": "", "url": "https:\/\/www.facebook.com\/commerce\/update\/", "type": "template", "payload": { "template_type": "media", "elements": [ { "media_type": "image", "attachment_id": 2457235337685388 } ] } } ] } } ] } ] }
sender
ช่อง sender | คำอธิบาย |
---|---|
| ID ของเพจ Facebook ของคุณ |
recipient
ช่อง recipient | คำอธิบาย |
---|---|
| ID ในเพจของบุคคลที่ได้รับข้อความจากธุรกิจของคุณ |
message
ชื่อช่อง | ประเภท | คำอธิบาย |
---|---|---|
| บูลีน | ระบุถึงข้อความที่ส่งมาจากเพจเอง |
| สตริง | ID ของแอพที่ใช้ส่งข้อความ สำหรับ API กราฟตั้งแต่ |
| สตริง | สตริงที่กำหนดเองส่งผ่านไปยัง API การส่งโดยเป็นช่อง |
| สตริง | ID ข้อความ |
{ "sender":{ "id":"<PAGE_ID>" }, "recipient":{ "id":"<PSID>" }, "timestamp":1457764197627, "message":{ "is_echo":true, "app_id":1517776481860111, "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>", "mid":"mid.1457764197618:41d102a3e1ae206a38", "text":"hello, world!" } }
message
คุณสมบัติ | ประเภท | คำอธิบาย |
---|---|---|
| สตริง | เนื้อหาตัวอักษรของข้อความ |
{ "sender":{ "id":"<PAGE_ID>" }, "recipient":{ "id":"<PSID>" }, "timestamp":1458696618268, "message":{ "is_echo":true, "app_id":1517776481860111, "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>", "mid":"mid.1458696618141:b4ef9d19ec21086067", "attachments":[ { "type":"image", "payload":{ "url":"<IMAGE_URL>" } } ] } }
message.attachments
คุณสมบัติ | ประเภท | คำอธิบาย |
---|---|---|
| สตริง | ประเภทของไฟล์แนบ: |
| สตริง | URL ของไฟล์แนบ |
{ "sender":{ "id":"<PAGE_ID>" }, "recipient":{ "id":"<PSID>" }, "timestamp":1458696618268, "message":{ "is_echo":true, "app_id":1517776481860111, "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>", "mid":"mid.1458696618141:b4ef9d19ec21086067", "attachments":[ { "type":"template", "payload":{ "template_type":"button", "buttons":[ { "type":"web_url", "url":"https:\/\/www.messenger.com\/", "title":"Visit Messenger" } ] } } ] } }
message.attachments
คุณสมบัติ | ประเภท | คำอธิบาย |
---|---|---|
| สตริง |
|
| สตริง | เพย์โหลดเทมเพลตตามที่อธิบายไว้ในข้อมูลอ้างอิงเกี่ยวกับ API การส่ง |
โปรดทราบว่าในกรณีที่เป็น payload
ที่มีไฟล์แนบ ID ของไฟล์แนบที่ส่งจะเป็นตัวเลข ไม่ใช่สตริง โปรดดูตัวอย่างที่ 2
ซึ่งไม่ตรงกับรูปแบบของ API การส่งที่ต้องมี ID ของไฟล์แนบที่จะส่งในรูปของสตริง
ไฟล์แนบสำรองคือไฟล์แนบใดๆ ก็ตามที่ฟีเจอร์ Message Echo ไม่รู้จักหรือไม่รองรับในขณะนี้
{ "sender":{ "id":"<PAGE_ID>" }, "recipient":{ "id":"<PSID>" }, "timestamp":1458696618268, "message":{ "is_echo":true, "app_id":1517776481860111, "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>", "mid":"mid.1458696618141:b4ef9d19ec21086067", "attachments":[ { "title":"Legacy Attachment", "url":"https:\/\/www.messenger.com\/", "type":"fallback", "payload":null } ] } }
message.attachments
คุณสมบัติ | ประเภท | คำอธิบาย |
---|---|---|
| สตริง |
|
| สตริง | ชื่อไฟล์แนบ (ระบุหรือไม่ก็ได้) |
| สตริง | URL ของไฟล์แนบ (ระบุหรือไม่ก็ได้) |
| สตริง | เพย์โหลดของไฟล์แนบ (ระบุหรือไม่ก็ได้) |
Echo Webhook ข้อความที่มีสินค้าสามารถใช้งานได้ใน API กราฟเวอร์ชั่น 8.0 ขึ้นไปเท่านั้น
แอพจะต้องมีสิทธิ์การอนุญาต catalog_management
ที่ผ่านการอนุมัติให้รับรายละเอียดสินค้าใน Webhooks ได้
{ "sender":{ "id":"<PAGE_ID>" }, "recipient":{ "id":"<PSID>" }, "timestamp":1458696618268, "message":{ "is_echo":true, "app_id":1517776481860111, "metadata": "<DEVELOPER_DEFINED_METADATA_STRING>", "mid":"mid.1458696618141:b4ef9d19ec21086067", "attachments":[ { "type":"template", "payload":{ "product":{ "elements":[ // multiple elements for Hscroll { "id":"<PRODUCT_ID>", "retailer_id":"<EXTERNAL_ID>", "image_url":"https://fb.cdn.com/sdsd", "title":"Some product title", "subtitle": "40", }, {...}, ] } ] } } ] } }
product.elements
คุณสมบัติ | ประเภท | คำอธิบาย |
---|---|---|
| สตริง | ID สินค้าจากแค็ตตาล็อกสินค้า |
| สตริง | ID ภายนอกที่เชื่อมโยงกับสินค้า (ตัวอย่าง: SKU/ID เนื้อหา) |
| สตริง | URL ของรูปภาพสินค้า |
| สตริง | ชื่อของสินค้า |
| สตริง | ชื่อรองของสินค้า |