Messenger 開放平台

一般型範本

一般型範本是簡單的結構化訊息，可包含標題、副標題、圖像及最多三個按鈕。您還可以指定 default_action 物件，以設定當點按範本時會在 Messenger WebView 中開啟的網址。

內容

範本承載

如需範本屬性的完整清單，請參閱一般型範本參考資料。

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

Messenger 平台支援傳送可平行捲動的一般型範本輪播廣告。

若要建立可捲動的輪播廣告，請在 payload 的 elements 陣列中包含最多 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，但不會以動畫顯示。

當內容有優先順序時（亦即第一個項目可能是最令人感興趣的），請使用輪播廣告。

力求一致。如果其中一個聊天泡泡有相片，請在所有的聊天泡泡中都加入相片。

盡量減少輪播廣告中一般型範本的數量，太多會讓人記不住所有選項。

請勿混合不同類型的內容。如果您在產品清單旁加入文章，用戶可能會感到困惑。

如果用戶必須查看清單中的所有項目，請勿使用輪播廣告。用戶可能不會捲動到清單尾端。請考慮改用清單範本。