汎用テンプレート

汎用テンプレートを使用して、画像、テキスト、ボタンを含むフォーマット済みメッセージを送信できます。elements配列に複数のテンプレートを記述した汎用テンプレートは、複数アイテムの水平スクロール可能なカルーセルを送信します。各アイテムは画像、テキスト、ボタンで構成されています。

この機能は、現在デスクトップではご利用いただけません。

リクエストURI

https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"

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

メッセージ受信者の説明。すべてのリクエストには、受信者を識別するために次のプロパティのいずれかが含まれている必要があります。

プロパティ	型	説明
`recipient.id`	文字列	メッセージ受信者のIG-scopedユーザーID (IGSID)。

Description of the message to be sent.

Property	Type	Description
`message.attachment`	Object	An object describing attachments to the message.

Property	Type	Description
`type`	String	Value must be `template`
`payload`	Object	テンプレートの`payload`

プロパティ	型	説明
`template_type`	文字列	値は`generic`にする必要があります
`elements`	`element`配列	送信する汎用テンプレートのインスタンスを記述した`element`オブジェクトの配列。複数のエレメントを指定すると、テンプレートの水平スクロールが可能なカルーセルが送信されます。最大10個のエレメントがサポートされます。

汎用テンプレートでは、メッセージごとに最大10個のエレメントがサポートされます。titleに加えて、少なくとも1つのプロパティを設定する必要があります。

プロパティ名	型	説明
`title`	文字列	テンプレートに表示するタイトル。最大80文字です。
`subtitle`	文字列	*任意。*テンプレートに表示するサブタイトル。最大80文字です。
`image_url`	文字列	*任意。*テンプレートに表示する画像のURL。
`default_action`	オブジェクト	*任意。*テンプレートがタップされたときに実行されるデフォルトアクション。URLボタンと同じプロパティ(`title`を除く)を指定できます。
`buttons`	`button`配列	*任意。*テンプレートの末尾に追加するボタンの配列。エレメントごとに最大3個のボタンがサポートされます。`postback`ボタンと`web_url`ボタンだけがサポートされています。