イベントツール - UTAGE API ドキュメント

概要

イベント系ツールでは、イベント（セミナー・説明会、個別相談・個別予約）と、その日程（セミナー・説明会）・日程設定（個別相談・個別予約）・申込フォームの申込者項目・申込者、イベントの分類であるイベントグループ、個別相談・個別予約を担当する担当者を管理できます。各ツールの project_id にはイベントIDを指定します（event_list で取得）。

イベント

イベント（セミナー・説明会、個別相談・個別予約）の一覧取得・作成・取得・更新・削除を行います。イベントIDは日程・日程設定・申込者項目・申込者の各ツールで project_id として指定します。

event_list

イベントの一覧を取得します（画面の「イベント一覧」の表示順）。既定ではアーカイブ済のイベントを除きます。register_url は申込者に案内する申込フォームのURLです。 パラメータ:

パラメータ	型	必須	説明
`type`	string	-	種類で絞り込み。`seminar`（セミナー・説明会）/ `calendar`（個別相談・個別予約）。省略時は両方
`event_group_id`	string	-	イベントグループ（画面の「グループ」）のIDで絞り込み（`event_group_list` で取得）
`is_archived`	boolean	-	`true` でアーカイブ済のイベントだけを返す（既定の `false` はアーカイブ済を除く）
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「イベント一覧を見せて」
「個別相談のイベントだけ一覧にして」

event_create

イベントを作成します。type は作成後に変更できません。seminar（セミナー・説明会）は日程を事前に作成して（event_schedule_create）申込者が日程を選ぶ形式、calendar（個別相談・個別予約）は日程設定（event_calendar_update）の開催する曜日・時間帯・特定日の開催設定から申込者が日時を選ぶ形式で、日程は申込の確定時に自動で作成されます。has_reminder=true のときはシステム標準のリマインダシナリオを連携配信アカウントにコピーして連携します。コピーは非同期のため、作成直後は reminder_scenario_copy_status が copying のことがあります。event_get で complete を確認してから申込フォームのURLを案内してください。システム標準のリマインダシナリオを解決できない場合はエラー internal_error になり、イベントは作成されません。API経由の作成件数の上限（月間・累計）の対象です。 パラメータ:

パラメータ	型	必須	説明
`type`	string	必須	種類。`seminar`（セミナー・説明会）/ `calendar`（個別相談・個別予約）。作成後は変更不可
`name`	string	必須	イベント名（最大255文字）
`system_name`	string	-	管理名称（最大255文字）
`event_group_id`	string	-	イベントグループ（画面の「グループ」）のID（`event_group_list` で取得）。省略・null で未分類
`fee_type`	string	-	参加費。`free`（無料）/ `paid`（有料）。既定は `free`
`fee`	integer	-	参加費の金額（円。1〜9999999）。`fee_type=paid` のときは必須
`payment_method`	string	-	決済種別。`stripe` / `univapay`（Univapay）/ `telecom`（テレコムクレジット）/ `firstpayment`（FirstPayment）/ `aquagates`（AQUAGATES。利用できる環境のみ）。`fee_type=paid` のときは必須。画面で設定できる `robotpayment`（RobotPayment）は指定不可
`payment_setting_id`	string	-	決済連携設定のID。省略時はデフォルトの決済連携設定（デフォルトが無い場合は未設定になるため、有料イベントでは指定を推奨）
`business_id`	string	-	領収書設定の「事業者」のID。省略・null でデフォルト
`use_limited_price`	boolean	-	期間限定価格を指定するか。既定は `false`
`limited_item`	string	-	期間限定価格の基準日時。`datetime`（指定日時）/ `reader_date`（アクセス元シナリオの配信基準日時）。既定は `datetime`
`limited_prices`	array	-	期間限定価格の配列（JSON文字列でも可）。`use_limited_price=true` のときは必須（1〜100件）。`datetime` のときは `{datetime_from: "YYYY-MM-DD HH:mm", datetime_to: "YYYY-MM-DD HH:mm", fee: 金額}`（期間の重複不可）、`reader_date` のときは `{day: 日数, hour: 時, min: 分, fee: 金額}`
`deadline_day`	integer	-	申し込み締切（開催の何日前か。-10〜10）。既定は 1
`deadline_hour`	integer	-	申し込み締切（何時か。0〜23）。既定は 14
`deadline_to_type`	string	-	申し込み可能な日程。`none`（締切前の全ての日程）/ `auto`（指定した日数分のみ）。既定は `none`
`deadline_to_day`	integer	-	申し込み可能な日程の日数（`deadline_to_type=auto` のとき。0〜32767）。既定は 0
`multiple_registration_type`	string	-	重複申込。`deny`（禁止する）/ `allow`（許可する）/ `allow_cancel`（許可する。連絡ありでキャンセル済の場合のみ）。既定は `deny`
`has_reminder`	boolean	-	リマインダ配信を使うか。既定は `false`。`use_line_event=true` のときは `true` が必須
`message_account_id`	string	-	連携配信アカウントのID。`has_reminder=true` のときは必須。`use_line_event=true` のときはLIFF連携済みのLINEの配信アカウント
`from_name`	string	-	リマインダ送信者名（最大255文字）。`has_reminder=true` かつ `use_line_event=false` のときは必須
`from_mail`	string	-	リマインダ送信者メールアドレス（メールアドレス形式。ドメインの DNS レコードも確認）。`has_reminder=true` かつ `use_line_event=false` のときは必須。フリーメール・携帯キャリアメールは不可
`use_line_event`	boolean	-	申込方式。`true` はLINEのみ、`false` は制限なし。既定は `false`。作成後は変更不可

