L Message（エルメ）

Upload a PDF document via fileParams and receive its {download_url, file_id} object. Use the returned download_url as the 'url' in send_media_to_friend.media_items[{type:'pdf', url:...}]. NEVER paste external URLs (Azure blob, OpenAI CDN, etc.) — they expire or are inaccessible to LME. If you generated the PDF with code interpreter, you must first display it to the user (e.g. as a download link) before calling this tool — displaying the file uploads it to storage and makes the file_id available.

Upload a video file (mp4) via fileParams and receive its {download_url, file_id} object. Use the returned download_url as the 'url' in send_media_to_friend.media_items[{type:'video', url:...}]. NEVER paste external URLs (Azure blob, OpenAI CDN, etc.) — they expire or are inaccessible to LME.

トリガータイプ（add_new/add_old/unblock）のあいさつメッセージ取得。返却 {actionId, message, actions[]}。update_welcome_message の前に呼んで結果をコピーする: update はメッセージ + actions 全体を置き換えるため、完全なセットを再送すると変更していない内容が保持される。

get_welcome_message

トリガータイプ（add_new/add_old/unblock）のあいさつメッセージ更新。先に get_welcome_message を呼んで現在の状態を確認します。actions を省略（または null）した場合は既存のアクションチェーンを維持します — ツールがサーバーから読み直して再送します。actions を送る場合はチェーン全体の置き換えになるため、残したいアクションもすべて含めてください。すべてのアクションを削除したい場合は、まず現在のアクションチェーンを提示して確認を得てから update_welcome_message(actions=[]) を呼び出します。テキスト（≤5000）。actions は型付き DetailAction {title,type,active,isEditContent,data}; タイプ別 `data` は `actions` 入力スキーマ参照。タイプ: tag|scenario|richmenu|text|bookmark|friend_info|block|handling_status|template。

update_welcome_message

ボットと同じ admin に属するアフィリエイター一覧を返すツール。各項目は 'id'（生整数）, 'username', 'email' を持つ。ブロードキャストフィルタ type='affiliate' を組み立てる前に呼び出し、affiliate_search にこのリストの実際の affiliater.id、preview_original にこのリストの username を使います。オプションの 'usernames' フィルタ（完全一致、大文字小文字区別なし、前後空白トリム）をサポート。'usernames' を指定した場合、どのアフィリエイターにも完全一致しなかった名前は 'not_found_usernames' に含まれる。

list_affiliaters

ボットのイベント一覧（トップレベル、type_event_new=1）を返すツール。メッセージ配信のクイックリプライ等で参照するイベント予約URL（LIFF）構築用に、イベントタイトル→IDの解決に使用。オプションの 'titles' フィルタ（イベント 'title' に対する部分一致、大文字小文字区別なし、前後空白トリム）をサポート。'titles' を指定した場合、ヒットゼロだったパターンは 'not_found_titles' に含まれます。レスポンス形式: { events: [{ id, title }], not_found_titles?: [...] }、positionでソート。

list_events

行タイプ・列数・下書きステータスを含むクロス分析設定一覧を返すツール

list_crosslytics

特定の日付のクロス分析結果テーブル（行×列ごとの友だち数）を返すツール

get_crosslytics_result

行設定・列フィルター・表示タイプ・利用可能な結果日を含む複数クロス分析の詳細設定を返すツール

get_crosslytics_detail

ボットのコンバージョン一覧をカテゴリごとにグループ化して返すツール。各カテゴリは {id（生整数）, name} を持つコンバージョン配列を含む。ブロードキャストフィルタ type='conversion' を組み立てる前に呼び出します。conversion_search はこのリストの実際の conversion.id（CSV文字列）、open_group は選択したコンバージョンの category.id（複数選択時は同一カテゴリ）、preview_original はコンバージョン名（複数時は '・' で連結）です。オプションの 'names' フィルタ（コンバージョン名の完全一致、大文字小文字区別なし、前後空白トリム）をサポート。

list_conversions

サービス数・スタッフ数・総予約数を含むサロン予約センター一覧を返すツール。オプションの 'calendar_names' フィルタ（管理用 calendar_name への部分一致、大文字小文字区別なし、トリム）をサポート。指定時、レスポンスに 'not_found_calendar_names' を含む。

