Messengerプラットフォーム

Instagramメッセージ用商品テンプレート

商品テンプレートを使って、自分の商品カタログにアップロードした商品情報を含むInstagramメッセージを送信します。商品の詳細(画像、タイトル、価格)は、商品カタログから自動的に取得されます。

商品テンプレートを使って、商品を1つ含むメッセージ、または複数の商品から構成される水平スクロール可能なカルーセルを含むメッセージを作成できます。

開始する前に

このガイドは、Messengerプラットフォームの概要を読み、メッセージと通知の送受信に必要なコンポーネントを実装した人を対象にしています。

以下が必要です。

商品メッセージを送信する

利用者に商品メッセージを送信するには、POSTリクエストを/PAGE-ID/messagesエンドポイントに送信します。その際に、recipient.idプロパティを、メッセージ受信者となる利用者のInstagram-scoped IDに設定します。typeプロパティとpayloadプロパティを、message.attachmentオブジェクトに含めます。typeをtemplateに設定し、payload.template_typeプロパティをproductに、またpayload.elementsを商品IDのキー/値ペアのリストに設定します。

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"
          }
        ]
      }
...

成功すると、アプリは、受信者のIDとメッセージIDが含まれた以下のようなJSONオブジェクトを受け取ります。

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

オプトインリクエストを送信する

定期マーケティングメッセージを受け取るためのオプトインメッセージを利用者に送信するには、POSTリクエストを/PAGE-ID/messagesエンドポイントに送信します。その際に、recipient.idプロパティを、メッセージ受信者となる利用者のInstagram-scoped IDに設定します。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

string

テンプレートに表示する画像の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 – 6か月間、24時間ごとに1通のお知らせを受け取ることをオプトイン
  • WEEKLY – 9か月間、7日ごとに1通のお知らせを受け取ることをオプトイン
  • MONTHLY – 12か月間、1か月ごとに1通のお知らせを受け取ることをオプトイン

payload

string

この定期的なお知らせのオプトインリクエストの対象になる定期的なお知らせのタイプ(キャンペーンメッセージまたは製品リリースメッセージなど)

title

string

テンプレートに表示するタイトルは65文字以下にしてください。値が割り当てられていない場合、デフォルトの「更新情報とキャンペーン」になります

次のステップ

定期マーケティングメッセージを受け取ることを利用者がオプトインしたら、今度はマーケティングメッセージを送信する方法についてご確認ください。

参考情報