指示例:

「“無料体験セミナー”というセミナー・説明会のイベントを作成して」
「個別相談のイベントを作って、リマインダ配信はこの配信アカウントで設定して」

event_get

イベントの詳細（画面の「イベント設定」の基本設定・リマインダ設定、期間限定価格、申込フォームのURL）を取得します。連携配信シナリオのコピーの進行状態（reminder_scenario_copy_status。null / copying / complete / error）もここで確認できます。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID

指示例:

「このイベントの設定を見せて」
「リマインダシナリオのコピーが終わったか確認して」

event_update

イベントの基本設定（画面の「イベント設定」）を更新します。指定した項目だけを更新し、未指定の項目は既存の値を維持します。type と use_line_event は作成後に変更できないため、このツールでは指定できません。limited_prices は指定時に全件置き換え、use_limited_price=false で期間限定価格を全削除します。has_reminder=false を指定すると reminder_scenario_id はクリアされます。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`name`	string	-	イベント名（最大255文字）
`system_name`	string	-	管理名称（最大255文字）。null でクリア
`event_group_id`	string	-	イベントグループ（画面の「グループ」）のID（`event_group_list` で取得）。null で未分類に変更
`fee_type`	string	-	参加費。`free`（無料）/ `paid`（有料）。古いイベントの `paid_limited` は現在の値と同じ場合だけ送り返せる
`fee`	integer	-	参加費の金額（円。1〜9999999）。有料のときは必須
`payment_method`	string	-	決済種別。`stripe` / `univapay` / `telecom` / `firstpayment` / `aquagates`（利用できる環境のみ）。有料のときは必須。画面で設定した `robotpayment`（RobotPayment）は現在の値と同じ場合だけ送り返せる（新たには指定不可）
`payment_setting_id`	string	-	決済連携設定のID。null でデフォルトの決済連携設定に差し替え
`business_id`	string	-	領収書設定の「事業者」のID。null でデフォルト
`use_limited_price`	boolean	-	期間限定価格を指定するか。`false` で期間限定価格を全削除
`limited_item`	string	-	期間限定価格の基準日時。`datetime`（指定日時）/ `reader_date`（アクセス元シナリオの配信基準日時）。変更するときは `limited_prices` を併せて指定
`limited_prices`	array	-	期間限定価格の配列（JSON文字列でも可）。指定時は全件置き換え。構造は `event_create` と同じ
`deadline_day`	integer	-	申し込み締切（開催の何日前か。-10〜10）
`deadline_hour`	integer	-	申し込み締切（何時か。0〜23）
`deadline_to_type`	string	-	申し込み可能な日程。`none`（締切前の全ての日程）/ `auto`（指定した日数分のみ）
`deadline_to_day`	integer	-	申し込み可能な日程の日数（`deadline_to_type=auto` のとき。0〜32767）
`multiple_registration_type`	string	-	重複申込。`deny`（禁止する）/ `allow`（許可する）/ `allow_cancel`（許可する。連絡ありでキャンセル済の場合のみ）
`has_reminder`	boolean	-	リマインダ配信を使うか。申込方式がLINEのみのイベントでは `false` にできない
`reminder_scenario_id`	string	-	連携配信シナリオのID。リマインダ配信を使う状態にするときは必須。他のイベントと連携済み・削除済みのシナリオは指定不可
`is_test_mode`	boolean	-	決済モード。`true` はテストモード、`false` は本番モード
`is_archived`	boolean	-	アーカイブ済にするか

指示例:

「このイベントの参加費を有料の5,000円にして」
「このイベントをアーカイブして」

event_delete

イベントを削除します。削除後はイベントと配下の日程・申込者を取得できなくなります。連携配信シナリオは残り、申込者へのリマインダ配信は停止されません。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID

指示例:

「このイベントを削除して」

日程

セミナー・説明会タイプのイベントの日程（画面の「日程」）を一覧取得・作成・取得・更新・削除します。個別相談・個別予約タイプのイベントでは日程は申込の確定時に自動で作成されるため、一覧・詳細の取得だけができます（作成・更新・削除はエラー invalid_event_type）。

event_schedule_list

イベントの日程の一覧を開始日時の昇順で取得します。個別相談・個別予約タイプでは申込の確定時に自動で作成された日程（担当者つき）が返ります。applicant_count はキャンセルを含む申込数で、有効な申込数は applicant_count - cancel_count です。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`date_from`	string	-	開始日時がこの日付以降の日程に絞り込み（YYYY-MM-DD）
`date_to`	string	-	開始日時がこの日付以前の日程に絞り込み（YYYY-MM-DD。当日を含む）
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「このイベントの日程一覧を見せて」
「来月の日程と申込数を一覧にして」