list_salons

サービス・スタッフ・支払い状況・フォーム回答を含むサロンの予約履歴（ページネーション付き）を返すツール

get_salon_bookings

メニュー別サービス・スタッフ・予約フォーム・承認設定とアクション・バッファ時間を含む複数サロン設定の詳細を返すツール

get_salon_detail

シナリオステップ専用テンプレート（category_id=-111）を作成または編集します。CREATE: data.templateChildId を省略（または0） → 新規作成＆ステップ追加。UPDATE: data.templateChildId を指定（非ゼロ、get_scenario_detail から取得） → 既存編集（type は変更不可）。video/voice/stamp 非対応。UPDATE 前に必ず get_template_detail(template_id=templateChildId) で現在のデータを取得し、data フィールドをクローンして変更箇所だけ修正すること。ネスト配列（form の buttons/detail_action、image-map items）は全置き換え — 既存エントリを省略すると削除される（例: 既存 detail_action を省略するとボタンのアクションが消える）。

save_scenario_step_template

シナリオのステップ（タイミングスロット）を作成または更新するツール。`step_id` が null → 新規作成、非 null → 既存ステップのタイミング更新。Laravel AJAX POST /basic/scenario/create-step に対応。保存後、サーバーが scenario 内全ステップを (start_day ASC, start_time ASC, id ASC) で自動並べ替え。同一 (delay_type, start_day, start_time, filter_manager_id) ステップは拒否。フィルター付きステップのタイミングを更新する場合は、既存の filter_manager_id を一緒に渡してフィルターを保持すること。

save_scenario_step

シナリオステップ用フィルタブランチを作成または更新するツール。filter_manager_id=null → 新規作成（返り値 parentIdNew を step_id=null の save_scenario_step に渡して紐付け）。filter_manager_id=X → 既存フィルタブランチ X を上書き更新（新規ステップ不要）。FilterItem 形式は guide_filter_structure / guide_filter_grouping を参照。

save_scenario_filter

シナリオフォルダ（category kind=11）を作成または名前変更するツール。folder_id=null で新規作成、folder_id=<id> で既存フォルダの名前変更。 曖昧さ回避: ユーザーが明示的にシナリオフォルダの作成を求めた場合のみ、このツールを呼び出してください。種類を指定せず「フォルダを作成」とだけ言われた場合は、呼び出す前にどの種類か（タグ / 自動返信 / テンプレート / 友だち情報 / シナリオ）を確認してください。

create_scenario_folder

list_scenarios: フォロワー数・完了数・離脱数の統計を含むシナリオ一覧を返すツール。ボットのシナリオを一覧取得し、名前からシナリオIDを引く。names[]で名前→数値IDを一括解決（完全一致・大文字小文字区別なし）— get_scenario_detail・update_scenario など scenario_id が必要な呼び出し前に使用。not_found_names に未マッチ名を含む。

list_scenarios

新しいシナリオ（ステップ配信シーケンス）を作成します。`name` は必須（20文字以内）。`folder_id` を指定する場合はボット所属の kind=11 フォルダ、`next_scenario_id` を指定する場合はボット所属のシナリオである必要があります。サーバーが検証し、不正な入力は拒否します。

create_scenario

シナリオの名前・フォルダ・次のシナリオを更新します。シナリオはボットに属している必要があります。`name` は毎回含めてください（20文字以内）— フォルダや次のシナリオのみ変更する場合は現在の名前を再送信します。`folder_id` は毎回の呼び出しに含めます：有効な kind=11 フォルダ ID を渡すと移動、現在のフォルダを維持する場合は `list_scenarios[].folder_id` の現在値を渡します — 0 と null はどちらも「現在のフォルダを維持」の意味なので、このツールでルートへ戻すことはできません。非ゼロの場合は kind=11 フォルダ、`next_scenario_id` を指定する場合はボット所属である必要があります。サーバーが検証します。`next_scenario_id` は `folder_id` とは挙動が異なります：省略（または null）すると既存の次シナリオ連携が解除されます。名前やフォルダだけを変更する場合も、get_scenario_detail で現在値を読み取って再送信してください。

