一般型範本是簡單的結構化訊息,可包含標題、副標題、圖像及最多三個按鈕。您還可以指定 default_action
物件,以設定當點按範本時會在 Messenger WebView 中開啟的網址。
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,但不會以動畫顯示。
當內容有優先順序時(亦即第一個項目可能是最令人感興趣的),請使用輪播廣告。
力求一致。如果其中一個聊天泡泡有相片,請在所有的聊天泡泡中都加入相片。
盡量減少輪播廣告中一般型範本的數量,太多會讓人記不住所有選項。
請勿混合不同類型的內容。如果您在產品清單旁加入文章,用戶可能會感到困惑。
如果用戶必須查看清單中的所有項目,請勿使用輪播廣告。用戶可能不會捲動到清單尾端。請考慮改用清單範本。