画像カルーセルテンプレート

トーク Bot を使って、複数の画像を横スクロールして閲覧できる画像カルーセルを送信します。
画像の送信には URL 方式とファイル ID 方式があります。

  • URL 方式では、originalContentUr、previewImageUrl パラメータは共に HTTPS にのみ対応しています。
  • ファイル ID 方式では、事前に コンテンツアップロード API を使って取得したファイル ID を使って画像を送信します。

画像カルーセルは多言語に対応しており、メンバーの言語設定に合わせて表示を切り替えることができます。 画像カルーセルの構造は下記の通りです。

structure_image_carousel

Request Content {#image-carousel-request}

common {#image-carousel-request-common}

パラメータタイプ説明
typestring"image_carousel"
required
columnsarray画像カルーセルのオブジェクトリスト
最大：10 個
required
columns[].originalContentUrlstring画像 URL (PNG 形式、HTTPS のみ)
originalContentUrl、fileId のいずれか一方は必須。
最大サイズ：1MB
最大文字数：1,000 文字
required
columns[].fileIdstring画像のファイル ID
originalContentUrl、fileId のいずれか一方は必須。
最大サイズ：1MB
columns[].actionAction Object画像を押した時の動作

multi language {#image-carousel-request-multilang}

パラメータタイプ説明
columns[].i18nOriginalContentUrls[]array多言語の画像 URL リスト
columns[].i18nOriginalContentUrls[].languagestring言語コード
required
columns[].i18nOriginalContentUrls[].originalContentUrlstring画像 URL (PNG 形式、HTTPS のみ)
最大サイズ：1MB
最大 1,000 文字
required
columns[].i18nFileIds[]array多言語の画像のファイル ID リスト
columns[].i18nFileIds[].languagestring言語コード
required
columns[].i18nFileIds[].fileIdstring画像のファイル ID
最大サイズ：1MB
required

Request Example {#image-carousel-request-example}

example_image_carousel

{   "content":{      "type":"image_carousel",      "columns":[         {            "originalContentUrl":"https://example.com/a.png",            "action":{               "type":"uri",               "label":"Visit",               "uri":"https://line-works.com/"            }         },         {            "originalContentUrl":"https://example.com/b.png",            "action":{               "type":"uri",               "label":"Visit",               "uri":"https://line-works.com/"            }         },         {            "originalContentUrl":"https://static.worksmobile.net/static/wm/botprofile/Bot_General_640.png",            "action":{               "type":"uri",               "label":"Talk",               "uri":"https://talk.worksmobile.com/"            }         }      ]   }}