แพลตฟอร์ม Messenger

ข้อมูลอ้างอิงเกี่ยวกับ Webhooksmessaging_postbacks

เอกสารนี้จะอธิบายเพย์โหลด JSON ที่เซิร์ฟเวอร์ Webhooks ของคุณจะได้รับเมื่อเกิดเหตุการณ์ Webhooks โพสต์ย้อนกลับในการส่งข้อความ เหตุการณ์ Webhook โพสต์ย้อนกลับจะเกิดขึ้นเมื่อผู้ใช้คลิกที่ปุ่มโพสต์โพสต์ย้อนกลับ ปุ่ม "เริ่มต้นใช้งาน" หรือรายการในเมนูถาวร

ตัวอย่างการแจ้งเตือน

รายการต่อไปนี้คือตัวอย่างเพย์โหลด JSON ที่ระบบจะส่งไปยังเซิร์ฟเวอร์ Webhooks ของคุณ

{
  "field": "messaging_postbacks",
  "value": {
    "sender": {
      "user_ref": "USER-REF-ID"
    },
    "recipient": {
      "id": "PAGE-ID"
    },
    "timestamp": "1527459824",
    "postback": {
      "mid": "m_MESSAGE-ID",
      "title": "TITLE-FOR-THE-CTA",
      "payload": "USER-DEFINED-PAYLOAD",
      "referral": {
        "ref": "USER-DEFINED-REFERRAL-PARAM",
        "source": "SHORT-URL",
        "type": "OPEN_THREAD"
      }
    }
  }
}

คุณสมบัติ JSON

คุณสมบัติ JSON ทั้งหมดในการแจ้งเตือน Webhook จะเป็นสตริง

คุณสมบัติคำอธิบาย

postback.mid

ID ของข้อความ

postback.payload

ข้อมูลที่กำหนดไว้ในพารามิเตอร์ payload ของ CTA ข้อมูลนี้จะรวมอยู่เฉพาะในการแจ้งเตือน Webhook ที่ส่งไปยังแอพที่ส่งข้อความให้กับผู้ใช้

postback.referral

ข้อมูลเกี่ยวกับการดำเนินการของผู้ใช้ในการเข้าสนทนา

ข้อมูลคุณสมบัติ referral จะรวมอยู่ในการแจ้งเตือน Webhook เฉพาะในกรณีที่ผู้ใช้เริ่มการสนทนาโดยใช้อย่างใดอย่างหนึ่งต่อไปนี้ แล้วคลิก CTA เช่น ปุ่ม "เริ่มต้นใช้งาน"

  • ปลั๊กอินแชท
  • ลิงก์ m.me
  • โฆษณาที่คลิกไปยัง Messenger
  • คิวอาร์โค้ดบน Messenger
  • หน้าจอต้อนรับ

postback.referral.ref

ข้อมูลที่กำหนดเองที่เดิมทีส่งผ่านในพารามิเตอร์ ref ที่เพิ่มในลิงก์ m.me โดยระบบจะรองรับเฉพาะอักขระที่เป็นตัวอักษรและตัวเลข รวมถึงเครื่องหมาย -, _ และ = เท่านั้น

postback.referral.source

URL สำหรับการอ้างอิงนี้ สำหรับลิงก์ m.me ค่าของแหล่งที่มาจะเป็น “SHORTLINK” สำหรับการอ้างอิงจากโฆษณาการสนทนาใน Messenger ค่าของแหล่งที่มาจะเป็น "ADS"

postback.referral.type

ตัวระบุสำหรับการอ้างอิงนี้ สำหรับการอ้างอิงที่มาจากลิงก์ m.me ค่าจะเป็น "OPEN_THREAD" เสมอ

postback.title

ชื่อสำหรับการกระตุ้นให้ดำเนินการ (CTA) ที่ผู้ใช้คลิก

recipient.id

ID ของเพจ Facebook ของคุณ

sender.user_ref

ID ในการอ้างอิงสำหรับผู้ใช้ที่ดำเนินการ เช่น คลิก "เริ่มต้นใช้งาน" ปลั๊กอินแชท หรือรายการในเมนูถาวรที่ส่งข้อความ

timestamp

ประทับเวลาแบบ Unix สำหรับวันที่ระบบส่งการแจ้งเตือน Webhook ไปยังเซิร์ฟเวอร์ของคุณ

ดูเพิ่มเติม

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