ปุ่ม

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

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

ปุ่ม URL

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

ลิงก์ที่ไปยังแอพ

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

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

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

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

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

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

รูปแบบปุ่ม

โปรดดูรายการคุณสมบัติปุ่มทั้งหมดที่ข้อมูลอ้างอิงเกี่ยวกับปุ่ม 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 การเล่นเกมสำหรับเหตุการณ์ที่จะถูกส่งไปยังบอทเมื่อผู้ใช้เล่นเกมจบรอบ

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