event_schedule_create

セミナー・説明会タイプのイベントに日程を作成します。開始日時と終了日時は同じ日で指定します。種別がオンラインのときは参加用URL、オフライン（会場での開催）のときは都道府県が必須です。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`start_datetime`	string	必須	開始日時（YYYY-MM-DD HH:mm）
`end_datetime`	string	必須	終了日時（YYYY-MM-DD HH:mm）。開始日時と同じ日で、開始日時より後
`capacity`	integer	-	定員（0〜99999999）。省略・null は定員なし
`is_online`	boolean	必須	種別。`true` はオンライン、`false` はオフライン（会場での開催）
`url`	string	-	参加用URL（最大2048文字）。`is_online=true` のときは必須
`password`	string	-	参加用パスワード（最大255文字）
`open_time`	integer	-	開場時刻（開始の何分前か。0〜120の5分刻み）。省略・null は 0（開始時刻と同時）
`venue_name`	string	-	会場名（最大255文字）
`location_area`	string	-	開催地（最大255文字）
`venue_url`	string	-	会場URL（最大2048文字）
`zip_code`	string	-	郵便番号
`prefecture`	string	-	会場住所の都道府県（「北海道」〜「沖縄県」の47都道府県名）。`is_online=false` のときは必須
`address`	string	-	会場住所（都道府県より後。最大512文字）
`is_hidden`	boolean	-	申し込みフォームへの表示。`true` は表示しない。既定は `false`

指示例:

「12月10日の14時から16時のオンライン日程を追加して。参加用URLは〜」
「来週土曜の東京会場の日程を定員20名で作って」

event_schedule_get

日程の詳細（会場情報・参加用URL・参加用パスワード・開場時刻・申込数・担当者）を取得します。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`schedule_id`	string	必須	日程ID

指示例:

「この日程の詳細を見せて」

event_schedule_update

セミナー・説明会タイプのイベントの日程を更新します。指定した項目だけを更新します。日時を変更するときは start_datetime と end_datetime の両方を指定します。開始日時を変更すると、その日程の申込者のリマインダ配信の予約が再計算されます（申込者が多い日程では応答に時間がかかることがあります）。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`schedule_id`	string	必須	日程ID
`start_datetime`	string	-	開始日時（YYYY-MM-DD HH:mm）。変更時は `end_datetime` も指定
`end_datetime`	string	-	終了日時（YYYY-MM-DD HH:mm）。開始日時と同じ日で、開始日時より後
`capacity`	integer	-	定員（0〜99999999）。null は定員なし
`is_online`	boolean	-	種別。`true` はオンライン、`false` はオフライン（会場での開催）
`url`	string	-	参加用URL（最大2048文字）。更新後がオンラインのときは必須
`password`	string	-	参加用パスワード（最大255文字）
`open_time`	integer	-	開場時刻（開始の何分前か。0〜120の5分刻み）。null は 0（開始時刻と同時）
`venue_name`	string	-	会場名（最大255文字）
`location_area`	string	-	開催地（最大255文字）
`venue_url`	string	-	会場URL（最大2048文字）
`zip_code`	string	-	郵便番号
`prefecture`	string	-	会場住所の都道府県（47都道府県名）。更新後がオフラインのときは必須
`address`	string	-	会場住所（都道府県より後。最大512文字）
`is_hidden`	boolean	-	申し込みフォームへの表示。`true` は表示しない

指示例:

「この日程の定員を30名に変更して」
「この日程を1時間後ろにずらして」

event_schedule_delete

セミナー・説明会タイプのイベントの日程を削除します。日程の申込者はそのまま残り、申込者の取得ツールで引き続き参照できます。申込者への配信停止やキャンセルの通知は行われません。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`schedule_id`	string	必須	日程ID

指示例:

「この日程を削除して」

日程設定

個別相談・個別予約タイプのイベントの日程設定（画面の「日程設定」。所要時間・開催する曜日・時間帯・特定日の開催設定・担当者・日程の表示期間など）を取得・更新します。セミナー・説明会タイプのイベントではエラー invalid_event_type になります。

event_calendar_get

日程設定を取得します。基本設定（所要時間・開催前後の確保時間・予約枠の間隔・定員）、担当者設定（参加方式・担当者・自動割り当て・割り当て順・優先順位・申込時のプロフィール表示）、Zoom連携 / Google Meet連携、開催する曜日・時間帯、特定日の開催設定（本日以降のみ）、祝日の開催、日程の表示期間、予約締切を返します。member_join_type / calendar_display_type / use_zoom / use_holiday が未設定のときは null で返るので、必要なら event_calendar_update で値を設定してください。担当者固有の日程設定（event_member_get）は含まれません。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID

指示例:

「このイベントの日程設定を見せて」
「開催する曜日・時間帯と担当者の設定を確認して」

event_calendar_update

