メンバーがメッセージやメニュー内のボタン等を押した際に実行されるアクションを設定します。
アクションは次の通りです。
それぞれ利用可能な場所に制限があります。
このアクションが指定されている項目が選択されると、data パラメータに指定された文字列を含む ポストバックイベント (postback) を Callback として返します。
制限
- 利用可能な場所については アクション一覧 を参照ください。
| パラメータ | タイプ | 説明 |
|---|---|---|
| type | string | "postback" required |
| label | string | 項目のラベル リッチメニューとカルーセルの defaultAction 項目を除き必須。 リッチメニューで値を指定しない場合、デスクトップ版アプリではデフォルトのメッセージを表示。 最大20文字 (画像カルーセルでは最大 12 文字) |
| data | string | postback.data プロパティとして返す文字列 最大 300 文字 required |
| displayText | string | トーク画面に表示されるテキスト 入力しない場合、テキストが表示されない。クイックリプライでは必須。 最大 300 文字 |
| パラメータ | タイプ | 説明 |
|---|---|---|
| i18nLabels | array | 多言語のラベルリスト |
| i18nLabels[].language | string | 言語コード required |
| i18nLabels[].label | string | 項目のラベル 最大 20 文字 (画像カルーセルでは最大 12 文字) required |
| i18nDisplayTexts | array | 多言語の表示テキストリスト |
| i18nDisplayTexts[].language | string | 言語コード required |
| i18nDisplayTexts[].displayText | string | トーク画面に表示されるテキスト 最大 300 文字 required |
{ "type": "postback", "label": "Buy", "data": "action=buy&itemid=111", "displayText": "Buy"}このアクションが指定されている項目が選択されると、text パラメータに指定された文字列がトーク上に送信され、メッセージイベント (message) が Callback として送られます。
制限
- 利用可能な場所については アクション一覧 を参照ください。
| パラメータ | タイプ | 説明 |
|---|---|---|
| type | string | "message" required |
| label | string | 項目のラベル リッチメニューとカルーセルの defaultAction を除き必須。 リッチメニューで値を指定しない場合、デスクトップ環境ではデフォルトのメッセージを表示。 • 基本 : 最大 20 文字 • 画像カルーセル : 最大 12 文字 • 固定メニュー : 最大 1,000 文字 |
| text | string | 項目を選択した時に送信されるテキスト カルーセル、画像カルーセル、リッチメニュー、クイックリプライでは必須。 ボタンテンプレート、リストテンプレート、固定メニューでは label 値に置き換えられる。 最大 300 文字 |
| postback | string | message.postback プロパティに返される文字列 最大文字数:1,000 文字 |
| パラメータ | タイプ | 説明 |
|---|---|---|
| i18nLabels | array | 多言語のラベルリスト |
| i18nLabels[].language | string | 言語コード required |
| i18nLabels[].label | string | 項目のラベル • 基本 : 最大 20 文字 • 画像カルーセル : 最大 12 文字 • 固定メニュー : 最大 1,000 文字 required |
| i18nTexts | array | 多言語のテキストリスト |
| i18nTexts[].language | string | 言語コード required |
| i18nTexts[].text | string | 項目を選択した時に送信されるテキスト カルーセル、画像カルーセル、リッチメニュー、クイックリプライでは必須。 ボタンテンプレート、リストテンプレート、固定メニューではlabel値に置き換えられる。 最大 300 文字 required |
{ "type": "message", "label": "Yes", "text": "Yes"}このアクションが指定されている項目が選択されると、uri パラメータで指定された URI が開きます。
制限
- 利用可能な場所については アクション一覧 を参照ください。
| パラメータ | タイプ | 説明 |
|---|---|---|
| type | string | "uri" required |
| label | string | 項目のラベル リッチメニューとカルーセルの defaultAction を除き必須。 リッチメニューで値を指定しない場合には、デスクトップ環境ではデフォルトのメッセージを表示。 • 基本 : 最大 20 文字 • 画像カルーセル : 最大 12 文字 • 固定メニュー : 最大 1,000 文字 |
| uri | string | 項目を選択した時に開く URI http、https スキーマのみ対応。 最大 1,000 文字 required |
| パラメータ | タイプ | 説明 |
|---|---|---|
| i18nLabels | array | 多言語のラベルリスト |
| i18nLabels[].language | string | 言語コード required |
| i18nLabels[].label | string | 項目のラベル • 基本 : 最大 20 文字 • 画像カルーセル : 最大 12 文字 • 固定メニュー : 最大 1,000 文字 required |
{ "type": "uri", "label": "View details", "uri": "http://line-works.com"}このアクションが指定されている項目が選択されると、カメラを開きます。
制限
- 利用可能な場所については アクション一覧 を参照ください。
- モバイル版でのみ利用可能な機能です。
| パラメータ | タイプ | 説明 |
|---|---|---|
| type | string | "camera" required |
| label | string | ボタンのラベル 最大 20 文字 required |
| パラメータ | タイプ | 説明 |
|---|---|---|
| i18nLabels | array | 多言語のラベルリスト |
| i18nLabels[].language | string | 言語コード required |
| i18nLabels[].label | string | ボタンのラベル 最大 20 文字 required |
{ "type": "camera", "label": "Camera"}このアクションが指定されている項目が選択されると、カメラロール画面を開きます。
制限
- 利用可能な場所については アクション一覧 を参照ください。
- モバイル版でのみ利用可能な機能です。
| パラメータ | タイプ | 説明 |
|---|---|---|
| type | string | "cameraRoll" required |
| label | string | ボタンのラベル 最大 20 文字 required |
| パラメータ | タイプ | 説明 |
|---|---|---|
| i18nLabels | array | 多言語のラベルリスト |
| i18nLabels[].language | string | 言語コード required |
| i18nLabels[].label | string | ボタンのラベル 最大 20 文字 required |
{ "type": "cameraRoll", "label": "Camera roll"}このアクションが指定されている項目が選択されると、位置情報画面を開きます。
制限
- 利用可能な場所については アクション一覧 を参照ください。
- モバイル版でのみ利用可能な機能です。
| パラメータ | タイプ | 説明 |
|---|---|---|
| type | string | "location" required |
| label | string | ボタンのラベル 最大 20 文字 required |
| パラメータ | タイプ | 説明 |
|---|---|---|
| i18nLabels | array | 多言語のラベルリスト |
| i18nLabels[].language | string | 言語コード required |
| i18nLabels[].label | string | ボタンのラベル 最大 20 文字 required |
{ "type": "location", "label": "Location"}このアクションが指定されている項目が選択されると、copyText パラメータに指定されたテキストがクリップボードにコピーされます。
制限
- 利用可能な場所については アクション一覧 を参照ください。
- 対応バージョン: v3.6 以上
| パラメータ | タイプ | 説明 |
|---|---|---|
| type | string | "copy" required |
| label | string | 項目のラベル。リッチメニューとカルーセルの defaultAction を除き必須。 リッチメニューで値を指定しない場合、デスクトップ環境ではデフォルトのメッセージを表示。 • 基本 : 最大 20 文字 • 画像カルーセル : 最大 12 文字 • 固定メニュー : 最大 1,000 文字 |
| copyText | string | コピーされるテキスト。 最大 1,000 文字 required |
| パラメータ | タイプ | 説明 |
|---|---|---|
| i18nLabels | array | 多言語のラベルリスト |
| i18nLabels[].language | string | 言語コード required |
| i18nLabels[].label | string | 項目のラベル • 基本 : 最大 20 文字 • 画像カルーセル : 最大 12 文字 • 固定メニュー : 最大 1,000 文字 required |
{ "type": "copy", "label": "Copy This", "copyText": "This is a copied text."}