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

เอกสารนี้จะช่วยตอบข้อสงสัยที่พบได้บ่อยต่างๆ

ทั่วไป

แอพถูกติดตั้งจากเว็บไซต์ของแอพโดยใช้ การเข้าสู่ระบบด้วย Facebook และมอบสิทธิ์การอนุญาต pages_messaging ให้กับบางเพจ แอพที่ได้รับอนุญาตจะแสดงในการตั้งค่าเพจภายในการส่งข้อความขั้นสูง

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

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

กฎหมายคุ้มครองข้อมูลส่วนบุคคล (GDPR)

จุดเข้าใช้งาน

เมื่อใช้ปลั๊กอิน “ส่งไปยัง Messenger” คุณสามารถใช้พารามิเตอร์ data-ref เป็นพารามิเตอร์ส่งผ่านเพื่อส่งข้อมูลใดๆ ตามบริบทของการคลิกได้

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

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

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

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

  • Back in stock alerts
  • Collection launches
  • Concert tickets going on sale
  • Price drop alerts
  • Train tickets available for purchase
  • CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

ส่ง/รับ API

สิ่งนี้เกิดขึ้นจากหลายสาเหตุดังนี้

  • คุณกำลังใช้ ID จากการเข้าสู่ระบบด้วย Facebook ID จากการเข้าสู่ระบบด้วย Facebook ไม่ได้มีจุดมุ่งหมายเพื่อทำงานร่วมกับ API ส่ง/รับ เฉพาะ ID ผู้ใช้ที่ได้จากการยืนยันตัวตนด้วยแพลตฟอร์ม Messenger เท่านั้นที่จะทำงานร่วมกับแพลตฟอร์ม Messenger ได้
  • คุณกำลังใช้ ID กับโทเค็นการเข้าถึงเพจที่ไม่ถูกต้อง ID ผู้ใช้สำหรับแพลตฟอร์ม Messenger มีการจำกัดขอบเขตไว้ในเพจหนึ่งๆ ดังนั้นจึงมีลักษณะเฉพาะสำหรับเพจนั้น ถ้าคุณใช้ ID ผู้ใช้ที่ถูกต้องแต่ใช้กับโทเค็นการเข้าถึงเพจที่เชื่อมโยงกับเพจอื่น จะทำให้การเรียกใช้ไม่ทำงาน ต้องแน่ใจว่าใช้ ID ผู้ใช้ และโทเค็นการเข้าถึงเพจที่เชื่อมโยงกับหน้าเดียวกัน
  • คุณกำลังส่งไปยังหมายเลขโทรศัพท์มือถือที่ไม่ได้ผ่านการตรวจสอบยืนยันเมื่อไม่นานมานี้ เมื่อใช้ “API ส่ง” กับหมายเลขโทรศัพท์มือถือ เราจะส่งข้อความถ้าหมายเลขโทรศัพท์มือถือผ่านการตรวจสอบยืนยันไม่นานมานี้แล้วเท่านั้น แม้ว่าหมายเลขโทรศัพท์มือถือจะแสดงว่าได้ผ่านการตรวจสอบแล้ว แต่ไม่ได้ผ่านการตรวจสอบเมื่อไม่นานมานี้ จะทำให้ส่งไม่สำเร็จได้ ทำการตรวจสอบยืนยันหมายเลขโทรศัพท์มือถือของคุณใหม่ และรอ 24 ชั่วโมงจึงพยายามใหม่อีกครั้ง

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

  1. จากหน้าบทบาทในแอพของคุณ ให้สร้างผู้ใช้ขั้นทดสอบใหม่โดยการคลิกที่ปุ่ม “เพิ่ม”
  2. สลับเปิดปิดตัวเลือก “อนุญาตผู้ใช้ขั้นทดสอบสำหรับแอพนี้ไหม และให้สิทธิ์การอนุญาต “manage_pages” และ “page_messaging
  3. ใช้ปุ่มแก้ไขและใช้โทเค็นการเข้าถึงสำหรับผู้ใช้นี้ (ใช้ v2.6) กรุณาบันทึกไว้สำหรับครั้งต่อไป
  4. ใช้ปุ่ม “แก้ไข” เพื่อเข้าสู่ระบบแบบเป็นผู้ใช้ขั้นทดสอบ
  5. หลังจากทำการเข้าสู่ระบบ สร้างหน้าในฐานะผู้ใช้ขั้นทดสอบ
  6. ใช้โทเค็นการเข้าถึงของผู้ใช้สำหรับผู้ใช้ขั้นทดสอบเพื่อให้ได้โทเค็นการเข้าถึงเพจสำหรับผู้ใช้นี้ คุณสามารถทำได้ด้วยการเรียกคำสั่งต่อไปนี้
    https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]
    (เอกสารประกอบ)
  7. ใช้โทเค็นการเข้าถึงเพจนี้เพื่อลิงก์ Facebook แอพพลิเคชั่น ของคุณกับเพจของคุณ
    https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
            
    (เอกสารประกอบ)
  8. หลังจากคุณดำเนินการตามขั้นตอนเหล่านี้ คุณจะได้รับการอัพเดต RTU ที่หน้าทดสอบของคุณ และคุณจะสามารถรับส่งข้อความของผู้ใช้ขั้นทดสอบของคุณจากหน้าทดสอบของคุณได้ นอกเหนือจากข้างต้นแล้ว คุณสามารถแทนที่โทเค็นการเข้าถึงของคุณด้วยโทเค็นที่มีอายุการใช้งานนาน ถ้าหากว่าโทเค็นนั้นหมดอายุเร็วเกินไปสำหรับการทดสอบของคุณ กรุณาติดตามเอกสารประกอบที่นี่:
    GET /oauth/access_token?  
        grant_type=fb_exchange_token&           
        client_id={app-id}&
        client_secret={app-secret}&
        fb_exchange_token={short-lived-token} 
            