日程設定を更新します。指定した項目だけを更新します。members / day_of_week_schedules / member_priorities は指定時に全件置き換え（空配列は全削除）、specified_date_schedules は本日以降の設定だけを置き換えます。時間は「HH:mm」で 00:00〜24:00 の15分刻みです。取得結果が null の項目は null のまま送り返せますが、値が設定されている項目を null にはできません（期間の開始日・終了日を除く）。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`duration`	integer	-	所要時間（分。1〜32767）
`duration_before`	integer	-	開催前の確保時間（分。0〜32767）
`duration_after`	integer	-	開催後の確保時間（分。0〜32767）
`reserve_quota_interval`	integer	-	予約枠の間隔（分）。0（自動。所要時間と同じ間隔）または 10〜1000
`capacity`	integer	-	定員（同じ時間帯に受け付ける申込数。1〜65535）
`member_join_type`	string	-	参加方式。`one`（担当者1名のみ参加）/ `one_of_them`（担当者を提示し1名が参加）
`members`	array	-	担当者の配列（JSON文字列でも可）。各要素は `{id: "担当者ID"}`（`event_member_list` で取得）。指定時は全件置き換え、空配列で紐付けを解除。`member_join_type=one` のときは1件以下
`member_auto_assignment`	boolean	-	自動割り当てを利用するか
`member_assignment_type`	string	-	割り当て順。`display_order`（担当者設定の表示順）/ `random`（ランダム）/ `priority`（優先順位を指定。`member_priorities` で順序を指定）
`member_priorities`	array	-	優先順位の配列（JSON文字列でも可）。配列の順が優先度。各要素は `{assignment_type: "display_order"（上から順）または "random"（ランダム）, members: [{id: "担当者ID"}, …]}`。更新後が `member_join_type=one_of_them` かつ `member_assignment_type=priority` のときだけ保存され、それ以外への更新では全削除。担当者は `members` に含まれていること（全グループを通して重複不可。`members` にいてここに無い担当者は最後のグループの末尾に自動で加わる）。グループ・各グループの担当者は100件以下。省略時は既存の優先順位を保持
`use_member_profile`	boolean	-	申込時に担当者のプロフィールを表示するか
`use_zoom`	boolean	-	Zoom連携 / Google Meet連携を利用するか（会議URLを自動で発行）
`use_holiday`	boolean	-	祝日の開催。`true` は開催する
`calendar_display_type`	string	-	日程の表示期間。`auto`（自動で調整）/ `period`（期間を指定）
`calendar_auto_from`	integer	-	「自動で調整」のいつから（何時間後から表示するか。1〜32767）
`calendar_auto_days`	integer	-	「自動で調整」の何日分を表示するか（1〜90）
`calendar_period_date_from`	string	-	「期間を指定」の開始日（YYYY-MM-DD）
`calendar_period_date_to`	string	-	「期間を指定」の終了日（YYYY-MM-DD）
`calendar_period_deadline`	integer	-	予約締切（何時間前まで。1〜32767）
`day_of_week_schedules`	array	-	開催する曜日・時間帯の配列（JSON文字列でも可）。各要素は `{day_of_week: 0〜6（0 が日曜日）, time_from: "HH:mm", time_to: "HH:mm"}`。同じ曜日を複数指定して複数の時間帯を設定可。指定時は全件置き換え、空配列で全削除
`use_specified_date_schedule`	boolean	-	特定日の開催設定を使うか
`specified_date_schedules`	array	-	特定日の開催設定の配列（JSON文字列でも可）。各要素は `{specified_date: "YYYY-MM-DD"（本日以降）, time_from: "HH:mm", time_to: "HH:mm", is_opened: 開催するか}`（`time_from` / `time_to` は `is_opened=false` でも必須）。指定時は本日以降の設定だけを置き換え、空配列で本日以降を全削除

指示例:

「この個別相談の開催する曜日・時間帯を平日10時から17時にして」
「このイベントの担当者を〜さんと〜さんにして、ランダムに割り当てて」
「来月の祝日は開催しない設定にして」

申込フォーム・申込者項目

イベントの申込フォームの項目定義（画面の「申込フォーム・申込者項目」）を取得・更新します。基本項目（お名前・フリガナ・メールアドレス・携帯番号）の利用設定と、申込者項目（event_item01〜event_item20）の名称・入力形式・必須・初期値・選択肢・プレースホルダー・表示順を扱います。申込者の申込者項目の値は申込者の取得・更新ツールで扱います。

event_form_item_get

申込フォームの項目定義を取得します。basic は基本項目の利用設定とお名前の入力形式（name_input_type。separate＝姓名別枠 / single＝姓名同枠。フリガナも同じ形式）、items はフォームで使用中の申込者項目を表示順に返します。radio / select / checkbox の default_value は改行区切りの選択肢です。申込者の申込者項目を更新する前の項目確認や、event_form_item_update で既存の項目を維持して更新するときの現状の取得に使います。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID

指示例:

「このイベントの申込フォームの項目を見せて」
「申込者項目の入力形式を確認して」

event_form_item_update

