เอกสารนี้จะแสดงให้คุณเห็นถึงวิธีส่งคำขอสิทธิ์การอนุญาตจากผู้ใช้เพื่อส่งข้อความทางการตลาด ข้อกำหนดและขีดจำกัดที่เฉพาะเจาะจงในการส่งคำขอ และวิธีสร้างและส่งคำขอสิทธิ์การอนุญาตเกี่ยวกับข้อความทางการตลาด
ความถี่ของข้อความ
เราจะเลิกใช้ notification_messages_frequency
นับตั้งแต่วันที่ 31 มกราคม 2023 และความถี่ของข้อความจะไม่จำเป็นอีกต่อไปเมื่อส่งคำขอให้เลือกรับข้อความทางการตลาด
notification_messages_frequency
ในการแจ้งเตือน Webhook ให้เลือกรับการส่งข้อความการหมดอายุของโทเค็นและการเลือกรับอีกครั้ง
ตั้งแต่วันที่ 10 สิงหาคม 2023 โทเค็นการแจ้งเตือนจะไม่หมดอายุอีกต่อไป ระบบจะไม่ส่งคำขอให้เลือกรับอีกครั้งและการแจ้งเตือนการเลือกไม่รับอีกต่อไป
ข้อความทางการตลาดช่วยให้เพจ Facebook หรือบัญชีมืออาชีพบน Instagram สามารถส่งข้อความนอกช่วงเวลาการส่งข้อความมาตรฐานสำหรับผู้ใช้ที่ได้ให้สิทธิ์การอนุญาตแก่คุณในการส่งข้อความ ข้อความทางการตลาดช่วยให้คุณสามารถสานสัมพันธ์กับผู้ใช้ที่สนใจในตัวคุณหรือธุรกิจของคุณได้
ข้อความทางการตลาดคือฟีเจอร์พรีเมียมรายการใหม่โดยเป็นตัวเลือกเสริม ซึ่งเราตั้งใจจะเรียกเก็บค่าบริการในอนาคต ขณะนี้ เราเรียกเก็บค่าบริการจากธุรกิจต่างๆ ในการส่งข้อความจาก WhatsApp Business API และรับฟังความเห็นของลูกค้าเพื่อเป็นแนวทางในการตัดสินใจรูปแบบการกำหนดราคาของเรา เราจะแจ้งลูกค้าและพาร์ทเนอร์ถึงการเปลี่ยนแปลงในช่วงทดลองใช้โดยมีประกาศล่วงหน้าในกรอบเวลาที่เพียงพอ
คุณต้องปฏิบัติตามนโยบายผู้พัฒนาที่เกี่ยวข้องทั้งหมดเมื่อใช้ข้อความทางการตลาดหรือฟีเจอร์อื่นๆ ของแพลตฟอร์ม Messenger
คุณสามารถส่งคำขอให้ผู้ใช้เลือกรับข้อความทางการตลาดได้ภายในช่วงเวลาการส่งข้อความมาตรฐานเท่านั้น โดยการดำเนินการเลือกรับข้อความทางการตลาดของผู้ใช้จะยังไม่เป็นการเริ่มนับช่วงเวลาการส่งข้อความมาตรฐานนี้
แอพและ/หรือประสบการณ์การส่งข้อความของคุณต้องไม่ได้รับความเห็นเชิงลบจากผู้ใช้มากเกินไป ความสามารถในการส่งข้อความอาจถูกจำกัดหรือยกเลิกหากเราประเมินได้ว่ามีความเห็นเชิงลบจากผู้ใช้จำนวนมากเกินเกี่ยวกับประสบการณ์การส่งข้อความจากแอพของคุณ
คุณต้องไม่ใช้ข้อความทางการตลาด รวมถึงคำขอให้เลือกรับข้อความ ในการส่งสแปมถึงผู้ใช้ ซึ่งรวมถึงการส่งคำขอให้เลือกรับข้อความที่สร้างขึ้นซ้ำไปยังผู้ใช้รายเดิมหรือไม่ว่าจะกี่รายก็ตามด้วยความถี่สูง และการสแปมประเภทอื่นๆ ที่ระบุไว้ในนโยบายผู้พัฒนาของเรา
คุณต้องเคารพข้อจำกัดที่เราได้กำหนดไว้เกี่ยวกับฟังก์ชั่นการทำงานของแพลตฟอร์ม Messenger และข้อความทางการตลาด เพื่อรักษาขอบเขตของบริการที่เรามอบให้แก่คุณ
title
เหมือนกันสำหรับการแจ้งเตือนจากเพจ Facebook หรือมี title
และ image_url
เหมือนกันสำหรับการแจ้งเตือนจากบัญชีมืออาชีพบน Instagramเนื่องจากเราพยายามปรับปรุงประสบการณ์ของผู้ใช้และธุรกิจให้ดีที่สุดอยู่เสมอ ข้อกำหนดและข้อจำกัดเหล่านี้จึงอาจเปลี่ยนแปลงได้
คุณควรส่งข้อความทางการตลาดที่เกี่ยวข้องและมีประโยชน์ให้แก่ผู้ใช้ได้ เพื่อสร้างประสบการณ์ผู้ใช้ที่มีคุณภาพสูงโดยดำเนินการดังต่อไปนี้
คำขอให้เลือกรับข้อความของคุณ ซึ่งรวมถึงชื่อและรูปภาพ จะครอบคลุมถึงข้อความทางการตลาดประเภทต่างๆ ที่ผู้ใช้พึงได้รับ เช่น การอัพเดตคำสั่งซื้อ การแนะนำสินค้า หรือข้อเสนอบางอย่าง
เมื่อส่งคำขอให้เลือกรับข้อความมากกว่า 1 คำขอไปยังผู้ใช้ คำขอให้เลือกรับข้อความแต่ละรายการควรจะระบุประเภทข้อความทางการตลาดต่างๆ ที่เจาะจงซึ่งผู้ใช้คาดว่าจะได้รับอย่างชัดเจน
ข้อความทางการตลาดควรมีความเกี่ยวข้องและปรับให้เหมาะกับกรณีการใช้งานที่ผู้ใช้มีแนวโน้มจะมองว่ามีประโยชน์
ผู้ใช้สามารถแสดงความเห็นเกี่ยวกับประสบการณ์การส่งข้อความของคุณ รวมไปถึงการบล็อกการส่งข้อความ ซึ่งอาจส่งผลให้เกิดข้อจำกัดในการใช้ข้อความทางการตลาดของคุณได้ คุณควรตรวจสอบคำขอให้เลือกรับข้อความและข้อความทางการตลาดอย่างสม่ำเสมอเพื่อดูว่าเป็นไปตามหลักปฏิบัติที่ดีที่สุดข้างต้นหรือไม่
มีผลกับโทเค็นข้อความการแจ้งเตือนที่สร้างขึ้นก่อนวันที่ 2 กุมภาพันธ์ 2023
ผู้ใช้จะต้องให้สิทธิ์การอนุญาต (เลือกรับ) เพื่อรับข้อความทางการตลาดจากเพจ Facebook หรือบัญชีมืออาชีพบน Instagram ของคุณ แพลตฟอร์ม Messenger เสนอวิธีการให้เลือกรับข้อความที่คุณใช้ได้อยู่หลายวิธี คุณสามารถสร้างคำขอให้เลือกรับข้อความไว้กับประสบการณ์การส่งข้อความดังต่อไปนี้ได้
m.me
– เมื่อผู้ใช้คลิกที่ลิงก์ m.me
บนเว็บไซต์ของคุณ, อีเมล, โพสต์บนโซเชียลมีเดีย และอื่นๆ อีกมากมาย
m.me
)
หากต้องการส่งคำขอให้เลือกรับข้อความทางการตลาด ให้ส่งคำขอ 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 message
attachment
จะต้องรวมอยู่ในคำขอ POST
ไปยังตำแหน่งข้อมูล /PAGE-ID/messages
สำหรับคำขอให้เลือกรับข้อความทางการตลาด
คุณสมบัติ | คำอธิบาย |
---|---|
template } | จำเป็นต้องระบุ ค่าต้องเป็น |
| เนื้อหาของข้อความทางการตลาดซึ่งประกอบด้วยประเภท เทมเพลต ชื่อเรื่อง ความถี่ข้อความ ตัวเลือกข้อความ และอื่นๆ อีกมาก สำหรับคำขอเลือกใช้ข้อความทางการตลาดนี้ |
elements อาร์เรย์ | จำเป็นต้องระบุสำหรับภาพสไลด์ อาร์เรย์ที่มีอ็อบเจ็กต์องค์ประกอบที่อธิบายถึงการเลือกรับ อ็อบเจ็กต์องค์ประกอบแต่ละรายการจะต้องมี |
image_aspect_ratio enum { HORIZONTAL , SQUARE } | อัตราส่วนกว้างยาวของรูปภาพ
|
image_url สตริง | URL ของรูปภาพที่จะแสดงในเทมเพลต |
notification_messages_frequency enum { DAILY, WEEKLY, MONTHLY } | เลิกใช้สำหรับโทเค็นที่สร้างขึ้นหลังจากวันที่ 2 กุมภาพันธ์ 2023 ค่าเริ่มต้นจะเป็น DAILY ความถี่ของข้อความสำหรับคำขอให้เลือกรับข้อความทางการตลาดนี้
|
notification_messages_cta_text enum { ALLOW, GET, GET_UPDATES, OPT_IN, SIGN_UP } | ข้อความที่ปรากฏอยู่บนปุ่มกระตุ้นให้ดำเนินการ
|
notification_messages_timezone สตริง | โซนเวลาสำหรับบุคคลที่เป็นผู้รับข้อความ |
payload สตริง | จำเป็นต้องระบุ ประเภทข้อความทางการตลาด เช่น การส่งข้อความเพื่อโปรโมทหรือการส่งข้อความการเปิดตัวสินค้า สำหรับคำขอเลือกใช้ข้อความทางการตลาด |
template_type enum { notification_messages } | จำเป็นต้องระบุ ค่าต้องเป็น |
title สตริง | ชื่อที่จะแสดงในเทมเพลต โดยต้องมีอักขระไม่เกิน 65 ตัว หากไม่มีการกำหนดค่าเอาไว้ ระบบจะใช้ค่าเริ่มต้นเป็น "ข้อมูลอัพเดตและโปรโมชั่น" |
เมื่อผู้ใช้เลือกรับ ธุรกิจของคุณจะได้รับการแจ้งเตือน Webhooks messaging_optin
พร้อมโทเค็นข้อความการแจ้งเตือนและข้อมูลต่างๆ เช่น ชื่อของข้อความและโซนเวลาของผู้ใช้ที่เลือกรับ โทเค็นข้อความการแจ้งเตือนจะช่วยให้คุณสามารถส่งข้อความทางการตลาดให้กับผู้ใช้ได้
{ "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 เหล่านี้จะนับรวมอยู่ในขีดจำกัดอัตราของแอพคุณ
คุณจำเป็นต้องมีดังต่อไปนี้
MESSAGING
บนเพจได้pages_messaging
ที่ใช้การเข้าสู่ระบบด้วย Facebookmessaging_referrals
สำหรับแอพของคุณหากต้องการส่งข้อความทางการตลาด ให้ส่งคำขอ POST
ไปยังตำแหน่งข้อมูล /PAGE-ID/messages
พร้อมทั้งค่า NOTIFICATION-MESSAGES-TOKEN
ของผู้รับและข้อมูลของข้อความในไฟล์แนบของข้อความ
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" }
คุณสามารถทดสอบข้อความทางการตลาดได้ทุกเมื่อ
คุณจำเป็นต้องมีดังต่อไปนี้
คุณสามารถทดสอบข้อความทางการตลาดของคุณได้ทุกเมื่อโดยทำตามขั้นตอนต่อไปนี้
developer_action
เป็น ENABLE_FOLLOWUP_MESSAGE
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