ได้ Bot สามารถใช้การรับส่งข้อความทั้งสองแบบได้ ผู้ใช้จะต้องทริกเกอร์การส่งข้อความแพลตฟอร์มมาตรฐานผ่านทริกเกอร์ใดทริกเกอร์หนึ่งที่มีสิทธิ์ และจะต้องเลือกรับการรับส่งข้อความที่มีการสมัครใช้งานด้วย

ในทางเทคนิคนั้น Bot จะไม่สามารถส่งข้อความไปยังผู้ใช้มากกว่าหนึ่งครั้งนอกช่วงเวลา 24 ชั่วโมงได้ (ข้อความจะไม่ถูกส่ง) ในระหว่างช่วงเปลี่ยน Bot ที่ใช้งานอยู่ ข้อความเหล่านี้จะส่งออกไปได้แต่จะมีการแจ้งปัญหาหากพบ

ไม่มี แพลตฟอร์ม Messenger ไม่มี API ที่ส่งกลับรายการ PSID ของทุกคนที่เลือกสมัครรับข้อความจากบอทคุณ

Webhooks

มี 2 ขั้นตอนในการรับการเรียกกลับ ขั้นตอนแรก คุณต้องแน่ใจว่า Webhook ของคุณได้ติดตั้งอย่างเหมาะสม (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). มีตัวบ่งชี้ว่า Webhook ได้รับการติดตั้งอย่างเหมาะสม

ขั้นตอนที่สอง คุณต้องสมัครรับข้อมูลในแต่ละเพจ ทุกเพจที่สมัครรับข้อมูลแล้วจะถูกบันทึกไว้

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

การเรียกไปยัง Webhook จะต้องมีการเติมข้อมูลในช่องกรอกข้อมูลในหัวข้อ X-Hub-Signature ซึ่งสามารถถูกนำไปใช้ในการยืนยันว่าเป็นการเรียกมาจาก Facebook

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

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

เรามีเครื่องมือที่จะแสดงข้อผิดพลาดล่าสุดของ Webhook ได้ โดยหากการส่งมอบ Webhooks ล้มเหลว เซิร์ฟเวอร์ของ Facebook จะเลิกรับข้อมูล URL ของคุณ หากต้องการค้นหาเครื่องมือ ให้ไปที่แดชบอร์ดของแอพ > การตั้งค่า จากนั้นในการ์ด Webhooks จะมีปุ่มแสดงข้อผิดพลาดล่าสุดอยู่

ดูเพิ่มเติม