申込フォームの項目定義を更新します。basic は指定した項目だけを更新します。items はフォームで使用する申込者項目の完全なリストとして扱い、含めた項目は使用中になって並び順もリストの順になり、含めなかった項目は未使用になります（設定値は保持）。既存の項目を維持したまま追加・変更するときは event_form_item_get の結果を元に送ります。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`basic`	object	-	基本項目の設定（JSON文字列でも可。指定した項目だけを更新）。`{name_use: お名前の利用, kana_use: フリガナの利用, email_use: メールアドレスの利用, phone_use: 携帯番号の利用, name_input_type: "separate"（姓名別枠）または "single"（姓名同枠）}`。`name_use` / `email_use` は申込方式がLINEのみのイベントでだけ変更可（それ以外で変更するとエラー `validation_error`）
`items`	array	-	フォームで使用する申込者項目の完全なリスト（JSON文字列でも可。最大20件）。各要素は `{key: "event_item01"〜"event_item20"（重複不可）, name: 名称, input_type: 入力形式, required: 必須か, default_value: 初期値・選択肢（radio / select / checkbox では改行区切りで選択肢）, placeholder: プレースホルダー}`。`input_type` は `text`（テキスト）/ `textarea`（複数行テキスト）/ `number`（数値）/ `hidden`（非表示項目）/ `radio`（ラジオ）/ `select`（プルダウン）/ `checkbox`（チェックボックス）/ `date`（日付）/ `datetime`（日付時刻）。指定時は全件置き換え

指示例:

「申込フォームに”会社名”のテキスト項目を必須で追加して」
「“参加動機”の項目をプルダウンにして、選択肢は〜にして」
「申込フォームでフリガナを使わないようにして」

申込者

イベントに申し込んだ申込者（管理画面の「申込者」）の一覧取得・詳細取得・更新を行います。参加状況・成約状況の値は event_applicant_list の説明を参照してください。

event_applicant_list

イベントの申込者一覧を、イベント配下の全日程を横断して取得します。日程・参加状況・成約状況・メールアドレス・お名前・日程の開始日で絞り込めます。一覧にはお名前・メールアドレス・電話番号・LINE友だちと状況だけが含まれ、申込者項目・住所・入金情報は event_applicant_get で取得します。申込方式が「LINEのみ」のイベントでは mail が null の場合があります。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`schedule_id`	string	-	日程IDで絞り込み
`status_participation`	string	-	参加状況で絞り込み（`reserved`=参加予定、`attended`=参加済、`delay`=遅刻、`cancel_contact`=キャンセル(連絡あり)、`cancel_no_contact`=キャンセル(連絡なし)、`cancel_changed`=キャンセル(日程変更済)）
`status_contract`	string	-	成約状況で絞り込み（`unregistered`=未登録、`paid`=決済済、`scheduled`=決済予定、`consider`=検討中、`no_contract`=不成約）
`mail`	string	-	メールアドレスで部分一致検索
`name`	string	-	お名前またはフリガナで部分一致検索
`line_display_name`	string	-	LINE登録名（LINE友だちの表示名）で部分一致検索。申込方式が「LINEのみ」のイベントでだけ有効
`date_from`	string	-	日程の開始日時がこの日以降の申込者に絞り込み（`YYYY-MM-DD`）
`date_to`	string	-	日程の開始日時がこの日以前（当日を含む）の申込者に絞り込み（`YYYY-MM-DD`）
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「このイベントの申込者一覧を見せて」
「参加予定の申込者を日程ごとに確認して」

event_applicant_get

申込者の詳細を取得します。お名前・フリガナ・メールアドレス・電話番号・住所、申し込んだ日程と担当者、参加状況・成約状況、メモ・キャンセル理由、入金額・入金日時、申込者項目（custom_fields。イベントで使用中の項目だけ）を含みます。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`applicant_id`	string	必須	申込者ID

指示例:

「この申込者の詳細を見せて」
「申込者の申込者項目の入力内容を確認して」

event_applicant_update

申込者の参加状況・成約状況・メモ・入金額・キャンセル理由・申込者項目を更新します。送信したフィールドのみ更新され、お名前・メールアドレス・電話番号・住所は更新できません。参加状況・成約状況を変更すると、管理画面の「申込者」で変更したときと同じく、紐づく読者の配信状態を更新します（キャンセル系で配信停止、参加系で解除）。参加予定・参加済・遅刻からキャンセル系へ変更すると管理画面の「キャンセル処理」と同じ処理を行い、send_cancel_notification 等の指定に応じて申込者へのキャンセル通知の送信（イベント設定「キャンセル時の動作設定」の「メール自動返信」/「LINE自動返信」が「送信する」の場合だけ）と連携配信シナリオへの登録を行います（指定しなければいずれも行いません）。paid_amount はイベントの参加費が「有料」の場合だけ更新されます。使用中でない申込者項目を指定するとエラー（validation_error）です。 パラメータ:

