ข้อความทางการตลาด

(หรือที่เรียกว่าการแจ้งเตือนประจำ)

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

การเปลี่ยนแปลงที่จะเกิดขึ้น

เราจะเลิกใช้ข้อความทางการตลาด (หรือที่เรียกว่าการแจ้งเตือนประจำ) บน Messenger ในวันที่ 10 กุมภาพันธ์ 2026

ตั้งแต่วันที่ 1 กันยายน 2025 ข้อความทางการตลาด (หรือที่เรียกว่าการแจ้งเตือนประจำ) จะมีข้อจำกัดดังต่อไปนี้

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

คำแนะนำเกี่ยวกับการย้ายระบบ

ตั้งแต่วันที่ 1 กรกฎาคม 2025 เป็นต้นไป พาร์ทเนอร์ทั่วโลกสามารถผสานการทำงานกับข้อความทางการตลาดใหม่บน Messenger API พาร์ทเนอร์และลูกค้าปลายทางควรเปลี่ยนไปใช้ข้อความทางการตลาดใหม่บน Messenger API ภายในปี 2025

ภาพรวม

ข้อความทางการตลาดช่วยให้เพจ Facebook หรือบัญชีมืออาชีพบน Instagram สามารถส่งข้อความนอกช่วงเวลาการส่งข้อความมาตรฐานสำหรับผู้ใช้ที่ได้ให้สิทธิ์การอนุญาตแก่คุณในการส่งข้อความ ข้อความทางการตลาดช่วยให้คุณสามารถสานสัมพันธ์กับผู้ใช้ที่สนใจในตัวคุณหรือธุรกิจของคุณได้

ข้อความทางการตลาดคือฟีเจอร์พรีเมียมรายการใหม่โดยเป็นตัวเลือกเสริม ซึ่งเราตั้งใจจะเรียกเก็บค่าบริการในอนาคต ขณะนี้ เราเรียกเก็บค่าบริการจากธุรกิจต่างๆ ในการส่งข้อความจาก WhatsApp Business API และรับฟังความเห็นของลูกค้าเพื่อเป็นแนวทางในการตัดสินใจรูปแบบการกำหนดราคาของเรา เราจะแจ้งลูกค้าและพาร์ทเนอร์ถึงการเปลี่ยนแปลงในช่วงทดลองใช้งานฟรีโดยมีประกาศล่วงหน้าในกรอบเวลาที่เพียงพอ

ข้อกำหนด

  • คุณต้องปฏิบัติตามนโยบายผู้พัฒนาที่เกี่ยวข้องทั้งหมดเมื่อใช้ข้อความทางการตลาดหรือฟีเจอร์อื่นๆ ของแพลตฟอร์ม Messenger

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

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

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

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

