ข้อมูลอ้างอิงเหตุการณ์ Webhook messaging_optins

เหตุการณ์ Webhook "Messaging Opt In" จะทริกเกอร์เมื่อผู้ใช้เลือกที่จะรับข้อความทางการตลาดหรือแตะที่ปลั๊กอิน "Send to Messenger"

เมื่อใช้ปลั๊กอิน "Send to Messenger" พารามิเตอร์ optin.refoptin.ref จะถูกตั้งค่าโดยช่อง data-refdata-ref บนปลั๊กอิน "Send to Messenger" ผู้พัฒนาสามารถใช้ช่องนี้เพื่อเชื่อมโยงเหตุการณ์การคลิกบนปลั๊กอินกับการเรียกกลับได้

การแจ้งเตือน Webhook "Message Opt In"

แอพของคุณจะได้รับการแจ้งเตือน Webhook ในการเลือกรับเมื่อมีสิ่งต่อไปนี้เกิดขึ้น

  • ผู้ใช้เลือกรับ
  • ผู้ใช้เลือกรับอีกครั้งโดยการคลิกที่ปุ่ม "รับการแจ้งเตือนข้อความต่อไป" ซึ่งจะแสดงขึ้นก่อนที่โทเค็นข้อความการแจ้งเตือนจะหมดอายุ
  • ผู้ใช้เปลี่ยนสถานะการเลือกรับของตน หยุดการแจ้งเตือน หรือกลับมารับการแจ้งเตือนอีกครั้ง
{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "payload": "ADDITIONAL-INFORMATION",
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_frequency": "FREQUENCY",  
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS",  
    "notification_messages_status": "NOTIFICATION-STATUS",
    "title": "TITLE" 
    }
}

optin

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

payload

สตริง

ข้อมูลเพิ่มเติมที่คุณต้องการนำมารวมไว้ในการแจ้งเตือน Webhooks

title

สตริง

ชื่อที่แสดงในเทมเพลต

notification_messages_token

สตริง

โทเค็นที่แสดงถึงบุคคลที่เลือกรับ โดยมีหัวข้อและความถี่ของข้อความเฉพาะ ซึ่งใช้ในการส่งข้อความทางการตลาด

notification_messages_frequency

enum { DAILY, WEEKLY, MONTHLY }

ค่าสามารถเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • DAILY - ส่งการแจ้งเตือน 1 ครั้งต่อระยะเวลา 24 ชั่วโมงเป็นเวลา 6 เดือนนับจากวันที่เลือกรับ
  • WEEKLY - ส่งการแจ้งเตือน 1 ครั้งต่อสัปดาห์เป็นเวลา 9 เดือนนับจากวันที่เลือกรับ
  • MONTHLY - ส่งการแจ้งเตือน 1 ครั้งต่อเดือนเป็นเวลา 12 เดือนนับจากวันที่เลือกรับ

(นำออกแล้วใน API เวอร์ชั่น 16)

notification_messages_timezone

สตริง

โซนเวลาสำหรับผู้ใช้ที่เป็นผู้รับข้อความ

notification_messages_status

enum { STOP NOTIFICATIONS, RESUME NOTIFICATIONS }
ช่องนี้จะปรากฏเฉพาะเมื่อผู้ใช้หยุดรับหรือรับข้อความทางการตลาดต่อ

ค่าสามารถเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • STOP NOTIFICATIONS (หยุดการแจ้งเตือน) - ผู้ใช้คลิก "หยุดรับข้อความเหล่านี้"
  • RESUME NOTIFICATIONS (รับการแจ้งเตือนต่อ) - ผู้ใช้คลิก "รับข้อความเหล่านี้ต่อ"

token_expiry_timestamp

ประทับเวลา Unix

วันที่โทเค็นข้อความแจ้งเตือนหมดอายุ

type

สตริง

ค่าต้องเป็น notification_messages

user_token_status

enum { REFRESHED, NOT_REFRESHED }

ค่าสามารถเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • REFRESHED - จะมีการตั้งค่านี้เมื่อผู้ใช้เลือกรับข้อความทางการตลาดอีกครั้งหลังจากที่โทเค็นหมดอายุ
  • NOT_REFRESHED - เป็นค่าเริ่มต้นและจะมีการตั้งค่านี้เมื่อผู้ใช้ไม่เลือกรับข้อความทางการตลาดอีกครั้งหลังจากที่โทเค็นหมดอายุ