メッセージテンプレート

メッセージテンプレートを使うと、1つのメッセージにボタン、画像、リストなどを統合することによって、通常のテキストメッセージよりも優れたスレッド内エクスペリエンスを提供できます。テンプレートは、製品情報を表示したり、事前に設定したオプションから選択するよう促したり、検索結果を表示したりするなど、さまざまな用途に使用できます。

利用可能なテンプレート

次のテンプレートを使用して、構造化されたメッセージを送信できます。

メッセージテンプレートを送信する

メッセージテンプレートを送信するには、POSTリクエストを/PAGE-ID/messagesエンドポイントに送信します。その際、受信側のPage-scoped IDを指定し、さらにテンプレートタイプを含むメッセージ添付、そしてタイトルや画像など特定のテンプレートについての詳細情報を含むペイロードを指定します。

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"TEMPLATE-TYPE",
        "elements":[
          {
            "title":"TEMPLATE-TITLE",
            ...
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v21.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"

すべてのテンプレートタイプで、リクエストの本文は標準のフォーマットに従い、タイプと、各テンプレートタイプに固有のコンテンツ詳細を含むmessage.attachment.payloadプロパティを指定します。

ボタンの使用

ほとんどのメッセージテンプレートで、1つ以上のボタンをテンプレートとして組み込むことができます。これらのボタンを使用して、メッセージの受信者がテンプレートへの応答として行うアクションを指定できます。

使用できるボタンのタイプはテンプレートごとに異なります。詳しくは、各テンプレートのリファレンスドキュメントをご覧ください。

Messengerプラットフォームで利用できるボタンタイプについて詳しくは、ボタンをご覧ください。