ข้อจำกัด

  • คุณสามารถส่งคำขอให้เลือกรับข้อความให้กับผู้ใช้ได้เพียง 1 คำขอต่อสัปดาห์โดยมีหัวข้อที่เฉพาะเจาะจงแบบเดียวกัน ซึ่งรวมถึงค่าเริ่มต้นเป็น "ข้อมูลอัพเดตและโปรโมชั่น"
  • อย่าส่งคำขอให้เลือกรับข้อความซ้ำให้กับผู้ใช้ คำขอให้เลือกรับข้อความซ้ำคือคำขอที่มี title เหมือนกันสำหรับการแจ้งเตือนจากเพจ Facebook หรือมี title และ image_url เหมือนกันสำหรับการแจ้งเตือนจากบัญชีมืออาชีพบน Instagram
  • คุณสามารถส่งคำขอให้เลือกรับข้อความได้ในระหว่างช่วงเวลาการส่งข้อความมาตรฐานเท่านั้น
  • หากผู้ใช้เลือกรับข้อความทางการตลาด การดำเนินการนี้จะไม่เป็นการเริ่มนับช่วงเวลาการส่งข้อความมาตรฐาน
  • คุณสามารถดูได้เฉพาะว่าผู้ใช้เลือกรับข้อความทางการตลาดหรือไม่ แต่จะดูสถานะสำหรับคำขอให้เลือกรับข้อความที่รอดำเนินการอยู่ไม่ได้
  • หากผู้ใช้ได้เลือกที่จะหยุดรับข้อความทางการตลาด การแจ้งเตือนของคุณจะไปไม่ถึงผู้ใช้รายนั้นอีกต่อไป และคุณจะได้รับข้อผิดพลาด
  • ผู้ใช้สามารถบล็อก ปิด หรือรายงานการส่งข้อความของคุณได้
  • สำหรับข้อความทางการตลาดที่ส่งจากบัญชีมืออาชีพบน Instagram โดยทั่วไปแล้ว คุณจะส่งคำขอให้เลือกรับข้อความได้สูงสุด 10 คำขอสำหรับชื่อที่แตกต่างกันต่อผู้ใช้ 1 รายในช่วงระยะเวลา 7 วัน โดยการส่งคำขอให้เลือกรับข้อความไปยังผู้ใช้รายหนึ่งๆ จะมีขีดจำกัดที่ส่งได้ไม่เกิน 5 คำขอต่อหนึ่งวัน อย่างไรก็ตาม คุณควรพิจารณาว่าผู้ใช้มีแนวโน้มที่จะคิดว่าคำขอให้เลือกรับข้อความแต่ละรายการนั้นมีความเกี่ยวข้องและมีประโยชน์หรือไม่ก่อนที่จะส่งคำขอนั้น

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

หลักปฏิบัติที่ดีที่สุด

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

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

  • เมื่อส่งคำขอให้เลือกรับข้อความมากกว่า 1 คำขอไปยังผู้ใช้ คำขอให้เลือกรับข้อความแต่ละรายการควรจะระบุประเภทข้อความทางการตลาดต่างๆ ที่เจาะจงซึ่งผู้ใช้คาดว่าจะได้รับอย่างชัดเจน

ข้อความทางการตลาดควรมีความเกี่ยวข้องและปรับให้เหมาะกับกรณีการใช้งานที่ผู้ใช้มีแนวโน้มจะมองว่ามีประโยชน์

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

ระยะเวลารอคอยในการส่งข้อความ

ระยะเวลารอคอยในการส่งข้อความ subscription_token คือ 24 ชั่วโมง ซึ่งหมายความว่าข้อความทางการตลาดที่ส่งโดยใช้ subscription_token เดียวกันต้องมีช่วงเวลา 24 ชั่วโมงระหว่างการส่งแต่ละครั้ง

ตั้งแต่วันที่ 1 กันยายน 2025 ระยะเวลารอคอยในการส่งข้อความ subscription_token จะเปลี่ยนจากการอนุญาตให้ส่งได้ 1 ครั้งต่อสมาชิก 1 รายทุก 24 ชั่วโมงเป็นส่งได้ 1 ครั้งในทุก 48 ชั่วโมง

มีผลกับโทเค็นข้อความการแจ้งเตือนที่สร้างขึ้นก่อนวันที่ 2 กุมภาพันธ์ 2023

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

ส่งคำขอสิทธิ์การอนุญาตส่งข้อความทางการตลาด

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

ตัวอย่างคำขอให้เลือกรับข้อความ

หากต้องการส่งคำขอให้เลือกรับข้อความทางการตลาด ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messages โดยตั้งค่าประเภทเทมเพลตข้อความเป็น notification_messages ID เพจคือ ID สำหรับเพจ Facebook ของคุณหรือเพจ Facebook ซึ่งลิงก์กับบัญชีมืออาชีพบน Instagram ของคุณ

หมายเหตุ: คุณต้องระบุพารามิเตอร์ title สำหรับข้อความทางการตลาดที่มีภาพสไลด์จากเพจ Facebook หรือบัญชีมืออาชีพบน Instagram ของคุณ

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้พร้อม ID ของผู้รับและข้อความ

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

ข้อมูลอ้างอิงเกี่ยวกับอ็อบเจ็กต์ไฟล์แนบของข้อความ

