Nền tảng Messenger

Mẫu chung

Mẫu chung là một tin nhắn có cấu trúc đơn giản – bao gồm tiêu đề, tiêu đề phụ, hình ảnh và tối đa 3 nút. Bạn cũng có thể chỉ định đối tượng default_action để đặt URL sẽ mở trong chế độ xem web trên Messenger khi nhấn vào mẫu.

Nội dung

Phần tải dữ liệu mẫu

Để biết danh sách đầy đủ các thuộc tính của mẫu, hãy xem tài liệu tham khảo về Mẫu chung.

"payload": {
  "template_type":"generic",
  "elements":[
     {
      "title":"

Nền tảng Messenger hỗ trợ gửi thẻ quay vòng gồm các mẫu chung có thể cuộn theo chiều ngang.

Để tạo thẻ quay vòng có thể cuộn, hãy thêm tối đa 10 mẫu chung vào mảng elements của payload.

"payload": {
  "template_type":"generic",
  "elements":[

Yêu cầu mẫu

Để biết toàn bộ thuộc tính và chi tiết của yêu cầu, hãy xem tài liệu tham khảo về Mẫu chung.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://petersfancybrownhats.com/company_image.png",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://petersfancybrownhats.com/view?item=103",
              "messenger_extensions": false,
              "webview_height_ratio": "tall",
              "fallback_url": "https://petersfancybrownhats.com/"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://petersfancybrownhats.com",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"DEVELOPER_DEFINED_PAYLOAD"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Phản hồi mẫu

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

Cách làm tốt nhất

Sử dụng mẫu chung cho các tin nhắn có hệ thống phân cấp thông tin nhất quán (ví dụ: bản xem trước sản phẩm hoặc bản xem trước bài viết, dự báo thời tiết).

Sử dụng tỷ lệ khung hình chính xác cho hình ảnh. Ảnh trong mẫu chung có tỷ lệ khác 1,19:1 sẽ được phóng to hoặc bị cắt xén.

Không sử dụng mẫu chung nếu tin nhắn của bạn không chứa thông tin có cấu trúc hoặc không cần phải phân cấp.

Không sử dụng mẫu chung nếu bạn cần cho phép mọi người phóng to hình ảnh ra toàn màn hình.

Không sử dụng file GIF trong mẫu nếu bạn muốn tạo hoạt ảnh cho file này. File GIF được hỗ trợ nhưng sẽ không tạo được hoạt ảnh.

Sử dụng thẻ quay vòng khi có thứ tự ưu tiên đối với nội dung của bạn, ví dụ: mục đầu tiên có thể là thú vị nhất.

Cố gắng duy trì sự nhất quán. Nếu một bong bóng có ảnh, hãy thêm ảnh vào tất cả bong bóng.

Giảm thiểu số lượng mẫu chung trong thẻ quay vòng. Nếu có quá nhiều mẫu chung, mọi người sẽ khó nhớ hết tất cả tùy chọn.

Không kết hợp các loại nội dung. Nếu bạn thêm một bài viết vào bên cạnh danh sách sản phẩm, trải nghiệm của bạn có thể gây nhầm lẫn.

Không sử dụng thẻ quay vòng khi mọi người cần phải nhìn thấy mọi nội dung trong danh sách. Họ có thể không cuộn được đến cuối danh sách. Thay vào đó, hãy cân nhắc dùng Mẫu danh sách.