汎用テンプレート
汎用テンプレートは、タイトル、サブタイトル、画像、最大で3個のボタンを含むシンプルな構造化メッセージです。テンプレートをタップしたときにMessengerウェブビューで開かれるURLを設定するdefault_actionオブジェクトを指定することもできます。
目次
テンプレートペイロード
すべてのテンプレートプロパティのリストについては、汎用テンプレートのリファレンスをご覧ください。
"payload": {
"template_type":"generic",
"elements":[
{
"title":"汎用テンプレートのカルーセルの送信
Messengerプラットフォームは、汎用テンプレートの水平スクロールが可能なカルーセルの送信をサポートしています。
スクロール可能なカルーセルを作成するには、payloadのelements配列に最大10個の汎用テンプレートを含めます。
"payload": {
"template_type":"generic",
"elements":[リクエストの例
すべてのリクエストの詳細とプロパティについては、汎用テンプレートのリファレンスをご覧ください。
curl -X POST -H "Content-Type: application/json" -d '{
"recipient":{
"id":"<PSID>"
},
"message":{
"attachment":{
"type":"template",
"payload":{
"template_type":"generic",
"elements":[
{
"title":"Welcome!",
"image_url":"https://petersfancybrownhats.com/company_image.png",
"subtitle":"We have the right hat for everyone.",
"default_action": {
"type": "web_url",
"url": "https://petersfancybrownhats.com/view?item=103",
"messenger_extensions": false,
"webview_height_ratio": "tall",
"fallback_url": "https://petersfancybrownhats.com/"
},
"buttons":[
{
"type":"web_url",
"url":"https://petersfancybrownhats.com",
"title":"View Website"
},{
"type":"postback",
"title":"Start Chatting",
"payload":"DEVELOPER_DEFINED_PAYLOAD"
}
]
}
]
}
}
}
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"応答の例
{
"recipient_id": "1254477777772919",
"message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}
ベストプラクティス
一貫性のある情報階層(製品または記事のプレビューや天気予報など)を伴うメッセージに使います。
画像には適切なアスペクト比を使います。汎用テンプレートに含まれる写真のうち1.91:1ではないものは、拡大縮小されるか切り捨てられます。
メッセージに構造化された情報がない場合や階層を必要としない場合には使わないでください。
ユーザーが画像を拡大して全画面にできるようにする必要がある場合には使わないでください。
アニメーションを付ける目的でテンプレートの中にgifを使うことはしないでください。gifはサポートされますが、アニメーションにはなりません。
カルーセル
コンテンツに優先順位がある場合、つまり最初のアイテムが恐らく最も関心の高いものである場合は、カルーセルを使います。
できるだけ一貫性を保つようにしてください。1つのバブルに写真がある場合、すべてのバブルに写真を含めてください。
カルーセル内の汎用テンプレートの数は最低限に抑えてください。多すぎると、ユーザーがすべてのオプションを覚えることが難しくなります。
複数のタイプのコンテンツを混在させないでください。製品リストの横に記事を含めると、エクスペリエンスが混乱したものになる可能性があります。
ユーザーがリスト内のあらゆるものを見ることが重要な場合、カルーセルは使わないでください。最後までスクロールしない可能性があります。代わりにリストテンプレートを検討してください。