การแจ้งเตือนแบบครั้งเดียว (เบต้า)

สรุป

API การแจ้งเตือนแบบครั้งเดียว (เบต้า) ของแพลตฟอร์ม Messenger ช่วยให้เพจสามารถขออนุญาตจากผู้ใช้ในการส่งข้อความติดตามผล 1 ข้อความ หลังจากผ่านช่วงเวลาการส่งข้อความ 24 ชั่วโมงไปแล้ว โดยระบบจะเสนอให้ผู้ใช้รับการแจ้งเตือนในครั้งต่อๆ ไป เมื่อผู้ใช้ขอให้มีการแจ้งเตือน เพจจะได้รับโทเค็นซึ่งเทียบได้กับสิทธิ์การอนุญาตในการส่งข้อความ 1 รายการไปยังผู้ใช้ โทเค็นดังกล่าวนี้สามารถใช้ได้เพียงครั้งเดียวและจะหมดอายุภายใน 1 ปีหลังจากสร้างขึ้นมา

สิทธิ์การอนุญาต

เพจที่สนใจใช้ API นี้จะต้องขอสิทธิ์การอนุญาต "การแจ้งเตือนแบบครั้งเดียว" ภายในส่วน "การส่งข้อความขั้นสูง" ของการตั้งค่าเพจ โดยเพจจะต้องยอมรับข้อกำหนดของเวอร์ชั่นเบต้า และจะได้รับสิทธิ์การอนุญาตหากเพจดังกล่าวมีคุณสมบัติตรงตามเกณฑ์ของเรา

เนื้อหา

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

การใช้งาน

• อย่าสร้างความสับสน หลอกลวง ฉ้อโกง ทำให้เข้าใจผิด สแปม หรือทำให้ผู้อื่นตกใจ ตรวจสอบให้แน่ใจว่าข้อความแจ้งและเนื้อหาของข้อความนั้นมีความเกี่ยวข้องกันอย่างชัดเจน เนื้อหาของคำขอในการส่งการแจ้งเตือนแบบครั้งเดียวและข้อความจะต้องเป็นไปตามมาตรฐานชุมชน
• เพจที่ได้รับคำติชมแง่ลบเป็นจำนวนมากจากผู้ใช้ หรือเพจที่สร้างความสับสน หลอกลวง ฉ้อโกง ทำให้เข้าใจผิด หรือสร้างความตกใจในเชิงลบแก่ผู้ใช้จะสูญเสียสิทธิ์การเข้าถึง API

การส่งคำขอเพื่อส่งการแจ้งเตือนแบบครั้งเดียว

เมื่อใช้ API การส่ง เพจจะสามารถส่งข้อความขออนุญาตส่งการแจ้งเตือนในรูปแบบเทมเพลตได้ โดยประเภทของเทมเพลตควรเป็น one_time_notif_req เนื้อความของคำขอจะเป็นไปตามรูปแบบมาตรฐานสำหรับเทมเพลตทุกประเภท พร้อมคุณสมบัติ message.attachment.payload ที่มีรายละเอียดประเภทและเนื้อหาสำหรับเทมเพลตแต่ละประเภทโดยเฉพาะ คุณจะสามารถปรับแต่งได้เฉพาะชื่อและเพย์โหลดของคำขอเท่านั้น ช่อง title จะจำกัดอักขระอยู่ที่ 65 ตัว

{
  "recipient": {
    "id":"

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

การส่งข้อความติดตามผล

หากต้องการส่งข้อความติดตามผล ให้ส่งคำขอ POST ไปที่ API การส่ง พร้อมกับ one_time_notif_token ที่ได้รับผ่าน Webhook และตั้งค่า message.text ในเนื้อหาคำขอ ดังนี้

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

หากต้องการส่งข้อความแบบสมบูรณ์ (Rich Message) ให้แทนที่ข้อความด้วยเนื้อหาแบบสมบูรณ์ (Rich Content) โปรดดูรายการประเภทข้อความที่รองรับทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับ API การส่งone_time_notif_token สามารถใช้ได้เพียงครั้งเดียวและจะไม่สามารถใช้งานได้หลังจากส่งข้อความสำเร็จแล้ว

เหตุการณ์ Webhook

เมื่อผู้ใช้ยินยอมที่จะรับการแจ้งเตือนเกี่ยวกับการอัพเดตบางอย่าง คุณจะได้รับเหตุการณ์ Webhook ที่มี payload และ one_time_notif_token คุณจะต้องจัดเก็บทั้งเพย์โหลดและโทเค็นเพื่อส่งข้อความติดตามผลเมื่อข้อมูลดังกล่าวพร้อมให้ใช้งาน โปรดทราบว่าจะไม่มี API แยกต่างหากในการสืบค้นรายการ one_time_notif_token ดังนั้นจึงเป็นเรื่องสำคัญที่คุณจะต้องประมวลผลและจัดเก็บข้อมูล Webhook ตามที่ได้รับ โทเค็นแต่ละรายการสามารถใช้ได้เพียงครั้งเดียวและจะหมดอายุภายใน 1 ปีหลังจากสร้างขึ้นมา

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

ข้อจำกัดและขีดจำกัด

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

คำถามที่พบบ่อย

คุณสามารถดูข้อมูลเพิ่มเติมได้ที่หน้าคำถามที่พบบ่อยของเรา