update_scenario

各ステップ・メッセージ内容・タイミング・送信数・フィルター条件を含む複数シナリオの詳細を返すツール

get_scenario_detail

タグカタログ（list_tags）: タグを列挙・名前からtag_idを引くルックアップツール（読み取り専用）。tag_idが必要で名前しか分からない場合に呼ぶ。names[]で名前→id解決（完全一致・大文字小文字区別なし）、未一致は not_found_names に返る。各タグの id・name・tagged_user_count（タグ付き友だち数）を返す。

list_tags

新しいタグフォルダ（category kind=0）を作成するツール。Laravel EP-21 POST /ajax/v2/tag/category/create に対応。 kind=0 と position=max+1 はバックエンドで自動設定。レスポンス: { message, item: { id, bot_id, name, kind, position, count } }。 `name` は必須（空文字不可、15文字以内）。 曖昧さ回避: ユーザーが明示的にタグフォルダの作成を求めた場合のみ、このツールを呼び出してください。種類を指定せず「フォルダを作成」とだけ言われた場合は、呼び出す前にどの種類か（タグ / 自動返信 / テンプレート / 友だち情報 / シナリオ）を確認してください。

create_tag_folder

list_tag_folders: ボットのタグフォルダ一覧（category kind=0）を返すツール。フォルダ名→数値フォルダIDを解決— create_tag(category_id)・update_tag(category_id) など folder_id が必要な呼び出し前に使用。ユーザーがフォルダ未指定の場合は呼び出し不要（category_id 省略でデフォルト 0）。

list_tag_folders

既存のタグフォルダ名を変更するツール。Laravel EP-22 PUT /ajax/v2/tag/category/update/{id} に対応。 条件: フォルダは存在し、指定ボットに属し、kind=0 で、ソフト削除されていない必要があります。 `name` は必須（空文字不可、15文字以内）。

update_tag_folder

1回の呼び出しで複数のプレーンタグを一括作成するツール。Laravel EP-13 POST /ajax/v2/tag/create-multiple に対応。 `create_tag` のループより本ツールを優先する条件: ユーザーがプレーンタグを 2 件以上指定（「タグ A, B, C をフォルダ X に作成」「3 つのタグ追加」「春/夏/秋/冬 のタグ」等）。全タグは同じフォルダ（1 つの `category_id`）に入る。異なるフォルダの場合はフォルダ毎に複数回呼び出す。1 件のタグ、またはアクションチェーン / is_limit / is_2th_apply が必要な場合は `create_tag` を使う。 バックエンド動作（Laravel）: バルク INSERT、position はフォルダ内で自動採番、BotsTutorial.status_tag を 1 に更新。アクションチェーンは添付されない（プレーンタグ名のみ）。 オールオアナッシング: `names` のいずれか1つでも同 bot 内のアクティブタグと重複する場合、バッチ全体が拒否される（Laravel が `Tags::whereIn('name', $names)` で事前チェック）。MCP層では、入力配列内の重複も事前に拒否する（大文字小文字無視・trim 後比較）。 バリデーション: bot_id 有効、`names` 件数 1〜20（管理画面 UI 上限「同時に20個までタグが作成できます」とパリティ。Laravel 自体は 20 を強制しないが、MCP は UI に揃えてバッチ作成後も Web から編集可能な状態を保つ）、各 name は trim 後非空・50文字以内・改行/CR/タブ等の制御文字を含まない、`names` 内に重複がない、`category_id` 指定時は kind=0 タグフォルダで指定ボット所属・未削除である必要があります。

create_multiple_tags

