Tài liệu tham khảo về `persistent_menu`

Bạn có thể đặt menu cố định cho bot của mình để giúp mọi người khám phá và dễ dàng truy cập chức năng thông qua cuộc trò chuyện.

Người dùng luôn truy cập được Menu cố định. Menu này sẽ bao gồm các hành động ở cấp cao nhất mà người dùng có thể thực hiện ở bất kỳ thời điểm nào. Khi có menu cố định, bạn sẽ dễ dàng thông báo những tính năng cơ bản của bot cho người dùng lần đầu và người dùng quay lại. Menu này sẽ tự động hiển thị trong chuỗi trò chuyện nếu người dùng đã vắng mặt một thời gian và quay lại. Cài đặt này là một phần trong Tài liệu tham khảo về API Trang cá nhân Messenger

Bạn cũng có thể đặt và thay đổi menu cố định ở cấp độ người dùng. Để biết thêm thông tin, hãy xem phần menu cấp độ người dùng.

Yêu cầu

Để sử dụng menu cố định, bạn phải đáp ứng các điều kiện sau:

Thiết lập nút bắt đầu.
Có vai trò "Quản trị viên" cho trang liên kết với bot.

Định dạng `persistent_menu`

Menu cố định mẫu

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

Thuộc tính

Thuộc tính	Loại	Mô tả
`locale`	Chuỗi	Một mảng gồm các đối tượng xác định menu cố định cho những ngôn ngữ khác nhau. Menu có thuộc tính `locale` khớp với ngôn ngữ của người dùng sẽ được hiển thị. Tối thiểu một đối tượng trong mảng `persistent_menu` phải chỉ định `"locale": "default"`. Đây là menu chúng tôi sẽ dùng để dự phòng nếu không có đối tượng nào có thuộc tính `locale` khớp với ngôn ngữ của người dùng. Hãy xem danh sách các ngôn ngữ được hỗ trợ.
`composer_input_disabled`	Boolean	Vô hiệu hóa trường trình biên soạn Messenger nếu đặt thành `true`. Nghĩa là người dùng chỉ có thể tương tác với bot của bạn qua menu cố định, yêu cầu đăng lại, nút và chế độ xem web. Giá trị mặc định là `false`.
`disabled_surfaces`	Mảng	Mảng tên giao diện để vô hiệu hóa menu cố định. Hiện chỉ hỗ trợ `customer_chat_plugin`.
`call_to_actions`	Mảng<`menu_item`>	Một mảng gồm các mục menu cấp cao nhất cho menu cố định. Cho phép tối đa 3 mục. Bắt buộc nếu `"composer_input_disabled": true`.

Đối tượng `menu_item`

Thuộc tính	Loại	Mô tả
`type`	Chuỗi	Loại mục menu. Giá trị được hỗ trợ là: `web_url`: Chỉ định mục là một nút URL. `postback`: Chỉ định mục là một nút yêu cầu đăng lại.
`title`	Chuỗi	Tiêu đề sẽ hiển thị trên mục menu. Giới hạn 30 ký tự.
`url`	Chuỗi	URL sẽ mở khi người dùng nhấn vào nút. Bắt buộc nếu loại là `web_url`.
`payload`	Chuỗi	Dữ liệu sẽ được gửi trở lại webhook của bạn dưới dạng sự kiện `messaging_postbacks`. Bắt buộc nếu loại là `postback`. Giới hạn 1000 ký tự.
`webview_height_ratio`	Chuỗi	*Không bắt buộc.* Chiều cao của chế độ xem web. Các giá trị hợp lệ bao gồm `compact`, `tall`, `full`.
`messenger_extensions`	Boolean	*Không bắt buộc.* Phải là `true` nếu loại mục là `web_url` và SDK Tiện ích Messenger sẽ được sử dụng trong chế độ xem web.
`fallback_url`	Chuỗi	*Không bắt buộc.* URL sẽ mở trong chế độ xem web cho các ứng dụng không hỗ trợ SDK Tiện ích Messenger. Nếu URL này không được xác định, `url` sẽ được dùng làm URL dự phòng. Bạn chỉ có thể chỉ định URL này nếu `"messenger_extensions": true`.
`webview_share_button`	Chuỗi	*Không bắt buộc.* Đặt thành `hide` để vô hiệu hóa chức năng chia sẻ trong chế độ xem web (đối với thông tin nhạy cảm).

Vô hiệu hóa menu cố định

Trong một số trường hợp, bạn nên tắt menu cố định cho bot của mình trong Plugin chat. Để thực hiện việc này, hãy thêm "disabled_surfaces": ["CUSTOMER_CHAT_PLUGIN"] khi bạn đặt menu cố định:

Phần tải dữ liệu API Trang cá nhân Messenger mẫu

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

Giới hạn tốc độ

Số lệnh gọi đến API Trang cá nhân Messenger được giới hạn ở 10 lệnh gọi API trong thời gian 10 phút. Giới hạn tốc độ này được thực thi trên mỗi Trang.

Lưu ý rằng số lệnh gọi đến menu cấp độ người dùng được giới hạn ở 10 lệnh gọi API/người dùng trong thời gian 10 phút. Giới hạn tốc độ này được thực thi trên mỗi Trang.

Tài liệu tham khảo về persistent_menu