ข้อมูลอ้างอิงเกี่ยวกับ persistent_menu

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

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

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

ข้อกำหนด

หากต้องการใช้เมนูถาวร คุณต้องดำเนินการต่อไปนี้

รูปแบบ persistent_menu

ตัวอย่างเมนูถาวร

{
    "persistent_menu": [
        {
            "locale": "default",
            "composer_input_disabled": false,
            "call_to_actions": [
                {
                    "type": "postback",
                    "title": "Talk to an agent",
                    "payload": "CARE_HELP"
                },
                {
                    "type": "postback",
                    "title": "Outfit suggestions",
                    "payload": "CURATION"
                },
                {
                    "type": "web_url",
                    "title": "Shop now",
                    "url": "https://www.originalcoastclothing.com/",
                    "webview_height_ratio": "full"
                }
            ]
        }
    ]
}

คุณสมบัติ

คุณสมบัติ ประเภท คำอธิบาย

locale

สตริง

อาร์เรย์อ็อบเจ็กต์ที่กำหนดเมนูถาวรสำหรับภาษาต่างๆ จะแสดง เมนูที่มีคุณสมบัติ locale ที่ตรงกับภาษาของผู้ใช้


อย่างน้อยหนึ่งอ็อบเจ็กต์ในอาร์เรย์ persistent_menu จะต้องมีการระบุเฉพาะ "locale": "default" นี่คือเมนูที่เราจะกลับไปใช้หากไม่มีอ็อบเจ็กต์ที่มีคุณสมบัติ locale ที่ตรงกับภาษาของผู้ใช้


ดูรายการระบบภาษาที่รองรับ

composer_input_disabled

บูลีน

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


ค่าเริ่มต้นคือ false

disabled_surfaces

อาร์เรย์

อาร์เรย์ของชื่ออินเทอร์เฟซที่จะปิดใช้งานเมนูถาวร ขณะนี้เฉพาะ customer_chat_plugin เท่านั้นที่ได้รับการรองรับ

call_to_actions

อาร์เรย์<menu_item>

อาร์เรย์ของรายการเมนูระดับสูงสำหรับเมนูถาวร อนุญาตให้สูงสุด 3 รายการ รองรับสูงสุดสองเมนูที่ซ้อนกัน


ต้องระบุหาก "composer_input_disabled": true

คุณสมบัติ ประเภท คำอธิบาย

type

สตริง

ประเภทของรายการเมนู ค่าที่รองรับ คือ

title

สตริง

ชื่อที่แสดงบนรายการเมนู จำกัดอักขระ 30 ตัว

url

สตริง

URL ที่เปิดเมื่อแตะปุ่ม ต้องระบุหากเป็นประเภท web_url

payload

สตริง

ข้อมูลที่ระบบจะส่งกลับถึงคุณผ่าน Webhook เป็นเหตุการณ์ messaging_postbacks ต้องระบุหากเป็นประเภท postback จำกัดอักขระ 1,000 ตัว

webview_height_ratio

สตริง

ระบุหรือไม่ก็ได้ ความสูงของมุมมองเว็บ ค่าที่ถูกต้อง ได้แก่ compact, tall, full

messenger_extensions

บูลีน

ระบุหรือไม่ก็ได้ ต้องเป็น true หากประเภทรายการเป็น web_url และ SDK ส่วนขยายของ Messenger จะถูกใช้ในมุมมองเว็บ

fallback_url

สตริง

ระบุหรือไม่ก็ได้ URL ที่เปิดในมุมมองเว็บสำหรับไคลเอ็นต์ที่ไม่รองรับ SDK ส่วนขยายของ ถ้าไม่กำหนดส่วนนี้ url จะใช้เป็นตัวสำรอง สามารถระบุได้ก็ต่อเมื่อ "messenger_extensions": true

webview_share_button

สตริง

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

การปิดใช้งานเมนูถาวร

มีบางกรณีที่ควรปิดใช้งานเมนูถาวรสำหรับบอทในปลั๊กอินแชท โดยเพิ่ม "disabled_surfaces": ["CUSTOMER_CHAT_PLUGIN"] เมื่อตั้งค่าเมนูถาวร:

ตัวอย่างเพย์โหลด API โปรไฟล์ Messenger

{
  "persistent_menu":[
    {
      "locale":"default",
      "disabled_surfaces": ["CUSTOMER_CHAT_PLUGIN"],
      "composer_input_disabled": false,      
      "call_to_actions":[
        {
          "title":"My Account",
          "type":"postback",
          "payload":"PAYBILL_PAYLOAD"
        }
      ]
    }
  ]
}

ขีดจำกัดอัตรา

การเรียก API โปรไฟล์ Messenger ได้รับการจำกัดไว้ที่ 10 รายการต่อ 10 นาที ขีดจำกัดอัตรานี้เป็นขีดจำกัดต่อเพจ

โปรดทราบว่าการเรียกไปยัง เมนูระดับผู้ใช้ ได้รับการจำกัดการเรียก API ไว้ที่ 10 ครั้ง ต่อผู้ใช้ ต่อ 10 นาที ขีดจำกัดอัตรานี้เป็นขีดจำกัดต่อเพจ