ボットに 1 つのタグ（任意でアクションチェーン・人数制限付き）を作成するツール。 ユーザーが「アクションなしのプレーンタグを 2 件以上」（同フォルダでも）作成したい場合は `create_multiple_tags` を使うこと — Laravel EP-13 のバルクで 1 回の呼び出しで N 件作成（create_tag を N 回ループするとラウンドトリップ × N、アクションチェーン検証 × N、部分失敗による不整合リスクあり）。`create_tag` は (a) 1 件のタグ、または (b) `actions` / `limit_actions` / `is_limit` / `is_2th_apply` が必要なタグの場合のみ使用。 前提条件: • ユーザーがフォルダ名を指定した場合 → `list_tag_folders` で category_id に解決。フォルダ未指定の場合 → category_id を省略（デフォルト 0 = 未分類仮想フォルダ）。 • `actions` / `limit_actions` が template_id / scenario_id / friend_info field_id / tag_id / richmenu_id / handling_status id を参照する場合 → 対応する list_* ツールで ID を解決。 バリデーション（LME呼び出し前にチェック）: タグ `name` は必須（空文字不可、50文字以内、改行/CR/タブの制御文字なし）。`is_limit=true` の場合、`limit` は正の整数。タイプ別 `data` は `actions`（DetailAction）入力スキーマを参照。 フォルダチェック: `category_id > 0` の場合、フォルダはボットに属する既存のタグフォルダ（kind=0）である必要があります。 ID所有権: `actions[]` / `limit_actions[]` 内で参照されるエンティティID（tag/scenario/richmenu/friend_info/handling_status/template）と `data.filters` 内の埋め込みIDは、ボット所有権をチェックし、ボットに属さないIDをタイプ別にまとめてエラーで返す。参照するIDは事前に対応する list_* ツールで解決する。

create_tag

既存タグの設定（名前、フォルダ、アクションチェーン、人数制限）を更新するツール。 Laravel `/ajax/save-tag` を `action=edit_tag` + `tag_id` で呼び出す（create_tag と同一エンドポイントの編集モード）。 全置換セマンティクス: `actions` / `limit_actions` は既存チェーン全体を置き換える。現在のチェーンを保持するには、先にタグ設定詳細ツールを呼び、`setting_actions` / `setting_limit_actions` をコピーし、変更箇所のみ編集して再送する。actions を空にすると既存チェーンはクリアされる。MCP層が既存タグへのチェーン対応を自動で行う。 バリデーション: `tag_id` は指定ボットに属し未削除である必要があります。`name` は必須（空文字不可、50文字以内、改行/CR/タブの制御文字なし）。`is_limit=true` の場合は `limit` を正の整数で指定。`category_id > 0` の場合、フォルダはボット所属の既存タグフォルダ（kind=0）である必要があります。アクションの `data` 形状は create_tag と同じ。 ID所有権: `actions[]` / `limit_actions[]` 内で参照されるエンティティID（tag/scenario/richmenu/friend_info/handling_status/template）と `data.filters` 内の埋め込みIDは、ボット所有権をチェックし、ボットに属さないIDをタイプ別にまとめてエラーで返す。参照するIDは事前に対応する list_* ツールで解決する。

update_tag

特定タグが付与された友だち一覧（ページネーション付き）を返すツール

get_tag_friends

1つのタグの完全な設定（アクションチェーン `setting_actions` および人数制限アクションチェーン `setting_limit_actions` を含む）を返すツール。 `update_tag` の前に使用: `setting_actions` / `setting_limit_actions` をコピーし、変更するフィールドのみ編集して `update_tag.actions` / `update_tag.limit_actions` に渡す。update_tag はチェーン全体を置き換えるため、完全なチェーンを送ることで変更していないアクションが保持される。 レスポンス（Map パススルー）: { status: bool, data: { id, name, bot_id, category_id, action_id, limit_action_id, is_limit, limit, is_2th_apply, count_user_tag, setting_actions: [...], setting_limit_actions: [...] } }

get_tag_detail

動的テキストコンテンツトークン（LME の PHP バックエンドがメッセージ送信時に受信者ごとに解釈・置換するプレースホルダー）の仕様を返す。対象: {name}、[remain to=YYYY-MM-DD]、[date add=N]、[date_format=FMT]、[FRIEND_INFO_<encoded_id>]、サーバー側 {CURRENT_TS}。使用テキストフィールド（CRUD オペレーション間で共通）: message_button.content（クイックリプライチップヘッダー）、message_text.content（altText）、panel.title/text、detail_action type=text data.content。ユーザーが明示的に要求したときのみトークンを挿入してください。パラメータなし。

