Messenger 开放平台

用于 Instagram 消息的商品模板

发送使用商品模板的 Instagram 消息（其中包含您已上传到商品目录 的商品信息）。系统将自动从商品目录中提取商品详情（图像、标题、价格）。

您可以使用商品模板创建包含一个商品或多个可水平滚动的轮播商品的消息。

准备工作

本指南假设您已经查看 Messenger 开放平台概览，并且已经实现发送和接收消息和通知所需的组件。

您将需要：

发送商品消息

如要向用户发送商品消息，请向 /PAGE-ID/messages 端点发送 POST 请求，在请求中将 recipient.id 属性设为收信人的 Instagram 范围编号。在 message.attachment 对象中加入 type 和 payload 属性。将 type 设为 template，将 payload.template_type 属性设为 product，并将 payload.elements 设为商品编号键值对清单。

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"INSTAGRAM-SCOPED-ID"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

发送轮播

如要发送商品轮播，请在 payload.elements 属性中添加更多商品键值对。您可以在请求中加入最多 10 件商品。

...
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID-1"
          },
          {
            "id": "PRODUCT-ID-2"
          },
          {
            "id": "PRODUCT-ID-3"
          }
        ]
      }
...

若请求成功，您的应用会收到以下 JSON 对象，其中包含收信人编号和消息编号。

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

发送订阅请求

如要向用户发送订阅定期营销消息的请求，请向 /PAGE-ID/messages 端点发送 POST 请求，在请求中将 recipient.id 属性设为收信人的 Instagram 范围编号。在 messageattachment.payload 属性中，将 template_type 设为 notification_messages。在 payload.elements 属性中加入 image_url、title、payload、notification_message_frequency 和 notification_messages_cta_text。

curl -X POST -H "Content-Type:application/json" -d '{
  "recipient": {
    "id": "INSTAGRAM-SCOPED-ID"
  },
  "message": {
    "attachment": {
      "type": "template",
      "payload": {
        "template_type": "notification_messages",
        "elements": [
          {
            "image_url": "IMAGE-URL",
            "title": "TEXT-TO-DISPLAY",
            "payload": "INFORMATION-ABOUT-THIS-MESSAGE",
            "notification_messages_frequency": "DAILY",
            "notification_messages_cta_text": "GET_UPDATES"
          }
        ]
      }
    }
  }
}' "https://graph.intern.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

“通知消息元素”参考文档

属性值

image_url

字符串

要在模板中显示的图像的网址

notification_messages_cta_text

enum { ALLOW, FREQUENCY, GET, GET_UPDATES, OPT_IN, SIGN_UP }

使用以下值之一来设置出现在行动号召按钮上的文本：

  • ALLOW – 将订阅消息按钮的文本设为允许接收消息
  • FREQUENCY – 将订阅消息按钮的文本设为接收每日消息
  • GET – 将订阅消息按钮的文本设为接收消息
  • GET_UPDATES – 将订阅消息按钮的文本设为接收动态更新（在未设置 notification_messages_cta_text 情况下，这也是默认值）
  • OPT_IN – 将订阅消息按钮的文本设为选择接收消息
  • SIGN_UP – 将订阅消息按钮的文本设为订阅消息

notification_messages_frequency

enum { DAILY, WEEKLY, MONTHLY }

定期通知订阅请求的消息频率。

  • DAILY – 选择每 24 小时接收一条通知，持续 6 个月
  • WEEKLY – 选择每 7 天接收一条通知，持续 9 个月
  • MONTHLY – 选择每月接收一条通知，持续 12 个月

payload

字符串

此定期通知订阅请求中的定期通知类型，例如推广性消息、产品发布消息

title

字符串

显示在模板中的标题，字符数不得超过 65 个。如果未指定值，则默认值为“更新和优惠”

后续步骤

用户选择接收定期营销消息之后，您可以了解一下如何发送营销消息。

另请参阅