通用範本

通用範本是一種簡單的結構化訊息,其中包含標題、子標題、圖片與最多三個按鈕。您亦可指定 default_action 物件,設定用戶點按範本後要在 Messenger 網頁檢視中開啟的網址。

內容

裝載範本

請參閱通用範本參考資料,以查看範本屬性的完整清單。

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

Messenger 平台能夠傳送可水平捲動的一般範本輪播。

要建立可捲動的輪播,請在 payloadelements 陣列中加入最多 10 個通用範本。

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

要求範例

請參閱通用範本參考資料,以查看完整的要求詳情與屬性。

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>"

回應範例

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

最佳操作實例

用於資訊層級一致的訊息(例如商品或文章預覽、天氣預報)。

為圖片套用正確的長闊比例。通用範本中相片的長闊比例如果不是 1.91:1,就會被縮放或裁剪。

如果您的訊息不含結構化資訊或需要分級,避免使用。

如果您要讓用戶可以將圖片放大至全螢幕,避免使用。

如果您想呈現動畫效果,避免在範本中使用 GIF。範本支援 GIF 檔案,但不支援 GIF 顯示動畫效果。

如果內容設有優先次序(例如,第一個項目可能最為有趣),可以使用輪播。

儘量保持一致性。如果其中一個聊天泡泡中有相片,則在所有聊天泡泡中加入相片。

儘量減少輪播中的通用範本數量。如果範本太多,用戶很難記住全部選項。

避免混合配搭不同類型的內容。如果您在產品清單旁加入一篇文章,用戶可能會覺得混亂。

如果必須要讓用戶看到清單中的所有內容,避免使用輪播格式,因為用戶未必會捲動到最底。您可以考慮改用清單範本。