เมนูถาวร

เอกสารนี้จะแสดงให้คุณเห็นวิธีเพิ่มเมนูถาวรลงในประสบการณ์การส่งข้อความของคุณโดยใช้โปรแกรม

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

ข้อกำหนด

หากต้องการให้เมนูถาวรปรากฏ จำเป็นต้องมีเงื่อนไขต่อไปนี้:

• บุคคลนั้นต้องใช้งาน Messenger เวอร์ชั่น 106 ขึ้นไปบน iOS หรือ Android
• เพจ Facebook ที่บอท Messenger ติดตามข้อมูลต้องได้รับการเผยแพร่แล้ว
• บอท Messenger ต้องได้รับการตั้งค่าเป็น "สาธารณะ" ในการตั้งค่าแอพ
• บอท Messenger ต้องมีสิทธิ์การอนุญาต pages_messaging
• บอท Messenger ต้องมีชุดปุ่มเริ่มต้นใช้งาน

ปุ่มที่รองรับ

เมนูถาวรประกอบด้วยอาร์เรย์ปุ่มต่างๆ ซึ่งประเภทปุ่มต่อไปนี้รองรับอยู่ในเมนูถาวร

• web_url: ระบุว่ารายการนั้นๆ เป็นปุ่ม URL
• postback: ระบุว่ารายการนั้นๆ เป็นปุ่มโพสต์ย้อนกลับ

การตั้งค่าเมนูถาวร

หากต้องการตั้งค่าเมนูถาวร ให้ส่งคำขอ POST ไปยัง API โปรไฟล์ Messenger เพื่อตั้งค่าคุณสมบัติ persistent_menu ของโปรไฟล์ Messenger ของบอทคุณ

เราอนุญาตให้มีปุ่มได้มากถึง 20 ปุ่มในอาร์เรย์ call_to_actions สำหรับ API กราฟ เวอร์ชั่น 8.0 ขึ้นไป เพื่อเป็นการทดแทนเมนูระดับแบบซ้อนกันที่เลิกใช้แล้ว

{
    "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"
                }
            ]
        }
    ]
}

เมนูถาวรแบบซ้อนกัน

การปิดใช้งานช่องเขียนข้อความ

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

ในการดำเนินการนี้ ให้ตั้งค่า "composer_input_disabled":true ขณะที่คุณสร้างเมนูถาวร

การแปลเป็นภาษาท้องถิ่น

คุณสามารถระบุข้อความปุ่มของเมนูถาวรทั้งภาษาเริ่มต้นและภาษาท้องถิ่นได้ ซึ่งการแสดงผลจะเป็นไปตามรูปแบบภาษาของผู้ใช้

ในการดำเนินการนี้ ให้ระบุอ็อบเจ็กต์แยกต่างหากในอาร์เรย์ persistent_menu สำหรับแต่ละรูปแบบภาษา ในการระบุรูปแบบภาษาสำหรับแต่ละอ็อบเจ็กต์ ให้ตั้งค่าคุณสมบัติ locale เป็นรูปแบบภาษาที่รองรับดังนี้

{
  "locale":"default",
  "call_to_actions":[...]
},
{
  "locale: "zh_CN",
  "call_to_actions":[...]
}

เมนูระดับผู้ใช้

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

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

ในการเปิดหรือปิดใช้งานการตั้งค่าระดับผู้ใช้ ระบบจะใช้ตำแหน่งข้อมูลอื่นที่ชื่อว่า custom_user_settings ซึ่งตำแหน่งข้อมูลนี้รองรับการเรียกใช้ POST, GET และ DELETE

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

หมายเหตุ: ระบบจะอัพเดตเมนูถาวรระดับผู้ใช้แบบเรียลไทม์ ในขณะที่การอัพเดตเมนูถาวรระดับเพจอาจใช้เวลาถึง 24 ชั่วโมง

การตั้งค่าระดับผู้ใช้จะมีการจำกัดอัตราอยู่ที่เรียกใช้ 10 ครั้งต่อผู้ใช้ต่อ 10 นาที

ตัวอย่างคำขอ POST

การดำเนินการนี้จะแทนที่การตั้งค่าระดับเพจในปัจจุบันของผู้ใช้รายนี้

curl -X POST -H "Content-Type: application/json" -d '{
  "psid": "<PSID>",
  "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"
                }
            ]
        }
    ]
}' "https://graph.facebook.com/v19.0/me/custom_user_settings?access_token=<PAGE_ACCESS_TOKEN>"

ตัวอย่างคำขอ GET

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

curl -X GET "https://graph.facebook.com/v19.0/me/custom_user_settings?psid=<PSID>&access_token=<PAGE_ACCESS_TOKEN>"

ผลลัพธ์

{
    "data": [
      {
        "user_level_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"
                  }
              ]
            }
        ],
        "page_level_persistent_menu": [
          Original Page Menu...
        ]  
      }
  ]
}

ตัวอย่างคำขอ DELETE

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

curl -X DELETE 'https://graph.facebook.com/v19.0/me/custom_user_settings?psid=<PSID>&params=[%22persistent_menu%22]&access_token=<PAGE_ACCESS_TOKEN>'

การปิดใช้งานเมนูต่อเนื่อง

มีบางกรณีที่ควรปิดใช้งานเมนูถาวรสำหรับบอทในปลั๊กอินแชท โดยเพิ่ม "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"
        }
      ]
    }
  ]
}

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

รายการเมนูสามารถสร้างตัวแสดงหน้าเว็บหรือโพสต์ย้อนกลับได้เช่นเดียวกับปุ่ม โปรดทราบว่าไม่มีการรองรับเมนูระดับรอง