อ็อบเจ็กต์ JSON messageattachment จะต้องรวมอยู่ในคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messages สำหรับคำขอให้เลือกรับข้อความทางการตลาด

พร็อพเพอร์ตี้คำอธิบาย

type

enum { template }

จำเป็นต้องระบุ ค่าต้องเป็น template

payload

อ็อบเจ็กต์

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

elements
อาร์เรย์

จำเป็นต้องระบุสำหรับภาพสไลด์ อาร์เรย์ที่มีอ็อบเจ็กต์องค์ประกอบที่อธิบายถึงการเลือกรับ อ็อบเจ็กต์องค์ประกอบแต่ละรายการจะต้องมี payload และ notification_messages_frequency และอาจมี title, image_url และ notification_messages_reoptin แบบกำหนดเองรวมอยู่ด้วย ระบบรองรับองค์ประกอบต่ำสุด 1 รายการ และสูงสุด 5 รายการ

image_aspect_ratio
enum { HORIZONTAL, SQUARE }

อัตราส่วนกว้างยาวของรูปภาพ

  • SQUARE – แสดงรูปภาพแบบสี่เหลี่ยมจัตุรัส (1:1) ระบบจะครอบตัดรูปภาพหากจำเป็น
  • HORIZONTAL – แสดงรูปภาพแบบแนวนอน (1.91:1) ระบบจะครอบตัดรูปภาพหากจำเป็น
image_url
สตริง

URL ของรูปภาพที่จะแสดงในเทมเพลต

notification_messages_frequency
enum { DAILY, WEEKLY, MONTHLY }

เลิกใช้สำหรับโทเค็นที่สร้างขึ้นหลังจากวันที่ 2 กุมภาพันธ์ 2023 ค่าเริ่มต้นจะเป็น DAILY ความถี่ของข้อความสำหรับคำขอให้เลือกรับข้อความทางการตลาดนี้

  • DAILY – เลือกรับการแจ้งเตือน 1 ครั้งต่อช่วงเวลา 24 ชั่วโมง
  • WEEKLY – เลือกรับการแจ้งเตือน 1 ครั้งต่อช่วงเวลา 7 วัน
  • MONTHLY – เลือกรับการแจ้งเตือน 1 ครั้งต่อช่วงเวลา 1 เดือน
notification_messages_cta_text
enum { ALLOW, GET, GET_UPDATES, OPT_IN, SIGN_UP }

ข้อความที่ปรากฏอยู่บนปุ่มกระตุ้นให้ดำเนินการ

  • ALLOW – ตั้งค่าข้อความบนปุ่มเลือกรับข้อความเป็น "อนุญาตข้อความ"
  • GET – ตั้งค่าข้อความบนปุ่มเลือกรับข้อความเป็น "รับข้อความ"
  • GET_UPDATES – ตั้งค่าข้อความบนปุ่มเลือกรับข้อความเป็น “รับข้อความ” โดยค่านี้ยังเป็นค่าเริ่มต้นอีกด้วยหากไม่ได้ตั้งค่า notification_messages_cta_text ไว้
  • OPT_IN – ตั้งค่าข้อความบนปุ่มเลือกรับข้อความเป็น "เลือกรับข้อความ"
  • SIGN_UP – ตั้งค่าข้อความบนปุ่มเลือกรับข้อความเป็น "สมัครรับข้อความ"
notification_messages_timezone
สตริง

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

payload
สตริง

จำเป็นต้องระบุ ประเภทข้อความทางการตลาด เช่น การส่งข้อความเพื่อโปรโมทหรือการส่งข้อความการเปิดตัวสินค้า สำหรับคำขอเลือกใช้ข้อความทางการตลาด

template_type
enum { notification_messages }

จำเป็นต้องระบุ ค่าต้องเป็น notification_messages

title
สตริง

ชื่อที่จะแสดงในเทมเพลต โดยต้องมีอักขระไม่เกิน 65 ตัว หากไม่มีการกำหนดค่าเอาไว้ ระบบจะใช้ค่าเริ่มต้นเป็น "ข้อมูลอัพเดตและโปรโมชั่น"