guide_text_content_tokens

既存の親パーク内にスタンドアロンの TEXT メッセージテンプレートを作成。プレーンテキストメッセージを作りたいときに使用。image/video/voice/location/form には使わない — 対応する create_<type>_template を呼ぶ。親パーク必須: 先に create_park_template(child_template_ids=[]) で template_group_id を取得。レスポンス {template_id, success}。新セットルール: 新しいユーザーリクエストごとに create_park_template を呼んで新規パークを取得します — ユーザーが既存パークへの追加を明示しない限り、前回の park_template_id は再利用しません。

create_text_template

スタンドアロンの TEXT テンプレートを完全置換（差分不可）。呼び出し直前に get_template_detail(template_id) で最新値を取得すること — 会話の以前のデータは使わない（ウェブで編集されている可能性があるため）。その最新レスポンスから完全なペイロードを構築してから呼び出す。template_id ＋ template_group_id 両方必須。type は変更不可 — text タイプのテンプレートのみに使用。

update_text_template

新規テンプレートフォルダ（category kind=2）を作成。MCP: name 1〜20文字。PHP が position を自動採番（BR-04: 最大値+1）。レスポンス: { success, folder_id }。 曖昧さ回避: ユーザーが明示的にテンプレートフォルダの作成を求めた場合のみ、このツールを呼び出してください。種類を指定せず「フォルダを作成」とだけ言われた場合は、呼び出す前にどの種類か（タグ / 自動返信 / テンプレート / 友だち情報 / シナリオ）を確認してください。

create_template_folder

既存テンプレートフォルダ名を変更。MCP: フォルダ存在＋kind=2＋所属＋未削除、name 1〜20文字。

update_template_folder

複数テンプレートを別フォルダへ一括移動（アトミック）。フォルダ変更のみの場合、タイプ別更新ツール（update_text_template・update_image_template ほか）のループの代わりに使用。MCP: 全 template_ids 存在＋所属＋アクティブ（all-or-nothing）、target_category_id ≥0（0=未分類、>0 はフォルダ存在＋kind=2）。

bulk_move_templates

ボット配下のテンプレートを一覧参照・名前でtemplate_id取得するツール。names[]で名前→id変換（完全一致・大文字小文字区別なし）、省略で全件をフォルダ別・カテゴリ別に一覧表示。戻り値: { categories: [{category_id, category_name, templates: [{id, name, type}]}], not_found_names, pagination }。

list_templates

テンプレート1件の完全な内容を返すツール。対応する更新ツール（update_text_template・update_image_template・update_location_template・update_form_template・update_park_template）を呼ぶ前にクローン用として使用。シナリオステップ専用テンプレート（category_id=-111）にも対応 — get_scenario_detail.steps[].templates[].id のテンプレートIDを渡す。save_scenario_step_template前に完全なデータ（image のタップゾーン・アクション、form の buttons/detail_action）を取得するために使用してください。指定ボット所属＋未削除を事前チェック。

get_template_detail

ボット経由で既存テンプレート（テキスト/画像/動画/ボタン等）を1人のLINE友だちに送信するツール。テキストの上書き可能。グループテンプレート（複数サブテンプレート）の場合は遅延なしで一括送信。送信ステータスを返す。副作用: ボットの `is_confirm` 設定が有効の場合（チャット 1:1 フェーズ 2）、送信成功時に対応状態を自動確認（`conversation.confirm_count` を 0 にクリア）。以降そのスレッドは `list_conversations(confirm_status=0)` = 既読/対応済みで一致。

send_template_to_friend

フィルター AND/OR グルーピングルール — ユーザープロンプトの接続詞（và/hoặc/and/or/または/もしくは）を {and:[], or:[]} フィルター構造にマッピングする方法。含む: structure、combined_logic、prompt_mapping、golden_rule_tag_merging（複数タグを 1 フィルターに結合 vs 複数フィルターに分割）、forbidden_patterns、6 個の具体例、constraints。同じグルーピングルールが CRUD オペレーション間で適用される: `create_broadcast.filters`、`edit_broadcast_filters` など。複数フィルターペイロード構築前に必読。パラメータなし。

guide_filter_grouping