ข้อมูลอ้างอิงเกี่ยวกับเหตุการณ์ Webhook

เหตุการณ์ Webhook คือวิธีที่แพลตฟอร์ม Messenger แจ้งเตือนบอทของคุณเมื่อมีการโต้ตอบหรือเหตุการณ์ต่างๆ เกิดขึ้น ซึ่งรวมถึงเวลาที่มีคนส่งข้อความเข้ามา แพลตฟอร์ม Messenger จะส่งเหตุการณ์ Webhook เป็นคำขอ POST ไปยัง Webhook ของคุณ

หมายเหตุ: คุณจะต้องให้แอพส่งข้อความทั้งหมดสำหรับธุรกิจของคุณสมัครรับข้อมูล Webhooks การส่งข้อความ

รายการเหตุการณ์ Webhook

ด้านล่างนี้คือรายการของเหตุการณ์ที่ระบบสามารถส่งจากแพลตฟอร์ม Messenger ให้ Webhook ของคุณได้

หมายเหตุ: เราขอแนะนำให้คุณใช้ API เวอร์ชั่นล่าสุดเพื่อรับข้อมูลทั้งหมดที่มีสำหรับ Webhook แต่ละรายการ

เหตุการณ์ Webhooksคำอธิบาย

messages

ลงทะเบียนเหตุการณ์ข้อความที่ได้รับ

messaging_account_linking

ลงทะเบียนเหตุการณ์การเชื่อมโยงบัญชีผู้ใช้

messaging_checkout_updates (เบตา)

ลงทะเบียนเหตุการณ์การอัพเดตการชำระเงิน

message_deliveries

ลงทะเบียนเหตุการณ์ข้อความที่ส่ง

message_echoes

ลงทะเบียนเหตุการณ์เอคโคข้อความ

messaging_game_plays

ลงทะเบียนเหตุการณ์เกมทันใจ

messaging_handovers (เบตา)

ลงทะเบียนเหตุการณ์โปรโตคอลการส่งมอบ

messaging_optins

สมัครใช้งานเหตุการณ์การรับปลั๊กอิน

messaging_payments (เบตา)

ลงทะเบียนเหตุการณ์การชำระเงิน

messaging_policy_enforcement

ลงทะเบียนเหตุการณ์การบังคับใช้นโยบาย

messaging_postbacks

ลงทะเบียนเหตุการณ์โพสต์ย้อนกลับที่ได้รับ

messaging_pre_checkouts (เบตา)

ลงทะเบียนเหตุการณ์ก่อนการชำระเงินสำหรับการชำระเงิน

message_reads

ลงทะเบียนเหตุการณ์อ่านข้อความแล้ว

messaging_referrals

ลงทะเบียนเหตุการณ์การอ้างอิง

standby (เบตา)

ลงทะเบียนเหตุการณ์ช่องทางรอใช้งานโปรโตคอลการส่งมอบ

รูปแบบเหตุการณ์

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

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

คุณสมบัติ

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

object

สตริง

ค่าจะเป็น page

entry

อาร์เรย์ของ entry

อาร์เรย์ที่มีข้อมูลเหตุการณ์

entry

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

id

สตริง

ID เพจของเพจ

time

ตัวเลข

เวลาที่อัพเดต (เวลา epoch ในหน่วยมิลลิวินาที)

messaging

อาร์เรย์<messaging>

อาร์เรย์ที่มีอ็อบเจ็กต์ messaging โปรดทราบว่าแม้นี่จะเป็นอาร์เรย์ แต่จะมีอ็อบเจ็กต์ messaging เพียง 1 รายการเท่านั้น

entry.messaging

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

sender.id

สตริง

ID ผู้ใช้ที่เป็นผู้ส่ง

recipient.id

สตริง

ID ผู้ใช้ที่เป็นผู้รับ

เรียนรู้เพิ่มเติม

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