メニュー (固定メニュー/リッチメニュー)

Bot とのトークルームで画面下部に表示するメニュー機能です。

  • 固定メニュー (Persistent menu)
    • メニュー項目がボタンとして並んだシンプルなメニューです。
  • リッチメニュー (Rich menu)
    • メニューのデザインを任意に設定できる自由度の高いメニューです。

制限

  • リッチメニューを登録する場合、登録済みの固定メニューは削除されます。
  • リッチメニューが登録済みの Bot では、固定メニューの登録ができません。リッチメニューを全て削除してから設定します。
  • 複数の Bot が参加するトークルームでは利用できません。

固定メニュー {#persistentmenu}

固定メニューは、トーク画面下にボタンリストを表示するシンプルなメニューです。アクションが設定されたボタンリストを表示します。

構造 {#persistentmenu-structure}

structure_persistentmenu

固定メニューに登録された各項目がボタンとして表示されます。

制限

  • ボタンは 4 つまで登録可能です。
  • ブラウザ版・PC 版では固定メニューはドロップダウン表示となります。

API を使用して設定する {#persistentmenu-setting-by-api}

固定メニューは Bot API を利用して設定します。

  • 固定メニューの設定は 固定メニューの登録 で行います。
  • 登録すると、すべてのメンバーに共通で設定されます。

その他、固定メニューに関する API については 固定メニュー を参照してください。

リッチメニュー {#richmenu}

リッチメニューは、画像上の任意の領域にアクションを設定できる、自由度の高いメニューです。

制限

  • 1 つのトーク Bot につき、リッチメニューは最大 1,000 個まで登録できます。

構造 {#richmenu-structure}

structure_richmenu

リッチメニューは 1 つの画像を 1 つ以上のエリアに分割してアクションを指定します

制限

  • リッチメニューの画像はモバイル版でのみ表示されます。ブラウザ版・PC版では固定メニューと同様にドロップダウン表示となります。

画像を準備する {#richmenu-prepare-image}

リッチメニューで使用する画像を準備します。

画像の要件は以下の通りです。

  • 画像フォーマット: JPEG または PNG
  • 画像の幅 × 高さ: 2500 × 1686 または 2500 × 843 ピクセル固定
  • 最大ファイルサイズ: 1 MB

リッチメニュー画像のサンプル

  • サイズ: 2500 × 1686 richmenu_template_full
  • サイズ: 2500 × 843 richmenu_template_half

API を使用して設定する {#richmenu-setting-by-api}

リッチメニューは Bot API を利用して設定します。

リッチメニューの設定手順は以下の通りです。

1. 画像をアップロードする {#richmenu-image-upload}

  • コンテンツアップロード で、リッチメニューで使用する画像をアップロードします。
  • アップロードをすると fileId を取得でき、後にリッチメニューへの画像設定で使用します。

2. リッチメニューを登録する {#create-richmenu}

  • リッチメニューの各アクションや領域を決め、リッチメニューの登録で Bot へ登録します。
  • 登録すると richmenuId を取得でき、リッチメニューの管理や適用に使用します。

3. リッチメニューに画像を設定する {#set-richmenu-image}

リッチメニュー画像の登録で、2 で登録したリッチメニューに、1 でアップロードした画像の fileId を紐付けます。

4. リッチメニューを適用する {#apply-richmenu}

リッチメニューの適用範囲には、「メンバー別に適用」と「デフォルトリッチメニューとして全体に適用」の 2 種類があります。それぞれで適用方法が異なります。

  • メンバー別に適用 :
    • ユーザー別リッチメニューの適用 を使って、指定のメンバーへ適用します。
  • デフォルトリッチメニューとして全体に適用 :
    • デフォルトリッチメニューの適用 を使って、Bot のデフォルトリッチメニューとして適用します。
      または
    • Bot の更新 または Bot の部分更新 で、defaultRichmenuId に richmenuId を指定します。

適用したリッチメニューの優先度

  • メンバー別リッチメニュー > デフォルトリッチメニュー

その他、リッチメニューに関する API については リッチメニュー を参照してください。