パラメータ	型	必須	説明
`project_id`	string	必須	イベントID
`applicant_id`	string	必須	申込者ID
`status_participation`	string	-	参加状況（`reserved`=参加予定、`attended`=参加済、`delay`=遅刻、`cancel_contact`=キャンセル(連絡あり)、`cancel_no_contact`=キャンセル(連絡なし)、`cancel_changed`=キャンセル(日程変更済)）
`status_contract`	string	-	成約状況（`unregistered`=未登録、`paid`=決済済、`scheduled`=決済予定、`consider`=検討中、`no_contract`=不成約）
`memo`	string	-	メモ（null でクリア）
`paid_amount`	integer	-	入金額（0〜99999999。null でクリア）。参加費が「有料」のイベントだけ更新される
`cancel_reason`	string	-	キャンセル理由（null でクリア）
`custom_fields`	object	-	申込者項目。キーは `event_item01`〜`event_item20`（使用中の項目は `event_form_item_get` で確認）、値は文字列または null（null でクリア）。指定したキーのみ更新（JSON文字列でも可）
`send_cancel_notification`	boolean	-	キャンセル(連絡あり)へ変更するとき、申込者へキャンセルのメール（申込方式が「LINEのみ」のイベントではLINE）を送信するか（既定 false）。イベント設定「キャンセル時の動作設定」の「メール自動返信」（「LINEのみ」のイベントでは「LINE自動返信」）が「送信する」の場合だけ送信される。画面の「キャンセル処理」の「申込者へのメール送信」（「申込者へのLINE送信」）に相当
`has_step_immediately`	boolean	-	イベント設定の「シナリオ連携」が「する」の場合、連携配信シナリオで「登録直後のステップ配信の対象にする」か（既定 false）
`has_step_scheduled`	boolean	-	同じく「登録以降のステップ配信の対象にする」か（既定 false）
`has_reminder`	boolean	-	同じく「リマインダ配信の対象にする」か（既定 false）

指示例:

「この申込者の参加状況を参加済にして」
「この申込者をキャンセル(連絡あり)にして、キャンセルのメールも送って」
「この申込者の成約状況を決済済にして入金額を記録して」

イベントグループ

イベントグループ（イベント一覧の「グループ管理」で作るイベントの分類）の一覧取得・作成・取得・更新・削除を行います。イベントの所属は event_create / event_update の event_group_id で指定します。

event_group_list

イベントグループの一覧を表示順で全件取得します。event_create / event_update の event_group_id と、event_list の絞り込みに使うIDの取得元です。 パラメータ: なし 指示例:

「イベントグループの一覧を見せて」

event_group_create

イベントグループを作成します。表示順は一覧の末尾になります。 パラメータ:

パラメータ	型	必須	説明
`name`	string	必須	グループ名（最大255文字）

指示例:

「“2026年春セミナー”というイベントグループを作って」

event_group_get

イベントグループの詳細を取得します。 パラメータ:

パラメータ	型	必須	説明
`event_group_id`	string	必須	イベントグループID

指示例:

「このイベントグループの詳細を見せて」

event_group_update

イベントグループのグループ名を更新します。送信したフィールドのみ更新されます。 パラメータ:

パラメータ	型	必須	説明
`event_group_id`	string	必須	イベントグループID
`name`	string	-	グループ名（最大255文字）

指示例:

「このイベントグループの名前を”説明会”に変えて」

event_group_delete

イベントグループを削除します。イベント（アーカイブ済みを含む）が1件でも所属しているグループは削除できません（エラー conflict）。先に event_update の event_group_id で所属イベントを未分類または他のグループへ移してください。 パラメータ:

パラメータ	型	必須	説明
`event_group_id`	string	必須	イベントグループID

指示例:

「使っていないイベントグループを削除して」

担当者

担当者（個別相談・個別予約の「担当者設定」で日程に紐付ける担当者）の一覧取得・作成・取得・更新・削除と、連携用リンクの発行・削除を行います。担当者はイベント横断で共有され、イベントへの紐付けは event_calendar_update で行います。

event_member_list

担当者の一覧を表示順で取得します。event_calendar_update で担当者を紐付けるときのID取得に使います。一覧には担当者名・管理名称・オンライン会議サービスと各連携（Google カレンダー / Zoom / Google Meet）の有無だけが含まれ、通知設定・担当者固有の日程設定・連携用リンクの状態は event_member_get で取得します。 パラメータ:

パラメータ	型	必須	説明
`page`	integer	-	ページ番号
`per_page`	integer	-	1ページあたりの件数

指示例:

「担当者の一覧を見せて」
「Zoom連携が済んでいない担当者を教えて」

event_member_create

担当者を作成します。表示順は一覧の末尾になります。イベントへの紐付けは event_calendar_update で行います。Zoom / Google カレンダー / Google Meet の連携はこのツールでは設定できず、event_member_connect_link_create で発行した連携用リンクから担当者本人が行います。省略した項目は既定値（通知はデフォルト文面、オンライン会議サービスは Zoom、担当者固有の日程設定は「設定しない」）になります。 パラメータ:

