アクション

メンバーがメッセージやメニュー内のボタン等を押した際に実行されるアクションを設定します。

アクション一覧 {#actions}

アクションは次の通りです。

  • ポストバックアクション
  • メッセージアクション
  • URI アクション
  • カメラアクション
  • カメラロールアクション
  • 位置情報アクション
  • コピーアクション

それぞれ利用可能な場所に制限があります。

アクションタイプ利用可能場所
ポストバックアクションカルーセルテンプレート
画像カルーセルテンプレート
クイックリプライ
リッチメニュー
メッセージアクションボタンテンプレート
リストテンプレート
カルーセルテンプレート
画像カルーセルテンプレート
クイックリプライ
固定メニュー
リッチメニュー
URI アクションボタンテンプレート
リストテンプレート
カルーセルテンプレート
画像カルーセルテンプレート
クイックリプライ
固定メニュー
リッチメニュー
カメラアクションクイックリプライ
カメラロールアクションクイックリプライ
位置情報アクションクイックリプライ
コピーアクションボタンテンプレート
リストテンプレート
カルーセルテンプレート
画像カルーセルテンプレート
クイックリプライ
固定メニュー
リッチメニュー

ポストバックアクション {#postback}

このアクションが指定されている項目が選択されると、data パラメータに指定された文字列を含む ポストバックイベント (postback) を Callback として返します。

制限

  • 利用可能な場所については アクション一覧 を参照ください。

common {#postback-common}

パラメータタイプ説明
typestring"postback"
required
labelstring項目のラベル
リッチメニューとカルーセルの defaultAction 項目を除き必須。
リッチメニューで値を指定しない場合、デスクトップ版アプリではデフォルトのメッセージを表示。
最大20文字 (画像カルーセルでは最大 12 文字)
datastringpostback.data プロパティとして返す文字列
最大 300 文字
required
displayTextstringトーク画面に表示されるテキスト
入力しない場合、テキストが表示されない。クイックリプライでは必須。
最大 300 文字

multi language {#postback-multilang}

パラメータタイプ説明
i18nLabelsarray多言語のラベルリスト
i18nLabels[].languagestring言語コード
required
i18nLabels[].labelstring項目のラベル
最大 20 文字 (画像カルーセルでは最大 12 文字)
required
i18nDisplayTextsarray多言語の表示テキストリスト
i18nDisplayTexts[].languagestring言語コード
required
i18nDisplayTexts[].displayTextstringトーク画面に表示されるテキスト
最大 300 文字
required

Request Example {#postback-example}

{  "type": "postback",  "label": "Buy",  "data": "action=buy&itemid=111",  "displayText": "Buy"}

メッセージアクション {#message}

このアクションが指定されている項目が選択されると、text パラメータに指定された文字列がトーク上に送信され、メッセージイベント (message) が Callback として送られます。

制限

  • 利用可能な場所については アクション一覧 を参照ください。

common {#message-common}

パラメータタイプ説明
typestring"message"
required
labelstring項目のラベル
リッチメニューとカルーセルの defaultAction を除き必須。
リッチメニューで値を指定しない場合、デスクトップ環境ではデフォルトのメッセージを表示。
• 基本 : 最大 20 文字
• 画像カルーセル : 最大 12 文字
• 固定メニュー : 最大 1,000 文字
textstring項目を選択した時に送信されるテキスト
カルーセル、画像カルーセル、リッチメニュー、クイックリプライでは必須。
ボタンテンプレート、リストテンプレート、固定メニューでは label 値に置き換えられる。
最大 300 文字
postbackstringmessage.postback プロパティに返される文字列
最大文字数:1,000 文字

multi language {#message-multilang}

パラメータタイプ説明
i18nLabelsarray多言語のラベルリスト
i18nLabels[].languagestring言語コード
required
i18nLabels[].labelstring項目のラベル
• 基本 : 最大 20 文字
• 画像カルーセル : 最大 12 文字
• 固定メニュー : 最大 1,000 文字
required
i18nTextsarray多言語のテキストリスト
i18nTexts[].languagestring言語コード
required
i18nTexts[].textstring項目を選択した時に送信されるテキスト
カルーセル、画像カルーセル、リッチメニュー、クイックリプライでは必須。
ボタンテンプレート、リストテンプレート、固定メニューではlabel値に置き換えられる。
最大 300 文字
required

Request Example {#message-example}

{  "type": "message",  "label": "Yes",  "text": "Yes"}

URI アクション {#uri}

このアクションが指定されている項目が選択されると、uri パラメータで指定された URI が開きます。

制限

  • 利用可能な場所については アクション一覧 を参照ください。

common {#uri-common}

パラメータタイプ説明
typestring"uri"
required
labelstring項目のラベル
リッチメニューとカルーセルの defaultAction を除き必須。
リッチメニューで値を指定しない場合には、デスクトップ環境ではデフォルトのメッセージを表示。
• 基本 : 最大 20 文字
• 画像カルーセル : 最大 12 文字
• 固定メニュー : 最大 1,000 文字
uristring項目を選択した時に開く URI
http、https スキーマのみ対応。
最大 1,000 文字
required

multi language {#uri-multilang}

パラメータタイプ説明
i18nLabelsarray多言語のラベルリスト
i18nLabels[].languagestring言語コード
required
i18nLabels[].labelstring項目のラベル
• 基本 : 最大 20 文字
• 画像カルーセル : 最大 12 文字
• 固定メニュー : 最大 1,000 文字
required

Request Example {#uri-example}

{  "type": "uri",  "label": "View details",  "uri": "http://line-works.com"}

カメラアクション {#camera}

このアクションが指定されている項目が選択されると、カメラを開きます。

制限

  • 利用可能な場所については アクション一覧 を参照ください。
  • モバイル版でのみ利用可能な機能です。

common {#camera-common}

パラメータタイプ説明
typestring"camera"
required
labelstringボタンのラベル
最大 20 文字
required

multi language {#camera-multilang}

パラメータタイプ説明
i18nLabelsarray多言語のラベルリスト
i18nLabels[].languagestring言語コード
required
i18nLabels[].labelstringボタンのラベル
最大 20 文字
required

Request Example {#camera-example}

{  "type": "camera",  "label": "Camera"}

カメラロールアクション {#cameraroll}

このアクションが指定されている項目が選択されると、カメラロール画面を開きます。

制限

  • 利用可能な場所については アクション一覧 を参照ください。
  • モバイル版でのみ利用可能な機能です。

common {#cameraroll-common}

パラメータタイプ説明
typestring"cameraRoll"
required
labelstringボタンのラベル
最大 20 文字
required

multi language {#cameraroll-multilang}

パラメータタイプ説明
i18nLabelsarray多言語のラベルリスト
i18nLabels[].languagestring言語コード
required
i18nLabels[].labelstringボタンのラベル
最大 20 文字
required

Request Example {#cameraroll-example}

{  "type": "cameraRoll",  "label": "Camera roll"}

位置情報アクション {#location}

このアクションが指定されている項目が選択されると、位置情報画面を開きます。

制限

  • 利用可能な場所については アクション一覧 を参照ください。
  • モバイル版でのみ利用可能な機能です。

common {#location-common}

パラメータタイプ説明
typestring"location"
required
labelstringボタンのラベル
最大 20 文字
required

multi language {#location-multilang}

パラメータタイプ説明
i18nLabelsarray多言語のラベルリスト
i18nLabels[].languagestring言語コード
required
i18nLabels[].labelstringボタンのラベル
最大 20 文字
required

Request Example {#location-example}

{  "type": "location",  "label": "Location"}

コピーアクション {#copy}

このアクションが指定されている項目が選択されると、copyText パラメータに指定されたテキストがクリップボードにコピーされます。

制限

  • 利用可能な場所については アクション一覧 を参照ください。
  • 対応バージョン: v3.6 以上

common {#copy-common}

パラメータタイプ説明
typestring"copy"
required
labelstring項目のラベル。リッチメニューとカルーセルの defaultAction を除き必須。
リッチメニューで値を指定しない場合、デスクトップ環境ではデフォルトのメッセージを表示。
• 基本 : 最大 20 文字
• 画像カルーセル : 最大 12 文字
• 固定メニュー : 最大 1,000 文字
copyTextstringコピーされるテキスト。
最大 1,000 文字
required

multi language {#copy-multilang}

パラメータタイプ説明
i18nLabelsarray多言語のラベルリスト
i18nLabels[].languagestring言語コード
required
i18nLabels[].labelstring項目のラベル
• 基本 : 最大 20 文字
• 画像カルーセル : 最大 12 文字
• 固定メニュー : 最大 1,000 文字
required

Request Example {#copy-example}

{  "type": "copy",  "label": "Copy This",  "copyText": "This is a copied text."}