# Beds24 で「最低泊数のせいで売れない1泊の空き」を隣接ゲストへの延長案内で埋める（オートアクション自動化） 対象: Beds24 で民泊・小規模宿を運営していて、最低泊数（例: 2泊）のせいで予約と予約の間に1泊だけ空いた夜（飛び地）が売れ残る人。 最低泊数を下げられない（法令・方針）前提で、隣のゲストに「1泊延長」を案内して埋める。 ## 1. 先に知っておくこと - Beds24 にも主要 OTA にも「1泊の隙間を残す予約を拒否する」設定は見当たらない（公式 wiki・API の部屋設定で確認）。防ぐのでなく、できた隙間を案内で埋める。 - 逆方向の Gap Fill（隙間だけ最低泊数未満で売る）は Fixed Price の Restriction Strategy をオプトインで切り替える機能。最低泊数を下げられないなら使わない。 - **案内は延長側（前泊）だけに送る。** 前泊と後泊の両方に送ると、同じ夜を2人が受けて部屋移動と清掃が余分に発生する（実例あり）。 ## 2. オートアクションの条件 管理画面 設定 → ゲスト管理 → オートアクション。 | 項目 | 値 | 理由 | |---|---|---| | トリガー | チェックアウト基準、-30日、ウィンドウ30日 | ウィンドウ上限が30日。チェックアウト30日前〜当日まで判定し続けるので、後から隙間ができても拾える | | 施設・部屋 | 対象施設。セット販売の仮想部屋は除外 | 仮想部屋の予約に送らない | | ステータス | キャンセルでないすべて | | | テンプレート変数条件 | `[TURNOVERDAYSB]` 等しい `1` | 次の到着までの日数（ブラックアウトを考慮する版）。B なし版はブラックアウト日も空きとして数える | | 送信先 | OTAのAPI／Eメール（スマート） | OTA ゲストはマスクアドレスなので、チャネルのメッセージ API 経由で届く | | チェックイン日の下限 | 手動で案内済みの予約より後の日付 | 既に案内したゲストに重ねて送らない | 本文の変数: `[GUESTFIRSTNAME]`、`[LEAVINGDAY]`（チェックアウト日。言語ごとに日付書式が変わる）。 **金額を差し込む変数は無い**ので、本文は「延長特別価格（通常料金の○% OFF）、正確な料金は返信でお知らせ」にし、返信が来たら計算して返す。 英語版と日本語版の件名・本文を両方入れると、ゲストの言語で出し分けられる。 ## 3. 管理画面をブラウザ自動化（Playwright・CDP）で設定するときの罠 - 編集画面は `popupsetting(ID,'autoemailedit')` が開く iframe（`control2.php?ajax=autoemailedit&id=ID`）。**ID 0 で開くと「An error has occured」**。 - 新規は一覧の「新規アクション作成」→ 確認ダイアログの「Create」で空のアクションができる。作成直後は「無効」「送信先なし」なので誤送信しない。その ID を編集する。 - 施設（propid）と送信基準（sendrule）の選択でフォームが作り直されることがある。先に選んでから他を入れ、iframe は毎回取り直す。 - 件名・本文・送信先は「メッセージ」「英語／日本語」タブの中で非表示。fill は「not visible」で止まるので、`value` を代入して `input`／`change` イベントを発火させる。 - 保存ボタンは iframe 内の「セーブ」。 - **いきなり「オート」で保存しない。** 先に「マニュアル」で保存 → 開き直して全項目を読み戻す → 発火対象を予約データから計算して確かめる → 「オート」に切り替える。 - 有効化すると、条件に合う既存予約へ数分以内に一斉送信される。送信の確認は API `GET /bookings/messages?bookingId=` で host メッセージの増加と本文を読む。 ## 4. 発火対象の事前計算（API） 部屋ごとに `/bookings?roomId=…&arrivalFrom=…` を `nextPageExists` が false になるまで取り、キャンセルを除いて、 「チェックアウト日の翌日に同じ部屋の次の到着がある（差が1日）」予約を列挙する。これがオートアクションの送信先と一致するかを見る。 `/bookings` は100件ページングで黙って欠けるので、部屋で絞るかページを回す。 ## 期待効果 ゼロから調べると、管理画面の構造調査と罠の踏み抜きで半日〜1日。この手順書を読めば1時間程度で、誤送信なしに設定と送信確認まで終わる。 ---