パラメータ	型	必須	説明
`name`	string	必須	担当者名（最大255文字）。申込フォームで申込者に表示される
`system_name`	string	-	管理名称（最大255文字。null でクリア）
`profile_url`	string	-	プロフィール画像のURL（最大255文字、URL形式。null でクリア）。イベントの日程設定「申込時のプロフィール表示」が「表示する」の場合に申込フォームで表示される
`profile_body`	string	-	プロフィール説明（HTML。null でクリア）。使用できるのは段落・改行・太字・文字サイズ・文字色に相当する `p` / `br` / `strong` / `span`（`style` は `font-size`（0.3em〜3.0emの0.1刻み）と `color` のみ）だけ。それ以外はエラー（`validation_error`）
`notify_mail`	string	-	通知先メールアドレス（最大2048文字。カンマ区切りで複数指定可。null でクリア）。申込・キャンセル発生時の通知先
`is_custom_notify`	boolean	-	申し込み時のメール通知をカスタムにするか（false=デフォルト文面）
`notify_subject`	string	-	申し込み時の通知メールの件名（最大1024文字。カスタムの場合に使用。null でクリア）
`notify_body`	string	-	申し込み時の通知メールの本文（カスタムの場合に使用。null でクリア）
`is_custom_notify_cancel`	boolean	-	キャンセル時のメール通知をカスタムにするか（false=デフォルト文面）
`notify_subject_cancel`	string	-	キャンセル時の通知メールの件名（最大255文字。カスタムの場合に使用。null でクリア）
`notify_body_cancel`	string	-	キャンセル時の通知メールの本文（カスタムの場合に使用。null でクリア）
`chat_notify_type`	string	-	チャット通知の通知先（`none`=通知しない、`chatwork`=Chatwork、`slack`=Slack、`discord`=Discord。null でクリア）
`chat_notify_token`	string	-	ChatworkのAPIトークン、またはSlackのBot User OAuth Token（最大255文字。null でクリア）。設定専用で取得はできない
`chat_notify_webhook_url`	string	-	DiscordのウェブフックURL（最大255文字、URL形式。null でクリア）。設定専用で取得はできない
`chat_notify_to`	string	-	Chatworkの通知先ルームID、またはSlackの通知先チャンネル（最大255文字。null でクリア）
`is_chat_custom_notify`	boolean	-	申し込み時のチャット通知をカスタムにするか（false=デフォルト文面）
`chat_notify_text`	string	-	申し込み時のチャット通知の内容（カスタムの場合に使用。null でクリア）
`is_chat_custom_notify_cancel`	boolean	-	キャンセル時のチャット通知をカスタムにするか（false=デフォルト文面）
`chat_notify_text_cancel`	string	-	キャンセル時のチャット通知の内容（カスタムの場合に使用。null でクリア）
`meeting_provider_type`	string	-	オンライン会議サービス（`zoom`=Zoom、`googlemeet`=Google Meet。既定 `zoom`）
`use_day_of_week_schedule`	boolean	-	担当者固有の「予約を受け付ける曜日・時間帯」を使用するか（false=担当者固有の設定をせず、イベントの日程設定のとおり受け付ける）
`day_of_week_schedules`	array	-	担当者固有の予約を受け付ける曜日・時間帯。各要素は `{day_of_week: 0〜6（0=日曜）, time_from: "HH:mm", time_to: "HH:mm"}`（00:00〜24:00の15分刻み。同じ曜日の複数行で複数の時間帯）。JSON文字列でも可
`use_specified_date_schedule`	boolean	-	担当者固有の「特定日の予約設定」を使用するか（false=担当者固有の設定をせず、イベントの日程設定のとおり受け付ける）
`specified_date_schedules`	array	-	担当者固有の特定日の予約設定。各要素は `{specified_date: "YYYY-MM-DD"（本日以降）, time_from: "HH:mm", time_to: "HH:mm", is_opened: 予約を受け付けるか}`（`time_from` / `time_to` は `is_opened` が false でも必須。同じ特定日の行は `is_opened` を揃える）。JSON文字列でも可

指示例:

「“山田太郎”という担当者を作って、通知先メールアドレスも設定して」
「担当者を作って、火曜と木曜の10:00〜17:00だけ予約を受け付けるようにして」

event_member_get

担当者の詳細を取得します。メール通知設定・チャット通知設定・オンライン会議サービス・各連携の状態と連携アカウント・連携用リンクの状態（connect_link: status が none / active / expired。active のとき connect_url と expires_at）・担当者固有の日程設定（予約を受け付ける曜日・時間帯、特定日の予約設定は本日以降の分だけ）を含みます。チャット通知のAPIトークン・ウェブフックURLは設定専用のため含まれません。 パラメータ:

パラメータ	型	必須	説明
`member_id`	string	必須	担当者ID（`event_member_list` で取得）

指示例:

「この担当者の詳細を見せて」
「この担当者の連携用リンクが有効か確認して」

event_member_update

担当者を更新します。送信したフィールドのみ更新され、null を指定できる項目は null でクリアします。day_of_week_schedules は指定時に全件置き換え（空配列で全削除）、specified_date_schedules は本日以降の設定だけを置き換え（空配列で本日以降を全削除。過去分は保持）。profile_body は値が変わる場合だけ使用できる HTML の検証を行います（取得した現在の値をそのまま送り返す場合は検証しません）。 パラメータ:

