ปุ่ม

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

สำหรับเทมเพลตข้อความ อ็อบเจ็กต์ในอาร์เรย์ buttons จะเป็นตัวกำหนดปุ่มต่างๆ สำหรับเมนูถาวร อ็อบเจ็กต์ในอาร์เรย์ call_to_actions จะเป็นตัวกำหนดปุ่มต่างๆ

ปุ่ม URL

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

หากเว็บไซต์นั้นๆ มีลิงก์ที่ไปยังแอพ ปุ่มดังกล่าวจะเปิดแอพแบบเนทีฟที่กำหนดไว้ขึ้นมา

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

การใช้งานที่รองรับ

การใช้งานต่อไปนี้รองรับปุ่ม URL:

  • เมนูถาวร
  • เทมเพลตทั่วไป
  • เทมเพลตรายการ
  • เทมเพลตปุ่ม
  • เทมเพลตสื่อ

SDK ส่วนขยายของ Messenger - การใส่โดเมนในไวท์ลิสต์ที่กำหนด

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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มโดเมนลงในไวท์ลิสต์ที่ข้อมูลอ้างอิง whitelisted_domains

รูปแบบปุ่ม

โปรดดูรายการคุณสมบัติปุ่มทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับปุ่ม URL

{
  "type": "web_url",
  "url": "

ปุ่มโพสต์ย้อนกลับ

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

การใช้งานที่รองรับ

ระบบรองรับการใช้งานปุ่มโพสต์ย้อนกลับร่วมกับสิ่งต่อไปนี้

  • เมนูถาวร
  • เทมเพลตทั่วไป
  • เทมเพลตรายการ
  • เทมเพลตปุ่ม
  • เทมเพลตสื่อ

รูปแบบปุ่ม

โปรดดูรายการคุณสมบัติปุ่มทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับปุ่มโพสต์ย้อนกลับ

{
  "type": "postback",
  "title": "

ปุ่มโทร

เมื่อแตะปุ่มโทรจะเป็นการโทรออกตามหมายเลขโทรศัพท์มือถือ หมายเลขโทรศัพท์ควรอยู่ในรูปแบบ +<COUNTRY_CODE><PHONE_NUMBER> เช่น +15105559999

การใช้งานที่รองรับ

การใช้งานต่อไปนี้สนับสนุนปุ่มโทร

  • เทมเพลตทั่วไป
  • เทมเพลตรายการ
  • เทมเพลตปุ่ม
  • เทมเพลตสื่อ

รูปแบบปุ่ม

โปรดดูรายการคุณสมบัติปุ่มทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับปุ่มโทร

{
  "type":"phone_number",
  "title":"

ปุ่มเข้าสู่ระบบ

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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ปุ่มเข้าสู่ระบบสำหรับการลิงก์บัญชีที่การลิงก์บัญชี

การใช้งานที่รองรับ

การใช้งานต่อไปนี้รองรับปุ่มเข้าสู่ระบบ

  • เทมเพลตทั่วไป
  • เทมเพลตรายการ
  • เทมเพลตปุ่ม
  • เทมเพลตสื่อ

รูปแบบปุ่ม

โปรดดูรายการคุณสมบัติปุ่มทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับปุ่มเข้าสู่ระบบ

{
  "type": "account_link",
  "url": "

ปุ่มออกจากระบบ

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

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ปุ่มออกจากระบบสำหรับการยกเลิกการลิงก์บัญชีที่การลิงก์บัญชี

การใช้งานที่รองรับ

การใช้งานต่อไปนี้รองรับปุ่มออกจากระบบ

  • เทมเพลตทั่วไป
  • เทมเพลตรายการ
  • เทมเพลตปุ่ม
  • เทมเพลตสื่อ

รูปแบบปุ่ม

โปรดดูรายการคุณสมบัติปุ่มทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับปุ่มออกจากระบบ

{
  "type": "account_unlink"
}

ปุ่มการเล่นเกม

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

รูปแบบปุ่ม

คุณสมบัติ payload ควรเป็น JSON ที่ผ่านการ Serialize แล้ว ซึ่ง SDK ของเกมทันใจทำให้เป็นค่าที่ไม่ Serialize

โปรดดูรายการคุณสมบัติปุ่มทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับปุ่มการเล่นเกม

{
  "type":"game_play",
  "title":"Play",
  "payload":"{<SERIALIZED_JSON_PAYLOAD>}",
  "game_metadata": { // Only one of the below
    "player_id": "<PLAYER_ID>",
    "context_id": "<CONTEXT_ID>"
  }
}

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

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

ใช้ปุ่มต่างๆ เพื่อเตือนการโต้ตอบที่ตามมาหรือการโต้ตามเพิ่มเติมด้วยข้อความเฉพาะ

เริ่มต้นด้วยคำกริยาเพื่อช่วยให้ผู้คนเข้าใจถึงการดำเนินการที่พวกเขากำลังจะทำ

ใช้ปุ่ม URL กับงานที่คุณต้องการให้มีการดำเนินการบนเว็บไซต์ของคุณ (เช่น การซื้อ การเชื่อมโยงบัญชีผู้ใช้ ฯลฯ) อธิบายอย่างชัดเจนว่าคุณกำลังจะส่งผู้คนออกไปนอก Messenger

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

อย่างใช้ปุ่มเมื่อการดำเนินการของผู้คนขึ้นอยู่กับสถานะปัจจุบันของบอทเนื่องจากปุ่มจะอยู่ในเธรดอย่างถาวร

ไม่ควรใช้คำเกิน 1-3 คำ หรือเพิ่มเครื่องหมายวรรคตอน พยายามให้ข้อความของคุณมีความยาวไม่เกิน 20 อักขระ รวมการเว้นวรรค

ไม่ควรใช้ URL กับปุ่มทั้งหมด ยิ่งคุณสามารถสร้างการโต้ตอบภายใน Messenger ได้มากเพียงใด ประสบการณ์การให้บริการของคุณก็จะราบรื่นมากเท่านั้น

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