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

列舉 { 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

列舉 { DAILY、WEEKLY、MONTHLY }

此選擇接收定期通知要求的訊息頻率。

  • DAILY：選擇在 6 個月內每 24 小時接收一次通知
  • WEEKLY：選擇在 9 個月內每 7 天接收一次通知
  • MONTHLY：選擇在 12 個月內每 1 個月接收一次通知

payload

字串

適用於此選擇接收定期通知要求的定期通知類型，如推廣訊息或商品發佈訊息

title

字串

範本中顯示的標題不能超過 65 個字元。如未指派任何值，該值會預設為「更新內容和推廣活動」

後續步驟

現在，用戶已選擇接收定期營銷訊息，了解如何傳送營銷訊息。

另請參閱