パラメータ	型	必須	説明
`member_id`	string	必須	担当者ID（`event_member_list` で取得）
`name`	string	-	担当者名（最大255文字）。申込フォームで申込者に表示される
`system_name`	string	-	管理名称（最大255文字。null でクリア）
`profile_url`	string	-	プロフィール画像のURL（最大255文字、URL形式。null でクリア）
`profile_body`	string	-	プロフィール説明（HTML。null でクリア）。使用できる書式は `event_member_create` と同じ
`notify_mail`	string	-	通知先メールアドレス（最大2048文字。カンマ区切りで複数指定可。null でクリア）
`is_custom_notify`	boolean	-	申し込み時のメール通知をカスタムにするか（false=デフォルト文面）
`notify_subject`	string	-	申し込み時の通知メールの件名（最大1024文字。null でクリア）
`notify_body`	string	-	申し込み時の通知メールの本文（null でクリア）
`is_custom_notify_cancel`	boolean	-	キャンセル時のメール通知をカスタムにするか（false=デフォルト文面）
`notify_subject_cancel`	string	-	キャンセル時の通知メールの件名（最大255文字。null でクリア）
`notify_body_cancel`	string	-	キャンセル時の通知メールの本文（null でクリア）
`chat_notify_type`	string	-	チャット通知の通知先（`none`=通知しない、`chatwork`=Chatwork、`slack`=Slack、`discord`=Discord。null でクリア）
`chat_notify_token`	string	-	ChatworkのAPIトークン、またはSlackのBot User OAuth Token（最大255文字。null でクリア）。設定専用で取得はできない
`chat_notify_webhook_url`	string	-	DiscordのウェブフックURL（最大255文字、URL形式。null でクリア）。設定専用で取得はできない
`chat_notify_to`	string	-	Chatworkの通知先ルームID、またはSlackの通知先チャンネル（最大255文字。null でクリア）
`is_chat_custom_notify`	boolean	-	申し込み時のチャット通知をカスタムにするか（false=デフォルト文面）
`chat_notify_text`	string	-	申し込み時のチャット通知の内容（null でクリア）
`is_chat_custom_notify_cancel`	boolean	-	キャンセル時のチャット通知をカスタムにするか（false=デフォルト文面）
`chat_notify_text_cancel`	string	-	キャンセル時のチャット通知の内容（null でクリア）
`meeting_provider_type`	string	-	オンライン会議サービス（`zoom`=Zoom、`googlemeet`=Google Meet）
`use_day_of_week_schedule`	boolean	-	担当者固有の「予約を受け付ける曜日・時間帯」を使用するか
`day_of_week_schedules`	array	-	担当者固有の予約を受け付ける曜日・時間帯（形式は `event_member_create` と同じ）。指定時は全件置き換え、空配列で全削除。JSON文字列でも可
`use_specified_date_schedule`	boolean	-	担当者固有の「特定日の予約設定」を使用するか
`specified_date_schedules`	array	-	担当者固有の特定日の予約設定（形式は `event_member_create` と同じ）。指定時は本日以降の設定だけを置き換え、空配列で本日以降を全削除。JSON文字列でも可

指示例:

「この担当者のオンライン会議サービスをGoogle Meetに変えて」
「この担当者の12月29日から1月3日を予約不可にして」

event_member_delete

担当者を削除します。削除後は一覧・詳細から取得できなくなり、発行済みの連携用リンクも使えなくなります。イベントの日程設定への紐付けは自動では解除されません（管理画面の「担当者設定」での削除と同じ）。 パラメータ:

パラメータ	型	必須	説明
`member_id`	string	必須	担当者ID（`event_member_list` で取得）

指示例:

「退職した担当者を削除して」

event_member_connect_link_create

担当者の連携用リンク（管理画面の「担当者設定」の「連携用リンク発行」）を発行します。担当者本人が管理画面にログインせずに自分の Zoom / Google カレンダー / Google Meet のアカウントを連携するための公開URLを返します（有効期限は発行から7日間。期限内は再連携にも使えます）。再実行すると新しいリンクを発行し、以前のリンクはすぐに使えなくなります。連携の状態は event_member_list / event_member_get で確認できます。 パラメータ:

パラメータ	型	必須	説明
`member_id`	string	必須	担当者ID（`event_member_list` で取得）

指示例:

「この担当者の連携用リンクを発行して」
「担当者にZoomを連携してもらうためのリンクを作って」

event_member_connect_link_delete

担当者の連携用リンクを削除します。現在のリンクはすぐに使えなくなり、未発行の状態に戻ります（誤って発行した場合の取り消し・配布の中止用）。連携済みのアカウントには影響しません。未発行の担当者に対しても成功します。 パラメータ:

パラメータ	型	必須	説明
`member_id`	string	必須	担当者ID（`event_member_list` で取得）

指示例:

「この担当者の連携用リンクを無効にして」