โทเค็นข้อความการแจ้งเตือน

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

การแจ้งเตือน Webhook ให้เลือกรับ

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

เนื้อหาต่อไปนี้จะมีผลเฉพาะกับโทเค็นข้อความการแจ้งเตือนที่มีความถี่แบบรายสัปดาห์หรือรายเดือนซึ่งสร้างขึ้นก่อนวันที่ 2 กุมภาพันธ์ 2023

ระบบจะสร้างโทเค็นข้อความการแจ้งเตือนตามความถี่ในการส่งประจำ ตัวอย่างเช่น หากผู้ใช้เลือกรับข้อความทางการตลาดทั้งแบบรายวันและรายสัปดาห์ ระบบก็จะสร้างโทเค็นข้อความการแจ้งเตือนขึ้นมา 2 รายการแยกกัน แต่หากผู้ใช้เลือกรับข้อความทางการตลาดแบบรายวัน รายสัปดาห์ และรายเดือน ระบบจะสร้างโทเค็นข้อความการแจ้งเตือนขึ้นมา 3 รายการแยกกัน

ความถี่ข้อความทางการตลาดคำอธิบาย

รายสัปดาห์

คุณสามารถส่งข้อความได้เพียง 1 รายการและ 1 ครั้งในทุกๆ สัปดาห์ตามปฏิทินเท่านั้น โดย 1 สัปดาห์จะนับตั้งแต่วันจันทร์เวลา 00:00 น. จนถึงวันอาทิตย์เวลา 23:59 น. ในโซนเวลาที่เพจตั้งค่าไว้

รายเดือน

คุณสามารถส่งข้อความได้เพียง 1 รายการและ 1 ครั้งในทุกๆ เดือนตามปฏิทินเท่านั้น โดย 1 เดือนจะนับตั้งแต่วันแรกของเดือนในเวลา 00:00 น. จนถึงวันสุดท้ายของเดือนในเวลา 23:59 น. ในโซนเวลาที่เพจตั้งค่าไว้

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

ข้อความติดตามผลให้เลือกรับ

ทันทีที่ผู้ใช้เลือกรับข้อความทางการตลาด คุณจะสามารถส่งข้อความติดตามผลได้สูงสุด 3 ข้อความ โดยคุณจะต้องส่งข้อความเหล่านี้ภายใน 2 นาทีนับตั้งแต่ข้อความติดตามผลรายการแรก โดยข้อความรายการที่ 2 และ 3 ต้องมีอักขระไม่เกิน 250 ตัว ข้อความติดตามผลเหล่านี้สามารถส่งนอกกรอบเวลาส่งข้อความแบบ 24 ชั่วโมงตามมาตรฐานได้

หากต้องการส่งข้อความติดตามผล ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messages พร้อมอ็อบเจ็กต์ recipient ที่มีโทเค็นข้อความการแจ้งเตือนและอ็อบเจ็กต์ message ที่มีข้อความสำหรับข้อความติดตามผล ทั้งนี้ รูปแบบคำสั่งของคำขอ API สำหรับข้อความติดตามผลทั้ง 3 ข้อความจะเหมือนกัน

ตัวอย่างคำขอ

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

เรียกดูรายการโทเค็น

หากต้องการเรียกดูรายการโทเค็นข้อความการแจ้งเตือนที่ถูกต้องทั้งหมด ให้ส่งคำขอ GET ไปยังตำแหน่งข้อมูล /PAGE-ID/notification_message_tokens

ตัวอย่างคำขอ

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

รายการโทเค็นสูงสุด 25 รายการจะถูกส่งคืนตามค่าเริ่มต้น และเรียงลำดับตามเวลาที่อัพเดต หากต้องการอ่านเพิ่มเติม คุณสามารถเพิ่มพารามิเตอร์ limit เข้าไปได้ ปัจจุบันสามารถส่งคืนโทเค็นได้สูงสุด 100 รายการ คุณสามารถใช้พารามิเตอร์ after สำหรับการแบ่งหน้า แต่ไม่สามารถใช้พารามิเตอร์ before ได้

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

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

