常规模板

常规模板是一种简单的结构化消息,其中包含标题、副标题、图像和最多三个按钮。您还可以指定 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 的照片将被缩放或裁剪。

如果消息不包含结构化信息或不是必须使用层次结构,请不要使用常规模板。

如果需要用户将图片缩放为全屏大小,请不要使用常规模板。

如果需要动图显示动态效果,请不要在常规模板中使用动图。常规模板支持使用动图,但无法显示动态效果。

如果内容有优先顺序,可以使用轮播,例如第一项内容可以是最吸引用户的商品。

尽量保持一致性。如果一个气泡包含照片,所有气泡都应包含照片。

尽量减少轮播中的通用模板数量。模板太多会使用户难以记住所有选项。

不要将不同类型的内容混合在一起。如果您在产品列表旁添加一篇文章,可能会使用户感到困惑。

如果必须让用户看到列表中的所有内容,则请不要使用轮播。因为用户可能不会滚动到轮播结束。建议改用列表模板。