> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utage-system.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LINEツール

> LINE友だち・1対1チャット・テンプレート・リッチメニュー・自動応答・カスタム送信者の操作ツール

## 概要

LINE系ツールでは、種類が LINEのみ（`line`）またはメール・LINE併用（`mail_line`）の配信アカウントに紐づく LINE友だち・1対1チャット（管理画面の「LINE チャット」）・LINEテンプレート（テンプレートグループを含む）・LINEリッチメニュー（リッチメニューグループを含む。リッチメニュー自体の作成・編集は管理画面で行います）・LINE自動応答（自動応答グループを含む）・LINEカスタム送信者を操作できます。各ツールの `account_id` には配信アカウントIDを指定します（`message_account_list` で取得）。

LINEメッセージ本文（`line.messages`）の書き方は [配信ツール](https://docs.utage-system.com/mcp/tools-message.md) の `message_create` と、[参照ツール](https://docs.utage-system.com/mcp/tools-reference.md) の `message_types_line` を参照してください。

## LINE友だち

### message\_line\_friend\_list

LINE友だち一覧を取得します。LINE登録名・ブロック状態・配信除外・未読有無・ラベル等で絞り込みできます。ソートは `created_at`（登録順）または `last_acted_at`（最終アクション順）で、いずれも降順固定です。種類が `line` / `mail_line` 以外のアカウントではエラー（not\_found）になります。未読メッセージを既読にするには `message_line_chat_message_mark_as_read` を使います。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `common_friend_id` | string | - | アカウント共通LINE友だちID（line\_user\_idのMD5）で完全一致検索 |
| `display_name` | string | - | LINE登録名で部分一致検索 |
| `is_blocked` | boolean | - | ブロック状態で絞り込み |
| `is_exclusion` | boolean | - | 配信除外フラグで絞り込み（未指定時は両方返却） |
| `has_unread` | boolean | - | 未読メッセージの有無で絞り込み |
| `label_ids` | array | - | ラベルIDの配列で絞り込み（複数指定時はAND条件。存在しないIDは無視され、有効なIDが1件も無い場合は絞り込まれません） |
| `sort` | string | - | ソート順（`created_at` / `last_acted_at`、降順固定） |
| `page` | integer | - | ページ番号（デフォルト1） |
| `per_page` | integer | - | 1ページあたりの件数（デフォルト20、最大100） |

**指示例:**

* 「このアカウントのLINE友だち一覧を見せて」
* 「未読のある友だちだけ表示して」
* 「"田中"を含むLINE登録名の友だちを検索して」

***

### message\_line\_friend\_get

LINE友だちの詳細を取得します。共通読者ID・対応ステータス・ラベル・共通読者の読者項目（`common_fields`）・メモ・登録経路名等を含みます。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `friend_id` | string | 必須 | LINE友だちID |

**指示例:**

* 「この友だちの詳細を見せて」
* 「この友だちに付いているラベルを確認して」

***

### message\_line\_friend\_update

LINE友だちの属性を部分更新します。指定したフィールドのみ変更され、省略したフィールドは既存値を維持します。`is_blocked` はLINEプラットフォーム側の状態のため更新できません（含めても無視されます）。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `friend_id` | string | 必須 | LINE友だちID |
| `display_name` | string | - | 表示名（最大20文字） |
| `is_test_account` | boolean | - | テスト対象フラグ |
| `is_exclusion` | boolean | - | 配信除外フラグ（変更時は未読カウンタを再計算） |

**指示例:**

* 「この友だちをテスト対象にして」
* 「この友だちを配信除外に設定して」

***

### message\_line\_friend\_menu\_update

LINE友だちに紐づくリッチメニューを切り替えます。指定するリッチメニューIDは `message_line_richmenu_list` で取得します。`rich_menu_id` に `null` を指定すると解除（unlink）します。キーを省略した場合は更新しません。LINE APIの呼び出しに失敗した場合はエラー（external\_service\_error）になり、DBは更新されません。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `friend_id` | string | 必須 | LINE友だちID |
| `rich_menu_id` | string | - | リッチメニューID（`message_line_richmenu_list` で取得）。`null` で解除（unlink） |

**指示例:**

* 「この友だちのリッチメニューをAに切り替えて」
* 「この友だちのリッチメニューを解除して」

***

### message\_line\_friend\_reader\_create

LINE友だちを指定シナリオの読者として登録します。`allow_duplicates=false`（デフォルト）の場合、配信解除されていない同一の友だち×シナリオの読者が既に存在するとエラー（conflict）を返します。

> [!NOTE]
>
> 読者作成はバーストが発生しやすいため、このエンドポイントは分間レート制限の対象外です。代わりに時間単位・月間単位・累計の作成上限で制御されます。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `friend_id` | string | 必須 | LINE友だちID |
| `scenario_id` | string | 必須 | 登録先シナリオID |
| `has_step_immediately` | boolean | - | 登録直後のステップ配信の対象にする（デフォルトfalse） |
| `has_step_scheduled` | boolean | - | 登録以降のステップ配信の対象にする（デフォルトfalse） |
| `has_reminder` | boolean | - | リマインダ配信の対象にする（デフォルトfalse） |
| `allow_duplicates` | boolean | - | 重複登録を許可する（デフォルトfalse） |

**指示例:**

* 「この友だちを"無料講座"シナリオに登録して」

***

## LINE 1対1チャット

### message\_line\_chat\_message\_send

LINE友だちに1対1チャットでメッセージを送信します。`type` で送信種別を指定し、種別ごとに必要なフィールドが異なります。ブロック済み（`is_blocked=true`）の友だちには送信できません（エラー friend\_blocked）。配信除外（`is_exclusion=true`）の友だちには送信できます。

`type=text` の本文に、配信済みのメッセージから取得したURL（置換URL）や `rid` パラメータ付きのURLを含めることはできません（エラー validation\_error）。元のURLを指定してください。`type=image` / `video` / `audio` のURLは取り込まれず、指定したURLがそのまま使われます。

**type別の必須フィールド:**

| type | 必須フィールド | 補足 |
| - | - | - |
| `text` | `text` | 最大5000文字。置換URL・`rid` 付きURLは不可 |
| `image` | `original_content_url` | HTTPS必須。`preview_image_url` は指定不可（自動設定） |
| `video` | `original_content_url`, `preview_image_url` | いずれもHTTPS必須 |
| `audio` | `original_content_url`, `duration` | `duration` はミリ秒 |
| `sticker` | `package_id`, `sticker_id` | |
| `button` | `template_id` | `sender_id` は無視される |

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `friend_id` | string | 必須 | LINE友だちID |
| `type` | string | 必須 | メッセージタイプ（`text`, `image`, `video`, `audio`, `sticker`, `button`） |
| `sender_id` | string | - | カスタム送信者ID（`type=button` では無視） |
| `reply_token` | string | - | リプライトークン。指定時はReply APIを試行し失敗でPushにフォールバック |
| `text` | string | 条件付き | メッセージ本文（`type=text` で必須、最大5000文字。置換URL・`rid` 付きURLは不可） |
| `original_content_url` | string | 条件付き | コンテンツURL（HTTPS必須。`type=image/video/audio` で必須） |
| `preview_image_url` | string | 条件付き | プレビュー画像URL（HTTPS必須。`type=video` で必須、`type=image` では指定不可） |
| `duration` | integer | 条件付き | 再生時間（ミリ秒。`type=audio` で必須） |
| `package_id` | string | 条件付き | スタンプパッケージID（`type=sticker` で必須） |
| `sticker_id` | string | 条件付き | スタンプID（`type=sticker` で必須） |
| `template_id` | string | 条件付き | テンプレートID（`type=button` で必須） |

**指示例:**

* 「この友だちに"ありがとうございます"とメッセージを送って」
* 「この友だちにテンプレートを送信して」

***

### message\_line\_chat\_message\_list

LINE友だちとの送受信メッセージ履歴を取得します（送信日時の降順）。`direction` で送信・受信を絞り込めます。

送信メッセージは配信APIの `line.messages[]` と同じフィールド・構造で返ります（`seq` とボタン動作の `action_details` は含みません）。受信メッセージのうち text / image / audio / file / video / template / location / sticker には `is_read`（管理側で既読にしたか。`false` が未読）が付きます。送信メッセージと follow / unfollow / postback / richmenutap には付きません。友だち側がメッセージを読んだかどうかではありません。既読にするには `message_line_chat_message_mark_as_read` を使います。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `friend_id` | string | 必須 | LINE友だちID |
| `direction` | enum | - | `sent`（送信のみ）／`received`（受信のみ）／`all`（全て、デフォルト） |
| `page` | integer | - | ページ番号（デフォルト1） |
| `per_page` | integer | - | 1ページあたりの件数（デフォルト20、最大100） |

**指示例:**

* 「この友だちとのやり取りを見せて」
* 「この友だちからの受信メッセージだけ表示して」

***

### message\_line\_chat\_message\_mark\_as\_read

LINE友だちとの1対1チャットの未読メッセージを全て既読にします（LINE チャット画面の「全て既読にする」と同じ操作）。送信・受信、メッセージタイプを問わず未読の履歴が全て既読になり、`message_line_friend_list` の `has_unread=true` の絞り込みから外れ、`message_line_chat_message_list` の受信メッセージの `is_read` も `true` になります。既に全て既読の友だちに実行しても成功を返し、ブロック中・配信除外の友だちにも実行できます。結果の `unread_count` は既読化後の未読受信メッセージ数です（通常は0）。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `friend_id` | string | 必須 | LINE友だちID |

**指示例:**

* 「この友だちのチャットを全て既読にして」
* 「この友だちの未読を消して」

***

## LINEテンプレート

### message\_line\_template\_list

LINEテンプレート一覧を取得します。`message_line_chat_message_send` の `template_id` や配信アクションの `template`（`line_template_id`）など、テンプレートIDを指定する操作のIDの取得元です。`template_group_id`・`name` で絞り込みできます。並び順は管理画面の一覧と同じで、未分類が先頭、次にテンプレートグループの表示順、グループの中はテンプレートの表示順です（グループの表示順が同じときはグループIDの昇順）。

メッセージ内容・URL設定は `message_line_template_get` で取得します。作成・更新・削除・並び替えは `message_line_template_create` / `message_line_template_update` / `message_line_template_delete` / `message_line_template_reorder`、テンプレートグループは `message_line_template_group_list` 等で操作します。応答の `updated_at` は、管理名称・テンプレートグループ・URL置換ドメインを更新したとき、またはAPIでメッセージ・URL設定を更新したときに進みます（管理画面でメッセージ本文だけを変えて保存した場合は進みません）。種類が `line` / `mail_line` 以外のアカウントでは空の一覧を返します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `template_group_id` | string | - | テンプレートグループIDで絞り込み（`message_line_template_group_list` で取得。存在しないIDは0件） |
| `name` | string | - | 管理名称で部分一致検索 |
| `page` | integer | - | ページ番号（デフォルト1） |
| `per_page` | integer | - | 1ページあたりの件数（デフォルト20、最大100） |

**指示例:**

* 「使えるLINEテンプレートの一覧を見せて」
* 「"キャンペーン"グループのLINEテンプレートを探して」

***

### message\_line\_template\_create

LINEテンプレートを作成します。テンプレートは最大5件のLINEメッセージのセットで、1対1チャット送信（`message_line_chat_message_send` の `type=button`）・配信アクション・LINE自動応答（`action_type=template`）・ボタン/カルーセルのボタン（`type=template`）から送信できます。`line.messages` の各要素は `message_create` の `line` と同じ形式・同じ制約で（タイプ別の項目は `message_types_line` を参照）、テンプレートには下書きが無いため、`message_create` の下書き（`status=draft`）のように項目を省略できず、`message_types_line` で `required` の項目は必須です。作成したテンプレートは所属グループ内（未分類なら未分類内）の末尾に並びます。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `name` | string | 必須 | 管理名称（最大255文字） |
| `template_group_id` | string | - | 所属させるテンプレートグループのID（`message_line_template_group_list` で取得。省略・`null` で未分類） |
| `shorten_domain` | string | - | URL置換ドメイン（管理画面で承認済みの独自ドメインのみ。省略・`null` でデフォルト） |
| `line` | object | 必須 | LINE原稿 `{sender_id?, messages: [...]}`（JSON文字列でも可）。`sender_id` は `message_line_sender_list` で取得（省略・`null` でデフォルト送信者）。`messages` は1〜5件 |
| `url_actions` | array | - | URL設定（JSON文字列でも可）。本文・ボタンに含まれるURLごとに、クリック時に実行するアクションとリンクの期限を設定します |

**主な制約:**

* ボタン（`type=message` / `nothing`）と `url_actions[]` の `action_details` で、押下時・クリック時に実行するアクションをテンプレートの中で直接作成できます（管理画面の「新規にアクションを追加」と同じ。アクション一覧には出ません。形式・制約は `message_create` の `action_details` と同じ）。作成では同じ箇所の `action_id` と同時に指定できません
* ボタン内の `line_template_id` / `action_id` / `add_label_id` / `del_label_id` と `url_actions[].action_id` は同じアカウントに存在するIDのみ（存在しないIDは validation\_error）
* `image` / `imagemap` の画像は取り込まれ、応答の `original_content_url` は取り込み後のURLになります。取り込みに失敗した場合は validation\_error で何も保存されません
* 本文・ボタンのURL・応答テキストに配信済みメッセージの置換URL・`rid` 付きURLを含む場合は validation\_error
* `url_actions[]`: `{url, action_id?, action_details?, expiration_type: none/scheduled/scheduled_addition/datetime, expiration_day(0〜365), expiration_hour(0〜23), expiration_min(0〜59), expiration_date(YYYY-MM-DD), expiration_redirect_url}`。`url` は重複不可。`scheduled` は送信からN日後のH時M分（day・hour 必須）、`scheduled_addition` は送信からN日H時間M分後（いずれか1つ以上）、`datetime` は指定した日時（date・hour 必須）

**指示例:**

* 「"初回案内"というLINEテンプレートを作って、1件目にテキスト、2件目に画像を入れて」
* 「このメッセージ内容でテンプレートを作成して、グループ"キャンペーン"に入れて」

***

### message\_line\_template\_get

LINEテンプレートの詳細（メッセージ内容・URL設定）を取得します。結果の `line` / `url_actions` は `message_line_template_update` にそのまま送り返せる形式です。ボタンと `url_actions[]` の `action_details` は、テンプレートの中で直接作成したアクションが設定されているときだけ動作の配列になり、アクション一覧のアクションを参照しているとき・未設定のときは `null` です（配列のときの `action_id` はその設定箇所専用で、`message_action_get` では取得できません）。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `template_id` | string | 必須 | テンプレートID |

**指示例:**

* 「このテンプレートの内容を見せて」
* 「このテンプレートのURL設定を確認して」

***

### message\_line\_template\_update

LINEテンプレートを部分更新します。指定したフィールドのみ変更され、省略したフィールドは既存値を維持します。`line.messages` を指定すると全件置換、`line.sender_id` のみの指定も可能です（既存のメッセージを維持して送信者だけ変更。`null` でデフォルト）。`url_actions` は指定時に全件置換（空配列でクリア）、`template_group_id` は `null` で未分類に変更します。空のボディは何も変更せず現在値を返します。`message_line_template_get` の結果をそのまま送り返しても内容は変わりません（更新前と同じ送信者・参照先は再検証せずに維持し、更新前と同じ画像URL（本APIまたは管理画面で取り込んだもの）は再取り込みしません）。新しく指定する項目の制約は `message_line_template_create` と同じです。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `template_id` | string | 必須 | テンプレートID |
| `name` | string | - | 管理名称（最大255文字） |
| `template_group_id` | string | - | テンプレートグループのID（`null` で未分類に変更） |
| `shorten_domain` | string | - | URL置換ドメイン（`null` でデフォルトに戻す） |
| `line` | object | - | LINE原稿（JSON文字列でも可）。`messages` を指定すると全件置換（1〜5件）。`sender_id` のみの指定も可 |
| `url_actions` | array | - | URL設定（JSON文字列でも可）。指定時は全件置換、空配列でクリア |

**注意事項:**

* ボタン・`url_actions[]` の `action_details` の指定方法は `message_update` と同じです。既存のボタンの動作を書き換えるときは取得結果の `action_id` を付けたまま `action_details` を指定し（省略すると新しく作成）、`url_actions[]` の `action_id` は省略するか取得結果の同じ `url` の値のままにします
* 画像の取り込みに失敗した場合は validation\_error で何も変更されません

**指示例:**

* 「このテンプレートの管理名称を"再案内"に変えて」
* 「このテンプレートの1件目のテキストを差し替えて」
* 「このテンプレートを"キャンペーン"グループに移して」

***

### message\_line\_template\_delete

LINEテンプレートを削除します。自動応答・配信アクションからの参照は残りますが、削除済みのテンプレートは送信されません。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `template_id` | string | 必須 | テンプレートID |

**指示例:**

* 「このテンプレートを削除して」

***

### message\_line\_template\_reorder

LINEテンプレートの表示順を変更します（LINE テンプレート画面の「表示順変更」と同じ操作）。グループの表示順・テンプレートの所属グループ・グループ内の表示順を一括で更新します。`groups` には未分類（`template_group_id: null`）の要素を先頭に1つ置き、全テンプレートグループと削除済みを除く全テンプレートを過不足なく指定します（過不足・重複・未分類が先頭以外はエラー validation\_error）。所属グループだけを変えたい場合は `message_line_template_update` の `template_group_id` でも変更できます。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `groups` | array | 必須 | グループごとのテンプレート並びの配列（JSON文字列でも可）。各要素は `{template_group_id: グループID（null=未分類。先頭に置く）, template_ids: [並べたい順のテンプレートID]（空配列可）}`。配列順がグループの表示順になります |

**指示例:**

* 「テンプレート"初回案内"を一番上に移動して」
* 「"キャンペーン"グループを未分類の次に並べて」

***

### message\_line\_template\_group\_list

LINEテンプレートのグループ（LINE テンプレート画面の「グループ管理」）の一覧を表示順で全件取得します。グループはテンプレートの分類用で、グループ名と表示順を持ちます。未分類はグループとして存在しないため含まれません（未分類のテンプレートは `template_group_id` が `null`）。種類が `line` / `mail_line` 以外のアカウントでは空配列を返します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |

**指示例:**

* 「LINEテンプレートのグループ一覧を見せて」

***

### message\_line\_template\_group\_create

LINEテンプレートのグループを作成します。作成したグループは一覧の末尾に追加されます。テンプレートの所属は `message_line_template_create` / `message_line_template_update` の `template_group_id`、または `message_line_template_reorder` で設定します。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `name` | string | 必須 | グループ名（最大255文字） |

**指示例:**

* 「"キャンペーン"というテンプレートグループを作って」

***

### message\_line\_template\_group\_get

LINEテンプレートのグループの詳細（グループ名・表示順）を取得します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `template_group_id` | string | 必須 | テンプレートグループID |

**指示例:**

* 「このテンプレートグループの詳細を見せて」

***

### message\_line\_template\_group\_update

LINEテンプレートのグループ名を変更します。管理画面のグループ管理と同じく、グループ名は `null` でも保存できます。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `template_group_id` | string | 必須 | テンプレートグループID |
| `name` | string | - | グループ名（最大255文字） |

**指示例:**

* 「このテンプレートグループの名前を"季節キャンペーン"に変えて」

***

### message\_line\_template\_group\_delete

LINEテンプレートのグループを削除します。削除されていないテンプレートが1件でも所属している場合はエラー（conflict）になるため、先に `message_line_template_update` / `message_line_template_reorder` で所属を外してください。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `template_group_id` | string | 必須 | テンプレートグループID |

**指示例:**

* 「このテンプレートグループを削除して」

***

## LINEリッチメニュー

### message\_line\_richmenu\_list

LINEリッチメニューの一覧を取得します。アーカイブ済みも含めて返し（`is_archived` で判別）、並びはアーカイブ済みでないものが先、次に表示順です。`message_line_friend_menu_update` の `rich_menu_id` や配信アクションのリッチメニュー切替で指定するIDの取得元です。`rich_menu_group_id` で所属グループを絞り込めます（存在しないIDは0件）。リッチメニューの作成・編集はAPIの対象外です（管理画面で行います）。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `rich_menu_group_id` | string | - | リッチメニューグループIDで絞り込み（`message_line_richmenu_group_list` で取得） |

**指示例:**

* 「このアカウントのリッチメニュー一覧を見せて」
* 「"会員向け"グループのリッチメニューだけ表示して」

***

### message\_line\_richmenu\_group\_list

LINEリッチメニューのグループ（LINE リッチメニュー画面の「グループ管理」）の一覧を表示順で全件取得します。グループはリッチメニューの分類用で、グループ名と表示順を持ちます。未分類はグループとして存在しないため含まれません（未分類のリッチメニューは `rich_menu_group_id` が `null`）。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |

**指示例:**

* 「リッチメニューのグループ一覧を見せて」

***

### message\_line\_richmenu\_group\_create

LINEリッチメニューのグループを作成します。作成したグループは一覧の末尾に追加されます。リッチメニューの所属は管理画面（リッチメニューの登録・編集、表示順変更）で設定します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `name` | string | 必須 | グループ名（最大255文字） |

**指示例:**

* 「"会員向け"というリッチメニューグループを作って」

***

### message\_line\_richmenu\_group\_get

LINEリッチメニューのグループの詳細（グループ名・表示順）を取得します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `rich_menu_group_id` | string | 必須 | リッチメニューグループID |

**指示例:**

* 「このリッチメニューグループの詳細を見せて」

***

### message\_line\_richmenu\_group\_update

LINEリッチメニューのグループ名を変更します。`name` を指定する場合は空にできません（validation\_error）。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `rich_menu_group_id` | string | 必須 | リッチメニューグループID |
| `name` | string | - | グループ名（最大255文字） |

**指示例:**

* 「このリッチメニューグループの名前を"新規向け"に変えて」

***

### message\_line\_richmenu\_group\_delete

LINEリッチメニューのグループを削除します。リッチメニュー（アーカイブ済みを含む）が1件でも所属している場合はエラー（conflict）になるため、管理画面で所属を外してから削除してください。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `rich_menu_group_id` | string | 必須 | リッチメニューグループID |

**指示例:**

* 「このリッチメニューグループを削除して」

***

## LINE自動応答

### message\_line\_autoreply\_list

LINE自動応答の一覧を表示順で取得します。自動応答はLINE友だちからテキストメッセージを受信したときの応答設定で、一覧の表示順にキーワード応答（`response_type=keyword`）を評価して最初に一致した1件だけを実行し、どのキーワードにも一致しない場合は一律応答（`response_type=all_messages`）のうち表示順で最初の1件を実行します。表示順の変更はAPIの対象外です（管理画面の「表示順変更」で行います）。種類が `line` / `mail_line` 以外のアカウントでは空配列を返します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `autoreply_group_id` | string | - | 自動応答グループIDで絞り込み（`message_line_autoreply_group_list` で取得。存在しないIDは0件） |
| `name` | string | - | 管理名称で部分一致検索 |
| `page` | integer | - | ページ番号（デフォルト1） |
| `per_page` | integer | - | 1ページあたりの件数（デフォルト20、最大100） |

**指示例:**

* 「このアカウントのLINE自動応答一覧を見せて」
* 「"資料"という管理名称の自動応答を探して」

***

### message\_line\_autoreply\_create

LINE自動応答を作成します。`response_type=keyword`（キーワード応答）のとき `keyword_type` と `keywords` が必須で、`action_type` に応じて `message`（メッセージを送信）/ `action_id`（アクションを実行）/ `line_template_id`（テンプレートを送信）のうち対応するものが必須です。作成した自動応答は一覧の末尾（最も低い優先度）に追加されます。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `name` | string | 必須 | 管理名称（最大255文字） |
| `autoreply_group_id` | string | - | 所属させる自動応答グループのID（`message_line_autoreply_group_list` で取得。省略・`null` で未分類） |
| `response_type` | string | 必須 | 応答タイプ。`keyword`=キーワード応答（キーワードのいずれかに一致したときのみ動作）、`all_messages`=一律応答（どのキーワード応答にも一致しなかった全てのテキストメッセージに動作） |
| `keyword_type` | string | - | 一致。`part`=部分一致（受信メッセージにキーワードが含まれれば一致）、`all`=完全一致。`response_type=keyword` のとき必須 |
| `keywords` | array | - | キーワードの文字列配列（JSON文字列でも可）。いずれか1つに一致すれば実行。`response_type=keyword` のとき必須（1〜100件・各255文字以内・合計65,535バイト以内）。改行は含められず、`"0"` は指定不可（一致判定の対象にならないため） |
| `action_type` | string | 必須 | 動作。`message`=メッセージを送信、`action`=アクションを実行、`template`=テンプレートを送信 |
| `message` | string | - | 送信するメッセージ本文（`action_type=message` のとき必須・最大5,000文字。配信済みメッセージの置換URL・`rid` 付きURLは不可） |
| `action_id` | string | - | 実行するアクションのID（`action_type=action` のとき必須。`message_action_list` で取得） |
| `line_template_id` | string | - | 送信するLINEテンプレートのID（`action_type=template` のとき必須。`message_line_template_list` で取得） |

**指示例:**

* 「"資料"という言葉を含むメッセージが来たら資料のURLを返す自動応答を作って」
* 「どのキーワードにも当てはまらないメッセージには"担当者が確認します"と返す一律応答を作って」

***

### message\_line\_autoreply\_get

LINE自動応答の詳細を取得します。結果では `response_type` / `action_type` に対応する項目のみ値が入り、対応しない項目は `null` です（一律応答では `keyword_type` / `keywords` が `null`、など）。`action_id` は管理画面の自動応答編集内で直接作成したアクションを指す場合があり、その場合は `message_action_list` / `message_action_get` では取得できません（更新時にそのまま送り返せば参照は維持されます）。`line_template_id` は削除済みのテンプレートを指す場合があり、その場合は `message_line_template_list` に現れず、削除されている間は何も送信されません。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `autoreply_id` | string | 必須 | 自動応答ID |

**指示例:**

* 「この自動応答の設定を見せて」
* 「この自動応答のキーワードを確認して」

***

### message\_line\_autoreply\_update

LINE自動応答を部分更新します。省略したフィールドは既存値を維持します。`keyword_type` / `keywords` / `message` / `action_id` / `line_template_id` は `null` を指定しても既存値を維持し（取得結果の送り返し用。`keywords` はキーワード応答のまま更新する場合に限り空配列も既存維持）、`autoreply_group_id` のみ `null` で未分類に変更します。`response_type` / `action_type` を変更する場合は、変更後に使う設定（キーワード応答へ変更なら `keywords`、動作の変更なら `message` / `action_id` / `line_template_id` のうち対応するもの）の指定が必須です。`message_line_autoreply_get` の結果をそのまま送り返しても設定は変わりません（例外: 管理画面で登録した5,000文字超の `message` を含む場合は validation\_error になるため、`message` を省略して更新します）。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `autoreply_id` | string | 必須 | 自動応答ID |
| `name` | string | - | 管理名称（最大255文字） |
| `autoreply_group_id` | string | - | 自動応答グループのID（`null` で未分類に変更） |
| `response_type` | string | - | 応答タイプ。`keyword`=キーワード応答、`all_messages`=一律応答 |
| `keyword_type` | string | - | 一致。`part`=部分一致、`all`=完全一致 |
| `keywords` | array | - | キーワードの文字列配列（JSON文字列でも可。変更する場合は1〜100件・各255文字以内・合計65,535バイト以内・改行不可・`"0"` 指定不可） |
| `action_type` | string | - | 動作。`message`=メッセージを送信、`action`=アクションを実行、`template`=テンプレートを送信 |
| `message` | string | - | 送信するメッセージ本文（最大5,000文字。配信済みメッセージの置換URL・`rid` 付きURLは不可） |
| `action_id` | string | - | 実行するアクションのID（`message_action_list` で取得） |
| `line_template_id` | string | - | 送信するLINEテンプレートのID（`message_line_template_list` で取得） |

**指示例:**

* 「この自動応答のキーワードに"パンフレット"を追加して」
* 「この自動応答の動作をテンプレート送信に変えて、テンプレート"資料案内"を送るようにして」

***

### message\_line\_autoreply\_delete

LINE自動応答を削除します。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `autoreply_id` | string | 必須 | 自動応答ID |

**指示例:**

* 「この自動応答を削除して」

***

### message\_line\_autoreply\_group\_list

LINE自動応答のグループ（LINE 自動応答画面の「グループ管理」）の一覧を表示順で全件取得します。`message_line_autoreply_create` / `message_line_autoreply_update` の `autoreply_group_id` や `message_line_autoreply_list` の絞り込みに使います。グループの作成・変更・削除はAPIの対象外です（管理画面で行います）。未分類はグループとして存在しないため含まれません。種類が `line` / `mail_line` 以外のアカウントでは空配列を返します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |

**指示例:**

* 「自動応答のグループ一覧を見せて」

***

## LINEカスタム送信者

### message\_line\_sender\_list

LINEカスタム送信者の一覧を取得します。名前で部分一致検索できます。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `name` | string | - | 送信者名で部分一致検索 |
| `page` | integer | - | ページ番号 |
| `per_page` | integer | - | 1ページあたりの件数（デフォルト20、最大100） |

**指示例:**

* 「このアカウントのLINE送信者一覧を見せて」

***

### message\_line\_sender\_create

LINEカスタム送信者を作成します。`icon_url` はHTTPS必須かつPNG形式（拡張子 `.png`）のみ受け付けます。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `name` | string | 必須 | 送信者名（最大20文字） |
| `icon_url` | string | 必須 | プロフィール画像URL（HTTPS必須・PNG形式のみ、最大255文字） |

**指示例:**

* 「"サポート窓口"というLINE送信者を作成して」

***

### message\_line\_sender\_get

LINEカスタム送信者の詳細を取得します。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `sender_id` | string | 必須 | 送信者ID |

**指示例:**

* 「このLINE送信者の詳細を見せて」

***

### message\_line\_sender\_update

LINEカスタム送信者を部分更新します。指定したフィールドのみ変更され、省略したフィールドは既存値を維持します。`icon_url` はHTTPS必須かつPNG形式（拡張子 `.png`）のみ受け付けます。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `sender_id` | string | 必須 | 送信者ID |
| `name` | string | - | 送信者名（最大20文字） |
| `icon_url` | string | - | プロフィール画像URL（HTTPS必須・PNG形式のみ、最大255文字） |

**指示例:**

* 「このLINE送信者の名前を変更して」
* 「このLINE送信者のアイコンを差し替えて」

***

### message\_line\_sender\_delete

LINEカスタム送信者を削除します。種類が `line` / `mail_line` 以外のアカウントではエラー（validation\_error）になります。

**パラメータ:**

| パラメータ | 型 | 必須 | 説明 |
| - | - | - | - |
| `account_id` | string | 必須 | アカウントID |
| `sender_id` | string | 必須 | 送信者ID |

**指示例:**

* 「このLINE送信者を削除して」


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.