เรียกดูข้อมูลโทเค็น

แม้เราจะแนะนำให้ใช้ Webhook messaging_optin เพื่อรวบรวมข้อมูลข้อความทางการตลาด แต่คุณก็สามารถส่งคำขอ GET ไปยังตำแหน่งข้อมูลของโทเค็น ซึ่งมีการนำโทเค็นของคุณไปต่อท้าย notification_messages_ กล่าวคือ notification_messages_NOTIFICATION-MESSAGES-TOKEN เพื่อเรียกดูข้อมูลโทเค็นได้

ตัวอย่างคำขอ

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

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

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

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

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

ก่อนเริ่มต้น

คุณจะต้องมีสิ่งต่อไปนี้

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

หากต้องการส่งข้อความทางการตลาด ให้ส่งคำขอ POST ไปยังตำแหน่งข้อมูล /PAGE-ID/messages พร้อมทั้งค่า NOTIFICATION-MESSAGES-TOKEN ของผู้รับและข้อมูลของข้อความในไฟล์แนบของข้อความ

ข้อจำกัด

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

คำแนะนำ

  • เราขอแนะนำอย่างยิ่งให้อ้างอิงตามโซนเวลาของผู้รับเมื่อส่งข้อความทางการตลาด เพื่อให้แน่ใจว่าผู้รับจะได้รับข้อความในเวลาที่เหมาะสม

ตัวอย่างคำขอ

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

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

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

ทดสอบข้อความทางการตลาด

คุณสามารถทดสอบข้อความทางการตลาดได้ทุกเมื่อ

ก่อนเริ่มต้น

คุณจะต้องมีสิ่งต่อไปนี้

  • ผู้ใช้ซึ่งเป็นผู้ทดสอบที่จะรับการแจ้งเตือน โดยผู้ใช้รายนี้จะต้องมีบทบาทในแอพ

ทดสอบการเลือกรับ

คุณสามารถทดสอบข้อความทางการตลาดของคุณได้ทุกเมื่อโดยทำตามขั้นตอนต่อไปนี้

  • ขั้นตอนที่ 1 ส่งข้อความที่มีเทมเพลตในการเลือกรับข้อความทางการตลาดให้กับผู้ทดสอบ
  • ขั้นตอนที่ 2 ตรวจสอบว่าผู้ทดสอบคลิกที่ปุ่มเลือกรับ เช่น รับข้อความเกี่ยวกับการลดราคา 50% ในการสนทนา
  • ขั้นตอนที่ 3 ส่งข้อความทางการตลาดแรกไปยังผู้ทดสอบของคุณ
  • ขั้นตอนที่ 4 ส่งข้อความทางการตลาดอีกรายการหนึ่งหลังจากรายการแรกในทันที โดยตั้งค่าพารามิเตอร์ developer_action เป็น ENABLE_FOLLOWUP_MESSAGE
  • ขั้นตอนที่ 5 ส่งข้อความทางการตลาดอีกรายการหนึ่งให้กับผู้ทดสอบ โดยข้อความนี้คือข้อความทดสอบของคุณ

ตัวอย่างคำขอ

มีการจัดรูปแบบเพื่อให้อ่านได้ง่าย
curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

เมื่อดำเนินการสำเร็จ แอพของคุณจะได้รับการตอบกลับแบบ JSON ดังต่อไปนี้ ซึ่งมีการตั้งค่า success เป็น true

{ "success": true }

หากต้องการทดสอบการเลือกรับอีกครั้ง ให้ทำขั้นตอนดังกล่าวซ้ำ โดยตั้งค่าพารามิเตอร์ developer_action เป็น SEND_RE_OPTIN ในขั้นตอนที่ 4

ขั้นตอนถัดไป

ดูเพิ่มเติม

การสนับสนุนสำหรับผู้พัฒนา