# VibeBooking ドキュメント

VibeBooking のコンソールで、施設の情報を AI が読める形にして公開します。初めての方は [はじめに](https://docs.vibebooking.ai/getting-started) から読んでください。

## AI から読む

どのページも、URL の末尾に `.md` を付けると Markdown で返ります。`Accept: text/markdown` を付けて同じ URL を開いても同じです。

```sh
curl https://docs.vibebooking.ai/getting-started.md
```

| URL | 中身 |
| --- | --- |
| [/llms.txt](https://docs.vibebooking.ai/llms.txt) | 全ページの一覧（日本語と英語） |
| [/llms-full.txt](https://docs.vibebooking.ai/llms-full.txt) | 全ページの本文（日本語と英語） |
| [/llms-full.ja.txt](https://docs.vibebooking.ai/llms-full.ja.txt) | 日本語のページの本文 |
| [/llms-full.en.txt](https://docs.vibebooking.ai/llms-full.en.txt) | 英語のページの本文 |

AI に任せられることと、ご自身で行うことは [AI アシスタントにできること](https://docs.vibebooking.ai/ai-assistants) にあります。

# はじめに

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

## コンソールでできること

コンソールは、施設の情報を AI に向けて公開する管理画面です。ここで次のことを行います。

- 施設のウェブサイトを登録する（「施設を追加」）
- 予約システムと連携し、料金と空室を読み取れるようにする（「予約システムと連携する」。[Beds24](https://docs.vibebooking.ai/connect-beds24)、[Channex](https://docs.vibebooking.ai/connect-channex)）
- 掲載する内容を「情報」と「プレビュー」で確かめ、「公開する」を押す（[公開する](https://docs.vibebooking.ai/go-live#go-live)）
- 公開後、AI に読まれた回数を「ホーム」で確かめる（[レポートを見る](https://docs.vibebooking.ai/report)）

## ログインする

![コンソールのログイン画面。LINEまたはGoogleで続けるボタンが並ぶ。](https://docs.vibebooking.ai/screenshots/ja/sign-in-desktop.webp)
*ログイン画面。招待されたアカウントでのみログインできます。*

1. **コンソールを開く**

   [console.vibebooking.ai](https://console.vibebooking.ai) を開くと、「ログイン」の画面が出ます。パスワードは要りません。

2. **アカウントを選ぶ**

   「LINEで続ける」か「Googleで続ける」を押し、ふだんお使いのアカウントでログインします。

3. **アカウントができる**

   初めてのログインでアカウントが自動でできて、「ホーム」が開きます。ログインした方が、そのアカウントの「オーナー」です。招待メールのリンクから来た方には、「VibeBookingへの招待」の画面が出ます（[招待を受けた方](https://docs.vibebooking.ai/getting-started#accept)）。

## メンバーを招待する

一緒に使う人を、メールで招待します。招待できるのは「オーナー」だけです。ほかの役割の方が「メンバー」を開くと、「メンバーの管理はオーナーが行います。」と表示されます。

1. **「メンバー」を開く**

   メニューの「メンバー」を押します。

2. **メールアドレスと役割を入力する**

   「メンバーを招待する」の欄に、相手の「メールアドレス」を入力し、「役割」を選びます。

3. **招待メールを送る**

   「招待メールを送る」を押すと、相手に「VibeBookingへの招待」という件名のメールが届きます。招待の有効期限は 7 日です。送った直後の画面の「取り消す」で、招待を取り消せます。

![メンバーを招待するフォーム。メールアドレスと役割を入力する欄がある。](https://docs.vibebooking.ai/screenshots/ja/people-invite-desktop.webp)
*メンバーを招待するフォーム。*

役割ごとにできることは次のとおりです。招待で選べるのは「管理者」と「閲覧者」です。

| 役割 | できること |
| --- | --- |
| 「オーナー」 | すべての操作。支払い、メンバー、アカウントの削除を含みます。 |
| 「管理者」 | 連携、公開、施設情報の編集。メンバーの管理とアカウントの削除はできません。 |
| 「閲覧者」 | すべて見られますが、変更はできません。 |

### 招待を受けた方

1. **招待メールのリンクを開く**

   ログインすると、「VibeBookingへの招待」の画面が開きます。招待されたアカウントと役割が表示されます。

2. **「参加する」を押す**

   アカウントに参加します。参加しないときは「辞退する」を押します。

![招待メールのリンクから開く画面。役割の説明と、参加するボタン、辞退するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/invitation-accept-desktop.webp)
*招待メールのリンクから開く画面。*

リンクは 7 日を過ぎると使えません。招待した方に、新しい招待を送ってもらってください。

# AI アシスタントにできること

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

## いまできること

ChatGPT や Claude に VibeBooking を接続すると、アシスタントが次のことを手伝います。接続の手順は [AI アシスタントとつなぐ](https://docs.vibebooking.ai/connect-assistant) にあります。

- 施設のサイトを確かめ、AI から読めない情報を調べる
- 施設のウェブサイトを追加し、連携済みの予約システムにつなぐ
- サイトや予約システム、貼り付けた文章をもとに施設の情報の下書きを作り、確認を頼む
- すべての施設に共通する情報の下書きを作る
- 客室タイプを手で追加し、予約システムの客室タイプと対応づける
- 独自ドメインを、レコードが反映されるところまで設定する。配信する施設はご自身で選びます
- レポートや予約システムとの連携の状態、次にすることの提案を読む
- このドキュメントを読み、手順を案内する

どのページも、URL の末尾に `.md` を付けると Markdown で読めます。ページの一覧は [/llms.txt](https://docs.vibebooking.ai/llms.txt) にあります。

```sh
curl https://docs.vibebooking.ai/connect-beds24.md
```

### AI が作るのは下書きまで

アシスタントが書いた施設の情報は、下書きとして保存されます。いま掲載している内容はそのまま残り、下書きはその隣に並びます。掲載するかどうかは、ご自身が決めます。

AI が公開や承認をすることはありません。どの権限を渡しても同じです。

### ご自身で行う 3 つの操作

次の 3 つは、AI に任せずご自身で行います。

1. アカウントを作り、アシスタントの接続を許可する
2. 予約システムと連携する（[Beds24](https://docs.vibebooking.ai/connect-beds24)、[Channex](https://docs.vibebooking.ai/connect-channex)）
3. AI が作った下書きを確かめて、公開する

### 下書きを確かめる

アシスタントが確認を頼むと、受信箱に知らせが届き、メールでもお知らせします。続けて頼まれても、知らせは 1 時間に 1 回までです。

1. **「提案を確認する」を押す**

   「公開前の確認」が開き、下書きが 1 件ずつ、いま掲載している内容と並んで表示されます。

2. **公開する下書きを選ぶ**

   正しい下書きの「公開する」にチェックを入れます。直したいものは「修正する」、使わないものは「却下する」を押します。

3. **公開のボタンを押す**

   ボタンには「2件を承認して公開する」のように、公開する件数が出ます。件数を確かめて押します。

![公開前の確認の画面。AIアシスタントの提案が、いまの内容と並んで表示される。](https://docs.vibebooking.ai/screenshots/ja/review-drafts-desktop.webp)
*公開前の確認。いまの内容とAIの提案が、項目ごとに並ぶ。*

承認した内容は、ご自身が入力した内容として扱われます。

## AI が推測で答えないこと

料金、キャンセル規定、定員、チェックインの時刻として正しいのは、ご自身が入力した内容と、予約システムの情報だけです。このドキュメントに書かれていないことは推測で答えないよう、AI に伝えています。

AI の答えがおかしいと思ったら、コンソールの画面で確かめてください。

# AI アシスタントとつなぐ

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

ChatGPT や Claude に VibeBooking のアドレスを追加すると、アシスタントがサイトの確認や施設の情報の下書きを手伝います。下書きを確かめて公開するのは、ご自身です。

## 始める前に

- アカウントは先に作らなくても構いません。アシスタントにログインを求められたら、Google でログインします。その場でアカウントができてご自身が「オーナー」になり、そのまま接続の許可に進みます。ただし招待制のあいだは、当社からご案内したメールアドレスでしかログインできません（[ログインする](https://docs.vibebooking.ai/getting-started#sign-in)）。
- すでにアカウントがあるときは、役割が「オーナー」か「管理者」であること。「閲覧者」はアシスタントを接続できません。

## アドレスを確かめる

メニューの「設定」を開き、「接続中のAIアシスタント」を押します。「AIアシスタントで設定する」に、追加するアドレスが出ます。「アドレスをコピー」でコピーできます。

```text
https://mcp.vibebooking.ai/mcp
```

![接続中のAIアシスタントのタブ。AIアシスタントに追加するアドレスと、アドレスをコピーするボタンがある。](https://docs.vibebooking.ai/screenshots/ja/assistant-address-desktop.webp)
*接続中のAIアシスタントのタブ。*

## Claude に追加する

Free、Pro、Max のどのプランでも追加できます。Free で追加できるのは 1 つまでです。

1. **コネクタの設定を開く**

   Claude で Settings を開き、Connectors を選びます。Add を押し、Add custom connector を選びます。

2. **アドレスを入れる**

   名前（例：VibeBooking）とアドレスを入れて、Continue を押します。サインインについての項目が 2 つ出ますが、どちらも変えずに Add を押します。

3. **接続する**

   Connect を押すと、コンソールの確認画面が開きます。内容を確かめて「許可」を押します（[確認画面で見ること](https://docs.vibebooking.ai/connect-assistant#consent)）。

## Claude Code に追加する

ターミナルから追加します。キーはいりません。

1. **コマンドで追加する**

   次のコマンドを実行します。追加先は、いま開いているプロジェクトです。すべてのプロジェクトで使うときは `--scope user` をつけます。

   ```sh
   claude mcp add --transport http vibebooking \
     https://mcp.vibebooking.ai/mcp
   ```

2. **ログインする**

   Claude Code で `/mcp` と入力し、vibebooking を選んで Authenticate を押します。ブラウザでコンソールの確認画面が開きます。内容を確かめて「許可」を押します（[確認画面で見ること](https://docs.vibebooking.ai/connect-assistant#consent)）。

## ChatGPT に追加する

Plus、Pro、Business、Enterprise、Edu のプランで、ウェブ版から追加します。ChatGPT では、この機能を開発者モードと呼びます。

1. **開発者モードをオンにする**

   Settings の Security and login で、Developer mode をオンにします。

2. **アプリを作る**

   アプリの一覧で ＋ ボタンを押し、名前とアドレスを入れて作ります。

3. **接続を許可する**

   コンソールの確認画面が開きます。内容を確かめて「許可」を押します（[確認画面で見ること](https://docs.vibebooking.ai/connect-assistant#consent)）。

ChatGPT は、下書きを作る前に毎回確認を求めます。

> **メモ**
>
> Claude と ChatGPT の画面の名前は、各社の更新で変わることがあります。見つからないときは、各社のヘルプ（[Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)、[ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta)）を確かめてください。

## 確認画面で見ること

確認画面には「claude.aiにアカウントへの接続を許可しますか」のように、アシスタントの名前が出ます。「許可」を押す前に、次の 3 つを確かめます。

![AIアシスタントの接続を許可する確認画面。接続先、できること、対象のアカウントが並ぶ。](https://docs.vibebooking.ai/screenshots/ja/assistant-consent-desktop.webp)
*Claudeから開いた確認画面。*

| 項目 | 確かめること |
| --- | --- |
| 「接続先」 | アドレスに見覚えがあるか。なければ「拒否」を押します。 |
| 「できること」 | はじめは「読み取りと下書き」が選ばれていて、施設の情報の下書きまで作ります。読むだけでよければ「読み取りのみ」を選びます。 |
| 「対象のアカウント」 | チェックを入れたアカウントにだけ接続します。 |

どれを選んでも、アシスタントが作れるのは下書きまでです。公開と承認は、ご自身が行います。

## 接続したあと

アシスタントが下書きを作って確認を頼むと、受信箱とメールに知らせが届きます。「提案を確認する」から内容を確かめ、公開する下書きを選んで公開します。手順は [下書きを確かめる](https://docs.vibebooking.ai/ai-assistants#review) にあります。

予約システムとの連携は、アシスタントからはできません。[Beds24](https://docs.vibebooking.ai/connect-beds24) や [Channex](https://docs.vibebooking.ai/connect-channex) の手順で、コンソールからご自身で行います。

## スクリプト用の API キー

アシスタントの接続に、キーは要りません。スクリプトや代行業者のツールから使うときにだけ、キーを作ります。

1. **「開発者・代行業者向け」を開く**

   メニューの「設定」を開き、「開発者・代行業者向け」を押します。

2. **「APIキーを作成」に入力する**

   「名前」と「有効期限」を入れ、読み取りか書き込みかを選びます。

3. **「作成」を押す**

   キーが表示されます。`vbk_` で始まり、表示されるのはこのときだけです。コピーして、安全な場所に保管してください。

![APIキーを作成する欄。名前、権限、対象のアカウント、有効期限を選ぶ。](https://docs.vibebooking.ai/screenshots/ja/api-key-create-desktop.webp)
*APIキーを作成する欄。*

キーの「取り消す」を押すと、そのキーはすぐに使えなくなります。

## 接続を解除する

「設定」の「接続中のAIアシスタント」で、アシスタントの「解除」を押します。まとめて解除するときは「すべて解除」を押します。解除したアシスタントは、すぐにこのアカウントを操作できなくなります。

# Beds24 と連携する

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

Beds24 と連携すると、VibeBooking が Beds24 から施設の一覧、料金、空室を読み取れるようになります。コンソールと Beds24 の管理画面を行き来して進めます。

## 始める前に

次の 2 つを確かめてください。

- コンソールでの役割が「オーナー」か「管理者」であること。「閲覧者」は連携できません。
- Beds24 の管理画面にログインできること。コンソールには「二段階認証を求められることがあります。オーナーご本人が操作してください。」と表示されます。

### ウェブサイトを先に追加する

施設のウェブサイトは、連携のあとに Beds24 の施設ごとに入力します。先に追加しておくこともできます。

1. **「施設を追加」を開く**

   メニューの「施設」を押し、「一覧」の「施設を追加」を開きます。施設が 1 つもないときは、はじめから開いています。

2. **ドメインを入力する**

   「施設のウェブサイト」に、施設のサイトのドメインを入力します。`https://` やパスは付けません（例：`hana-kyoto.jp`）。

3. **「追加する」を押す**

   施設が一覧に加わります。状態は「未連携」です。

![施設を追加する欄。施設のウェブサイトを入力して、追加するボタンを押す。](https://docs.vibebooking.ai/screenshots/ja/add-property-desktop.webp)
*施設を追加する欄。*

## 連携する

「施設」の「一覧」で「予約システムと連携する」を押すと、「連携」タブが開きます。「お使いの予約システム」の「Beds24と連携する」を押すと、次の画面が開きます。

![Beds24と連携する画面。招待コードを貼り付ける欄と連携するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/connect-wizard-desktop.webp)
*連携の画面。招待コードを貼り付ける欄がある。*

1. **Beds24 を開く**

   「Beds24で招待コードを作る」を押します。Beds24 の管理画面が新しいタブで開きます。VibeBooking が求める 3 つの読み取り権限は、このリンクに入っています。

2. **Beds24 で招待コードを作る**

   Beds24 の画面で、次のとおり操作します。コンソールにも同じ案内が出ます。

   1. 「Name for this token」欄に、わかる名前を入力する（例：VibeBooking）
   2. 「Generate invite code」を押す

   できた招待コードをコピーします。招待コードについては、Beds24 の公式ドキュメント [API V2](https://wiki.beds24.com/index.php/Category:API_V2) に説明があります。

3. **招待コードを貼り付ける**

   コンソールのタブに戻り、「招待コード」欄に貼り付けて「連携する」を押します。

コードが確認できると、「Beds24との連携を確認しました」の画面に移ります。続けてこの画面で、Beds24 の施設をウェブサイトに紐づけます。手順は [施設を紐づける](https://docs.vibebooking.ai/go-live#link) にあります。

![Beds24の施設をウェブサイトに紐づける表。](https://docs.vibebooking.ai/screenshots/ja/connect-linking-desktop.webp)
*Beds24の施設をウェブサイトに紐づける表。*

## VibeBooking が読み取れる情報

VibeBooking が求めるのは、次の 3 つの読み取り権限だけです。Beds24 の内容を書き換えることはありません。

| 権限 | 読み取る内容 | 使い道 |
| --- | --- | --- |
| 施設 | Beds24 にある施設と部屋タイプの一覧 | 施設の紐づけ |
| 料金と空室 | 指定した日と人数での料金、空室 | 施設の「情報」タブの「指定日・人数での1泊料金」に自動で入る |
| 予約 | 基本の予約情報だけ | レポートの「計測できた予約」を数える |

宿泊者の氏名、連絡先、支払いの情報を読む権限は求めません。権限の定義は、Beds24 の [API リファレンス](https://beds24.com/api/v2) にあります。

AI 向けに公開されるのは、「公開する」を押した施設だけです（[公開する](https://docs.vibebooking.ai/go-live#go-live)）。

## うまくいかないとき

### 招待コードが通らない

「連携する」を押したあと、「コードが正しくないか、使用済みです。Beds24で新しいコードを作って貼り付けてください。」と表示されたときは、次の順に確かめてください。

1. コードの途中に空白が入っていないか。前後の空白は取り除かれますが、途中の空白は残ります。
2. 前に使ったコードではないか。使用済みのコードは使えないので、Beds24 で新しいコードを作ります。
3. 少し待ってから、もう一度「連携する」を押す。

### 権限が足りない

「この招待コードでは、必要な情報の一部を読み取れません。Beds24で招待コードを作り直してください。」は、招待コードに VibeBooking が求める権限の一部が入っていないときの表示です。「Beds24で招待コードを作る」から Beds24 を開き直し、新しい招待コードを作ってください。権限については、Beds24 の公式ドキュメント [API V2](https://wiki.beds24.com/index.php/Category:API_V2) に説明があります。

## 連携を解除する

連携を解除できるのは「オーナー」と「管理者」です。

1. **「連携」タブを開く**

   メニューの「施設」を押し、「連携」タブを開きます。

2. **「連携を解除する」を押す**

   Beds24 のカードにある「連携を解除する」を押します。

3. **「解除する」を押す**

   「Beds24との連携を解除しますか？」と確認されます。「解除する」を押すと、「連携を解除しました。」と表示されます。

![連携タブのBeds24のカード。紐づけを見直すボタンと、連携を解除するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/connection-beds24-desktop.webp)
*連携タブのBeds24のカード。*

解除すると、次のようになります。

- 料金と空室の取得が止まります。連携で受け取った権限は、VibeBooking が Beds24 の側でも取り消します。以後、Beds24 からは何も読み取りません。
- 公開中のページは残りますが、料金は表示されなくなります。公開をやめるときは、施設ごとに [公開をやめる](https://docs.vibebooking.ai/go-live#back-to-preview) の操作をします。
- データは削除されません。

「解除できませんでした。もう一度お試しください。」と表示されたときは、連携はまだ続いています。もう一度「連携を解除する」から操作してください。

### 連携の詳細が確認できないとき

Beds24 のカードに「連携を解除する」が出ず、紐づけ件数だけが表示されることがあります。連携は、その操作をしたブラウザが覚えています。連携したときと同じ端末とブラウザでログインすると、「連携を解除する」が出ます。そのブラウザのデータを消したときも、同じ表示になります。

### Beds24 の側で取り消す

連携した端末が使えないときは、Beds24 の管理画面で、VibeBooking に渡した権限を取り消せます。操作の場所は、Beds24 の公式ドキュメント [API V2](https://wiki.beds24.com/index.php/Category:API_V2) で確かめてください。

# Channex と連携する

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

Channex と連携すると、VibeBooking が Channex から施設の一覧、料金、空室を読み取れるようになります。Channex で API キーを 1 つ作り、コンソールに貼り付けます。2 分ほどで終わります。

## 始める前に

次の 2 つを確かめてください。

- コンソールでの役割が「オーナー」か「管理者」であること。「閲覧者」は連携できません。
- Channex の管理画面にログインして、API キーを作れること。

お客様が予約するページの URL は、Channex からは読み取れません。予約エンジンをお使いなら、予約ページの URL を手元に用意してください。あとから入力することもできます（[予約ページを入力する](https://docs.vibebooking.ai/connect-channex#booking-page)）。

## 連携する

「施設」の「一覧」で「予約システムと連携する」を押すと、「連携」タブが開きます。「お使いの予約システム」の「Channexと連携する」を押します。

![Channexと連携する画面。APIキーと予約ページのURLを入力する欄と、連携するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/connect-channex-wizard-desktop.webp)
*Channexと連携する画面。APIキーと予約ページのURLを、ここに入れる。*

1. **Channex の API キー設定を開く**

   「ChannexでAPIキー設定を開く」を押します。Channex の API キーの設定画面が、新しいタブで開きます。

2. **Channex で API キーを作る**

   コンソールの案内のとおりに操作します。

   1. 「キーに、わかる名前を付ける（例：VibeBooking）」
   2. 「表示されたキーをコピーする」

3. **API キーを貼り付ける**

   コンソールのタブに戻り、「APIキー」欄に貼り付けます。前後に空白が入っていても構いません。

4. **予約ページの URL を入力する**

   「予約ページのURL（おすすめ）」に、予約エンジンのページの URL を入力します。空欄のままでも連携できます。

5. **「連携する」を押す**

   キーが確認できると、「Channexとの連携を確認しました」の画面に移ります。

続けてこの画面で、Channex の施設をウェブサイトに紐づけます。手順は [施設を紐づける](https://docs.vibebooking.ai/go-live#link) にあります。予約ページを入力しなかったときは、この画面に「予約ページが未設定です。AIはお客様を予約ページへ案内できません。」と表示されます。

## 予約ページを入力する

AI は、ここに入力したページへお客様を案内します。入力しなくても施設は公開できますが、AI はお客様を予約ページへ案内できません。

1. **「連携」タブを開く**

   メニューの「施設」を押し、「連携」タブを開きます。

2. **URL を入力する**

   Channex のカードの「予約ページ」に、予約エンジンのページの URL を入力します。

3. **「保存する」を押す**

   「予約ページを保存しました。」と表示されます。

![連携タブのChannexのカード。予約ページのURLを入力する欄と、保存するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/connection-channex-desktop.webp)
*連携タブのChannexのカード。予約ページは、ここで入れ直せる。*

入力できるのは、`https://` で始まる、お使いの予約エンジンのページです。楽天トラベルや Booking.com のような予約サイトのページは使えません。欄を空にして「保存する」を押すと、「予約ページを削除しました。」と表示されます。

予約エンジンが施設のサイトと別のドメインにあると、「施設のウェブサイトとは別のドメインです。予約エンジンが別のドメインにあるなら、このままで問題ありません。」と表示されます。予約エンジンのページで合っていれば、そのままで構いません。

## VibeBooking専用チャネルを選ぶ

VibeBooking のリンクから入った予約を数えるための設定です。Channex に VibeBooking 専用の予約ページ（チャネル）を 1 つ作り、Channex のカードの「VibeBooking専用チャネル」で選びます。そのチャネルに入った予約が、VibeBooking 経由として数えられます。数えるのはチャネル全体で、AI ごとには分かれません。

設定するまでは「未設定です。VibeBooking経由の予約は、まだ数えられません。」と表示されます。

1. **Channex でチャネルを作る**

   Channex で、VibeBooking 専用のチャネルを 1 つ作ります。名前に VibeBooking と入れておくと、コンソールで最初から選ばれます。まだ作っていないときは、カードの「Channexで予約ページを作る」から Channex のチャネルの画面を開けます。

2. **チャネルを選ぶ**

   コンソールの「連携」タブに戻り、「VibeBooking専用チャネル」の一覧から、作ったチャネルを選びます。名前に VibeBooking が入っていれば「VibeBookingという名前のチャネルを選んであります。保存すると決まります。」と表示されます。Booking.com のような予約サイトのチャネルは、一覧に出ません。

3. **「保存する」を押す**

   「チャネルIDを保存しました。」と表示されます。

一覧にないときは「一覧にないときは、IDを貼り付ける」を開きます。Channex でそのチャネルを開き、アドレスバーの URL を貼り付けて「保存する」を押します。一覧を読み取れなかったときは、欄の名前が「VibeBooking専用チャネルのID」になり、同じように URL を貼り付けます。

変更できるのは「オーナー」と「管理者」です。

## VibeBooking が読み取る情報

VibeBooking は API キーで、Channex から施設の一覧、料金、空室を読み取ります。Channex の内容を書き換えることはありません。

AI 向けに公開されるのは、「公開する」を押した施設だけです（[公開する](https://docs.vibebooking.ai/go-live#go-live)）。

## うまくいかないとき

### キーが確認できない

「連携する」を押したあと、「確認できませんでした。キーの入力が間違っているか、Channexに届いていない可能性があります。もう一度貼り付けるか、しばらくしてからお試しください。」と表示されたときは、次の順に確かめてください。

1. キーを最後までコピーしたか。長い文字列なので、コピーのときに途中で切れることがあります。Channex の画面でもう一度コピーします。
2. 別のキーを貼り付けていないか。
3. 少し待ってから、もう一度「連携する」を押す。

### 権限が足りない

「このキーでは、必要な情報の一部を読み取れません。ChannexでAPIキーを作り直してください。」と表示されたときは、「ChannexでAPIキー設定を開く」から Channex を開き直し、新しいキーを作って貼り付けてください。

### 予約ページの URL が使えない

予約ページの URL が受け付けられないときは、次のどれかが表示されます。

| 表示 | 原因と対処 |
| --- | --- |
| 「https:// で始まるURLを入力してください。」 | `http://` の URL は使えません。予約エンジンの `https://` のページを入力します。 |
| 「予約サイトのURLは使えません。お使いの予約エンジンのURLを入力してください。」 | 楽天トラベルや Booking.com のような予約サイトのページです。施設が契約している予約エンジンのページを入力します。 |
| 「VibeBookingのURLは使えません。お使いの予約ページのURLを入力してください。」 | VibeBooking のページの URL です。予約エンジンのページを入力します。 |
| 「URLからIDとパスワードを外してください。」 | URL にログイン用の ID やパスワードが含まれています。取り除いてから入力します。 |
| 「URLを確認してください。例：https://book.example.jp/」 | URL として読み取れませんでした。ブラウザのアドレス欄からコピーし直します。 |

## 連携を解除する

連携を解除できるのは「オーナー」と「管理者」です。

1. **「連携」タブを開く**

   メニューの「施設」を押し、「連携」タブを開きます。

2. **「連携を解除する」を押す**

   Channex のカードにある「連携を解除する」を押します。

3. **「解除する」を押す**

   「Channexとの連携を解除しますか？」と確認されます。「解除する」を押すと、「連携を解除しました。」と表示されます。

4. **Channex で API キーを削除する**

   解除しても、Channex には通知が届きません。Channex の API キーの設定画面で、VibeBooking 用に作ったキーを削除してください。

解除すると、次のようになります。

- 料金と空室の取得が止まります。
- 公開中のページは残りますが、料金は表示されなくなります。公開をやめるときは、施設ごとに [公開をやめる](https://docs.vibebooking.ai/go-live#back-to-preview) の操作をします。
- データは削除されません。

「解除できませんでした。もう一度お試しください。」と表示されたときは、連携はまだ続いています。もう一度「連携を解除する」から操作してください。

# 旅行者向けコネクター

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

旅行者の AI アシスタントは、vibebook という MCP サーバーを通じて施設を見つけます。ご自身のアシスタントに追加するもの（[AI アシスタントとつなぐ](https://docs.vibebooking.ai/connect-assistant)）とは別のサーバーです。あちらはアカウントの管理用でログインが必要ですが、vibebook は公開した情報を読むだけで、だれでも追加できます。

## 2つのアドレス

| アドレス | 使う人 | ログイン |
| --- | --- | --- |
| `https://vibebook.vibebooking.ai/mcp` | 旅行者のアシスタント。宿を探し、料金を確かめ、予約リンクを受け取ります | 不要 |
| `https://mcp.vibebooking.ai/mcp` | 施設のかたとそのアシスタント。サイトの確認や施設情報の下書きをします | 必要（[AI アシスタントとつなぐ](https://docs.vibebooking.ai/connect-assistant)） |

vibebook は公式の MCP Registry に `ai.vibebooking/vibebook` の名前で載っています。サーバーカードは `https://vibebook.vibebooking.ai/.well-known/mcp/server-card.json` にあります。

## できること

| ツール | 返すもの |
| --- | --- |
| `search_hotels` | 地域（京都市東山区、祇園など）で公開中の施設 |
| `resolve_hotel` | あるサイトが VibeBooking の施設かどうか（ドメインで調べます） |
| `get_hotel` | 施設の公開情報と部屋タイプ |
| `get_rates` | 日程ごとの最新の料金。合計額、キャンセル規定、予約リンクつき |
| `book_link` | その日程、または `get_rates` のプランひとつの予約リンク |

どのツールも読むだけです。vibebook で予約、仮押さえ、支払いはできません。予約リンクを開くと料金をもう一度確かめてから施設の予約ページが開き、旅行者はそこで予約して支払います。

## 載る施設

公開中の施設だけです。公開していない施設（[公開する](https://docs.vibebooking.ai/go-live)）は答えに出ません。施設について答える内容は、公開した情報そのものです。

## アシスタントに追加する

Claude Code では次のコマンドで追加します。

```sh
claude mcp add --transport http vibebook \
  https://vibebook.vibebooking.ai/mcp
```

Claude や ChatGPT では、[AI アシスタントとつなぐ](https://docs.vibebooking.ai/connect-assistant#claude) と同じ手順で、このアドレスをカスタムコネクター（アプリ）として追加します。ログインの手順はありません。

# 公開する

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

施設の状態は、「施設」の「一覧」と施設の画面に表示されます。

| 状態 | 意味 |
| --- | --- |
| 「未連携」 | 予約システムの施設と、まだ紐づいていません。 |
| 「プレビュー」 | 紐づいていますが、まだ公開していません。 |
| 「公開中」 | AI が読めます。 |
| 「デモ（AIには非表示）」 | 「設定」タブでデモ用にした施設です。公開していても、AI には表示されません。 |

## 施設を紐づける

予約システムとの連携が確認できると、「Beds24との連携を確認しました」のような画面が開きます。「Beds24に登録されている施設」の表に、予約システムにある施設が並びます。

1. **ウェブサイトを入れる**

   公開したい施設の「ウェブサイト」の欄に、その施設のウェブサイトを入れます。追加済みのウェブサイトは候補から選べます。まだ紐づけていないウェブサイトが、はじめから入っていることもあります。

2. **「準備する」を押す**

   ウェブサイトが保存され、その施設の「情報」タブが開きます。施設は「プレビュー」になります。まだ公開はされません。

![Beds24の施設をウェブサイトに紐づける表。](https://docs.vibebooking.ai/screenshots/ja/connect-linking-desktop.webp)
*予約システムの施設が並ぶ表。施設ごとにウェブサイトを入れる。*

「施設を見る」を押すと、「施設」の「一覧」に移ります。あとでこの画面に戻るときは、「施設」の「連携」タブで「紐づけを見直す」を押します。

ウェブサイトを入れずに「準備する」を押すと、「この施設のウェブサイトを入力してください。」と表示されます。部屋数が読み取れなかった登録は、表の下の「その他の登録」に並びます。日帰りプランやテスト用の登録なら、紐づけは要りません。

## 施設情報を確かめる

「施設」の「一覧」で施設を押すと、施設の画面が開きます。タブは「情報」「プレビュー」「設定」の 3 つで、はじめは「情報」が開きます。タブの上には、施設の状態と、公開まであと何項目かが出ます。

「情報」タブの「公開に必要な項目」に、公開に必要な 6 項目が並びます。保存した内容が、そのまま掲載されます。

### 自動で入れる

6 項目の多くは、手で入力しなくても入ります。次の順で入れるのがおすすめです。

1. 予約システムと施設のサイトから。施設の画面を開くと、読み取れた内容がはじめから入っていて、「サイトと予約システムから4項目を入れました。」のように表示されます。サイトから入った項目には「サイトから」と、読んだページが出ます。
2. 「文章やファイルから入れる」から。パンフレット、予約サイトの紹介文、メールの下書きなどを貼り付けるか、ファイル（PDF・Word・Excel・テキスト）を入れます。AI が読み取って、空いている項目に入れます。すでに入っている項目には、選べる値として出ます。貼り付けた文は保存しません。
3. AI アシスタントから。[AI アシスタントとつなぐ](https://docs.vibebooking.ai/connect-assistant) と、アシスタントが下書きを作ります。公開する前に、ご自身で確かめます（[下書きを確かめる](https://docs.vibebooking.ai/ai-assistants#review)）。

どれも保存するまでは掲載されません。残った項目だけ、手で入れます。

| 項目 | 手で入れるとき |
| --- | --- |
| 「指定日・人数での1泊料金」 | 予約システムから自動で入ります。入力はいりません。 |
| 「チェックイン・チェックアウト時刻」 | 一覧から選びます。 |
| 「キャンセル規定（無料期限・料率・不泊）」 | 何日前かを一覧から選び、料率（%）を入れます。 |
| 「所在地（住所）」 | 入力します。 |
| 「最寄り駅・空港からのアクセス（徒歩○分）」 | 入力します。 |
| 「定員（大人・子ども）」 | 入力します。 |

チェックイン・チェックアウト時刻とキャンセル規定は、全施設にまとめて入力できます。「施設」の「共通設定」タブで「全施設の共通設定」に入力し、「保存して全施設に適用」を押します。

### 確かめて保存する

1. **内容を確かめる**

   入っている内容を確かめ、違うところを直します。

2. **保存する**

   保存していない項目があると、画面の下に「7項目を保存する」のようなボタンが出ます。押すと保存されます。6 項目がそろうと「6項目を保存しました。6項目がそろいました。」と表示され、横に「公開する」が出ます。

![施設の情報タブの公開に必要な項目。予約システムから入った内容と、項目を保存するボタンが表示される。](https://docs.vibebooking.ai/screenshots/ja/go-live-facts-desktop.webp)
*情報タブの公開に必要な項目。保存していない項目があると、下に保存のボタンが出る。*

保存した項目には「保存済み」と出ます。直すときは「編集する」を押します。

## プレビューで確かめる

「プレビュー」タブで、AI に伝わる内容を確かめます。

| 表示 | 中身 |
| --- | --- |
| 「AIに伝わる内容」 | AI が旅行者の質問に答えるときに使う内容です。まだ入力していない項目は「未入力」と出ます。 |
| 「AIが読む原文（英語）」 | AI が実際に読むページです。「別タブで開く」で、別のタブに開きます。 |

![施設のプレビュータブ。AIに伝わる内容と、公開するボタンが並ぶ。](https://docs.vibebooking.ai/screenshots/ja/go-live-preview-desktop.webp)
*プレビュータブ。AIに伝わる内容が表示される。*

「オーナー」と「管理者」には、「プレビューリンクを共有」も出ます。このリンクは、ログインしなくても画面に出る期限まで開けます。ウェブ担当者や取引先に見てもらうときに使います。

## 公開する

公開できるのは「オーナー」と「管理者」です。施設の画面の上にある「公開する」から、どのタブを開いていても公開できます。その横の表示は、施設の状態で変わります。

| 表示 | すること |
| --- | --- |
| 「先に予約システムと連携してください。」 | 施設がまだ紐づいていません。予約システムと連携します（[Beds24](https://docs.vibebooking.ai/connect-beds24)、[Channex](https://docs.vibebooking.ai/connect-channex)）。 |
| 「あと2項目で公開できます。」など | 足りない項目を「情報」タブで入力します。 |
| 「公開できます。6項目がそろいました。」 | 公開できます。 |

1. **「公開する」を押す**

   6 項目がそろったら、「公開する」を押します。

2. **表示を確かめる**

   「公開しました。AIがこのページを読めるようになりました。」と表示され、施設の状態が「公開中」になります。AI 向けのページのアドレスも出ます。

### 公開をやめる

「設定」タブの「公開をやめる」で、「非公開に戻す」を押します。施設は「プレビュー」に戻り、AI は読めなくなります。施設の情報とプレビューは残るので、いつでも公開し直せます。

# サイトからリンクする

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

施設のサイトからリンクすると、AI が公開したページを見つけやすくなります。

## リンク先のアドレス

リンク先は、公開したページを配信しているアドレスです。次のどちらかになります。

| 配信先 | リンク先 |
| --- | --- |
| 当社のドメイン | `https://vibebooking.ai/hotels/…`。設定はいりません。 |
| 独自ドメイン | `https://agents.hana-kyoto.jp/hotels/…` のような、施設のサイトのサブドメイン。[独自ドメインで配信する](https://docs.vibebooking.ai/custom-domain) の設定が必要です。 |

独自ドメインの準備ができると、「サイトからリンクする」に出るリンクも独自ドメインのアドレスに変わります。先に当社のドメインでリンクを貼っていたら、貼り直してください。

## リンクを貼る

公開すると、「プレビュー」タブに「サイトからリンクする」が出ます。画面の説明は「3つのうち、できるものだけで構いません。次回のスキャンで確認します。」です。

- 「サイトのフッターに入れるリンク」
- 「サイトの robots.txt に追加する行」
- 「サイトの llms.txt に追加する行」

![公開した施設のプレビュータブ。サイトからリンクする案内が表示される。](https://docs.vibebooking.ai/screenshots/ja/go-live-publish-desktop.webp)
*公開した施設のプレビュータブ。サイトからリンクする案内が表示される。*

1. **「コピー」を押す**

   使うものの「コピー」を押し、施設のサイトに追加します。

2. **「貼りました」を押す**

   「情報」タブの「AIに見つけてもらうまで」を開き、「貼りました」を押します。

# 予約画面で予約を受け付ける

> **ご利用いただけるプラン**
>
> Standard・Proプランでご利用いただけます。Freeプランでも画面に表示されますが、ご利用はStandardプランからです。

AI の回答から予約リンクを開いたお客様は、いまは施設のこれまでの予約ページに進みます。「予約画面」タブの項目を済ませると、行き先を VibeBooking の予約画面に切り替えられます。施設のロゴとテーマカラーの画面で、お客様が予約まで進めます。

> **メモ：いまはテスト環境です**
>
> カード決済は Stripe のテストモードで行われ、本当の予約や決済は発生しません。

## 始める前に

- 予約システムに Channex を使う施設が対象です。先に [Channex と連携する](https://docs.vibebooking.ai/connect-channex) を済ませてください。
- 設定できるのは「オーナー」と「管理者」です。
- Free プランでは「Standardプランでご利用いただけます」と表示されます。

## 予約画面を開く

施設を開き、「予約画面」タブを開きます。いちばん上の「予約を受け付けるまで」に、済んだ項目の数が「1/6 完了」のように出ます。

![予約画面タブの「予約を受け付けるまで」。お支払い方法の選択と、まだ済んでいない項目の一覧がある。](https://docs.vibebooking.ai/screenshots/ja/engine-setup-desktop.webp)
*始める前の「予約を受け付けるまで」。済んでいる項目には印がつく。*

## お支払い方法を選ぶ

「お支払い方法」で、お客様がいつ支払うかを選び、「お支払い方法を保存」を押します。両方を選ぶこともできます。

| お支払い方法 | お客様が支払うとき | Stripe の登録 |
| --- | --- | --- |
| 「事前決済（カード）」 | 予約のとき、カードで | 必要 |
| 「現地決済」 | チェックインのとき、施設で | 不要 |

「事前決済（カード）」は、[Stripe に登録する](https://docs.vibebooking.ai/booking-engine#stripe) と選べるようになります。

![お支払い方法の欄。事前決済（カード）と現地決済のチェックボックスと、保存するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/engine-modes-desktop.webp)
*「事前決済（カード）」を選んで保存したところ。*

## Stripe に登録する

事前決済の売上は施設の Stripe アカウントに入り、お客様のカード明細にも施設の名前が出ます。Stripe のアカウントは、VibeBooking のアカウントにひとつです。

1. **「Stripeに登録する」を押す**

   施設の Stripe アカウントが作られ、Stripe の登録ページに移ります。

2. **Stripe のページで登録する**

   事業の情報、代表者の本人確認、入金先の口座を、事業者ご本人が入力します。入力した内容は Stripe に届き、VibeBooking には届きません。

3. **予約画面に戻る**

   登録が済むと、「予約画面」タブに戻ります。

入力が残っているときは「Stripeの手続きを続ける」で続きから入力します。Stripe の確認には数日かかることがあります。

## 項目を済ませる

「予約を受け付けるまで」の項目は 6 つです。済んでいない項目には、何が足りないかが出ます。

![予約を受け付けるまでの項目の一覧。済んだ項目に印がつき、カード明細の名前の確認が残っている。](https://docs.vibebooking.ai/screenshots/ja/engine-checklist-desktop.webp)
*テスト予約まで済んだところ。残りはカード明細の名前。*

| 項目 | 済ませ方 |
| --- | --- |
| Stripe でカード決済を使えるようにする | [Stripe に登録する](https://docs.vibebooking.ai/booking-engine#stripe) を最後まで進めます。「現地決済」だけなら不要です。 |
| 予約システムに予約を入れられるようにする | 「予約システムから応答がありません。連携の設定をご確認ください。」と出たら、Channex に Booking CRS アプリが入っているか、API キーが有効かを確かめます。 |
| 取り消した予約の空室を戻せるようにする | Channex で在庫を戻す 2 つの設定をオンにします（初期状態はオフ）。設定の名前は [サイトコントローラー・PMS との連携](https://docs.vibebooking.ai/inventory-systems#channex) にあります。 |
| テスト予約を入れて、取り消す | 「テスト予約を行う」を押すと、Channex に予約を 1 件入れて、すぐに取り消します。失敗したら、上の 2 項目を確かめてから押し直します。 |
| カード明細に出る名前を確かめる | 下の [カード明細の名前](https://docs.vibebooking.ai/booking-engine#descriptor) をご覧ください。「現地決済」だけなら不要です。 |
| 公開に必要な6項目をそろえて公開する | [公開する](https://docs.vibebooking.ai/go-live) の手順で公開します。 |

### カード明細の名前

「カード明細の表記（Stripe）」と「予約画面の施設名」を見比べます。明細の名前が施設名とかけ離れていると、お客様が身に覚えのない請求と思うことがあります。表記は Stripe の管理画面で変えられます。問題がなければ「この表記で問題ありません」を押します。

![カード明細の表記（Stripe）と予約画面の施設名が並び、「この表記で問題ありません」のボタンがある。](https://docs.vibebooking.ai/screenshots/ja/engine-descriptor-desktop.webp)
*Stripe の表記と予約画面の施設名を見比べる。*

あとで Stripe の表記を変えたときは、もう一度確かめます。

## 予約リンクの行き先を切り替える

項目がすべて済むと、「この予約画面に切り替える」を押せます。以後、予約リンクから来たお客様は予約画面で予約します。

![すべての項目が済んだあとの予約リンクの行き先。「この予約画面に切り替える」ボタンが押せる。](https://docs.vibebooking.ai/screenshots/ja/engine-ready-desktop.webp)
*すべての項目が済み、切り替えられる状態。*

切り替えたあとは、タブのいちばん上がロゴと色の設定になります（[予約画面にロゴと色をつける](https://docs.vibebooking.ai/checkout-brand)）。元に戻すときは「これまでの予約ページに戻す」を押します。

![予約リンクの行き先をこの予約画面に切り替えたあとの表示。これまでの予約ページに戻すボタンがある。](https://docs.vibebooking.ai/screenshots/ja/engine-switched-desktop.webp)
*切り替えたあと。これまでの予約ページに戻すこともできる。*

### 切り替えられないとき

画面を開いたあとで状況が変わると（Stripe の表記を変えたときなど）、切り替わらずに、残っている項目の名前が出ます。その項目を済ませてから、もう一度押します。

![切り替えられなかったときの表示。まだ残っている項目の名前が並ぶ。](https://docs.vibebooking.ai/screenshots/ja/engine-not-ready-desktop.webp)
*残っている項目の名前が出る。*

## プランが変わったとき

施設が Free プランに変わると、お客様はこれまでの予約ページに進みます。予約画面を使えるプランに戻れば、設定し直さなくても、また予約画面に進みます。

# 予約画面にロゴと色をつける

> **ご利用いただけるプラン**
>
> Standard・Proプランでご利用いただけます。Freeプランでも画面に表示されますが、ご利用はStandardプランからです。

お客様が予約する画面に、施設のロゴとテーマカラーを表示できます。どちらも設定しなければ、標準の白黒の画面のままです。

## 始める前に

- Free プランでは「予約画面」タブに「Standardプランでご利用いただけます」と表示され、「使ってみたい」を押すとご希望が当社に届きます。
- 設定を変えられるのは「オーナー」と「管理者」です。「閲覧者」は見るだけです。

## ロゴと色を設定する

施設を開き、「予約画面」タブを開きます。左が「予約画面のロゴと色」、右が予約画面のプレビューです。

1. **ロゴを選ぶ**

   「ロゴの画像を選ぶ」で画像を載せます（PNG・JPEG・WebP）。ロゴを施設の写真として載せてあれば、「載せている写真から選ぶ」からも選べます。

2. **テーマカラーを選ぶ**

   「テーマカラー」の色の欄を押して、色を選びます。

3. **プレビューで確かめる**

   変更は、保存する前から右のプレビューに反映されます。表示する画面は「予約入力」「確認」「完了」「予約の確認」で、幅は「パソコン」「スマホ」で切り替えます。

4. **「保存」を押す**

   「保存しました。お客様の予約画面にも反映されます。」と表示されます。

![予約画面のロゴと色の設定。左にロゴとテーマカラー、右に予約画面のプレビューが並ぶ。](https://docs.vibebooking.ai/screenshots/ja/checkout-brand-desktop.webp)
*ロゴと色の設定と、予約画面のプレビュー。*

| 設定 | お客様の画面に出る場所 |
| --- | --- |
| ロゴ | 各画面のいちばん上、施設名の左 |
| テーマカラー | 予約確定ボタンをはじめとするボタンと、手順の進み具合を示す線 |

![施設のロゴとテーマカラーで表示された、お客様情報の入力画面。](https://docs.vibebooking.ai/screenshots/ja/checkout-details-desktop.webp)
*ロゴとテーマカラーで表示された、お客様情報の入力画面。*

元に戻すには、「ロゴを外す」または「標準の色に戻す」を押してから「保存」を押します。

## 明るすぎる色は使えない

テーマカラーの上には、白い文字がのります。白い文字が読みにくい色を選ぶと、「この色は明るすぎて、上にのる白い文字が読みにくくなります。もう少し濃い色を選んでください。」と表示され、保存できません。

基準は、白い文字とのコントラスト比 4.5:1 以上です（WCAG AA）。

![明るい黄色を選んだテーマカラー欄。明るすぎて白い文字が読みにくいという表示が出ている。](https://docs.vibebooking.ai/screenshots/ja/checkout-brand-too-light-desktop.webp)
*明るい黄色は、白い文字が読みにくいため保存できない。*

## 予約画面を試す

「予約画面を試す」を押すと、新しいタブで予約画面が開きます。お客様と同じ画面で、予約の完了まで進めます。カードは次のテスト用の内容を入れます。

| 項目 | 入れる内容 |
| --- | --- |
| カード番号 | `4242 4242 4242 4242` |
| 有効期限 | 今日より先の日付 |
| セキュリティコード | 任意の 3 桁 |

試し予約は、実際の予約にはなりません。

| 項目 | 試し予約では |
| --- | --- |
| 料金 | 請求されません。 |
| 予約システム | 予約は書き込まれません。 |
| 予約の記録 | 残りません。 |
| メール | 予約確定と領収書のメールが、ご自身のメールアドレスに届きます。件名の頭に `[PREVIEW]` がつきます。 |

![テーマカラーで表示された「予約を確定する」ボタン。](https://docs.vibebooking.ai/screenshots/ja/checkout-confirm-desktop.webp)
*予約を確定するボタンも、テーマカラーになる。*

![施設のロゴとテーマカラーで表示された、予約完了の画面。](https://docs.vibebooking.ai/screenshots/ja/checkout-done-desktop.webp)
*予約完了の画面。試し予約の予約番号は PREVIEW で始まる。*

## AI アシスタントに案を出してもらう

AI アシスタントをつないでいれば、ロゴと色の案をアシスタントに出してもらえます（ツール名は `draft_brand`）。つなぎ方は、[AI アシスタントとつなぐ](https://docs.vibebooking.ai/connect-assistant)をご覧ください。案が届くと、「予約画面」タブに「AIアシスタントから、ロゴと色の案が届いています」と表示されます。

![AIアシスタントから届いたロゴと色の案。案を反映するボタンと使わないボタンがある。](https://docs.vibebooking.ai/screenshots/ja/checkout-proposal-desktop.webp)
*AI アシスタントから届いた案。*

「案を反映する」を押すと、案がプレビューに入ります。お客様の画面が変わるのは、確かめて「保存」を押したときです。案を使わないときは「使わない」を押します。

# 独自ドメインで配信する

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

公開したページは、ふだんは当社のドメインで配信されます。独自ドメインを設定すると、施設のサイトのサブドメイン（例：`agents.hana-kyoto.jp`）で配信できます。設定しなくても構いません。

## 始める前に

次の 3 つを確かめてください。

- コンソールでの役割が「オーナー」か「管理者」であること。「閲覧者」には「閲覧のみです。ドメインの変更はオーナーか管理者が行います。」と表示されます。
- 施設サイトのサブドメインであること。`hana-kyoto.jp` のサイトなら、`agents.hana-kyoto.jp` のような名前です。サイトのドメインそのものは使えません。
- ドメインの DNS 管理画面を操作できること。ほかの人が管理しているときは、[ウェブ担当者に頼む](https://docs.vibebooking.ai/custom-domain#web-person) を見てください。

## 設定する

1. **「独自ドメイン」タブを開く**

   メニューの「施設」を押し、「独自ドメイン」タブを開きます。

2. **サブドメインを入力する**

   「独自ドメインを設定する」の「使うサブドメイン」に名前を入力し、「この名前で設定する」を押します。

3. **DNS レコードを追加する**

   「DNSに追加するレコード」に、「種類」「名前」「値（向き先）」が出ます。お使いの DNS 管理画面で、この 1 行をそのまま追加します。「コピー」で 3 つをまとめてコピーできます。

4. **反映を待つ**

   見出しが「DNSの反映を待っています」から「証明書を発行中です」に変わり、準備ができると「準備完了：agents.hana-kyoto.jp で配信しています」のようになります。画面を開いているあいだは、自動で確認し直します。すぐに確かめるときは「今すぐ確認」を押します。

5. **配信する施設を選ぶ**

   「このドメインで配信する施設」で、施設ごとに「このドメインで配信する」を押します。配信中の施設には「このドメインで配信」と出ます。やめるときは「配信をやめる」を押します。

![独自ドメインのカード。DNSに追加するレコードと、このドメインで配信する施設が表示される。](https://docs.vibebooking.ai/screenshots/ja/custom-domain-record-desktop.webp)
*設定した直後の独自ドメイン。追加するレコードと、配信する施設が並ぶ。*

Cloudflare をお使いなら、追加したレコードのプロキシステータスを「DNS のみ」にしてください。「プロキシ済み」のままだと当社からレコードが見えず、設定が先に進みません。画面のレコードの下にも、同じ注意が出ます。

## ウェブ担当者に頼む

DNS をほかの人が管理しているときは、「ウェブ担当者に送る」を押します。レコードを日本語と英語で載せたページが開きます。このページを開けるのは、このアカウントのメンバーとしてログインしている人だけです。先に担当者を [メンバーとして招待](https://docs.vibebooking.ai/getting-started#invite) してください。

[AI アシスタント](https://docs.vibebooking.ai/ai-assistants) に、ドメインの追加とレコードの確認を任せることもできます。配信する施設を選ぶのは、ご自身です。

担当者がそのページで「確認」を押すと、反映されたかどうかがわかります。反映されていれば「反映を確認しました。」、まだなら「まだ反映されていません。」と出ます。

## 表示の意味

独自ドメインの画面の見出しは、設定の進み具合を表します。どの段階でもページは配信されています。準備が整うまでは当社のドメインで、整ったあとは独自ドメインで配信されます。

| 見出し | 状態 | すること |
| --- | --- | --- |
| 「DNSの反映を待っています」 | 当社から、まだレコードが見えていません。反映には数分から数時間かかることがあります。 | レコードを追加したあとなら、待つだけです。 |
| 「証明書を発行中です」 | レコードは見えています。HTTPS の証明書ができると次に進みます。 | ありません。 |
| 「準備完了：agents.hana-kyoto.jp で配信しています」 | 独自ドメインで配信しています。 | ありません。 |
| 「2026/9/25 以降、このドメインがVibeBookingを指していません」など | 一度は配信できていたのに、レコードが見えなくなりました。 | [レコードが消えたとき](https://docs.vibebooking.ai/custom-domain#lapsed) を見てください。 |
| 「証明書を発行できていません」 | レコードは見えていますが、HTTPS の証明書を発行できていません。当社のドメインで配信を続けています。 | [証明書を発行できていないとき](https://docs.vibebooking.ai/custom-domain#certificate-failed) を見てください。 |

## うまくいかないとき

### サイトのドメインをそのまま入力した

「サブドメインを指定してください。例：agents.hana-kyoto.jp」と表示されたときは、サイトのドメインそのもの（`hana-kyoto.jp`）が入力されています。先頭に `agents.` のような名前を付け、`agents.hana-kyoto.jp` のように入力し直してください。

### 名前がほかのアカウントで使われている

「この名前は、すでに別のアカウントで使われています。」は、同じ名前が VibeBooking の別のアカウントで設定済みのときの表示です。社内の別のアカウントで設定していないか確かめてください。心当たりがなければ、別の名前（例：`ai.hana-kyoto.jp`）を使うか、[お問い合わせ](https://docs.vibebooking.ai/custom-domain#contact) ください。

### 「DNSの反映を待っています」から進まない

数時間たっても変わらないときは、DNS 管理画面のレコードを次の順に確かめてください。

1. 名前が二重になっていないか。サービスによっては、「名前」欄に `agents` の部分だけを入力します。そこへ `agents.hana-kyoto.jp` と入れると、`agents.hana-kyoto.jp.hana-kyoto.jp` という別の名前になります。
2. 種類が CNAME で、値が画面の「値（向き先）」と 1 文字も違わないか。「コピー」で写すと確実です。
3. Cloudflare なら、プロキシステータスが「DNS のみ」か。
4. 同じ名前に、別のレコード（A レコードなど）が残っていないか。残っていると、CNAME を追加できなかったり、正しく確認できなかったりします。

確かめ直したら、「今すぐ確認」を押します。

### DNS を確認できなかったと表示される

「DNSを確認できませんでした。前回確認時の状態を表示しています。自動で再試行します。」は、当社の側で DNS を確認できなかったときの表示です。設定の問題ではありません。画面は前回確認したときの状態のままで、自動で確認し直します。操作は要りません。

### レコードが消えたとき

「2026/9/25 以降、このドメインがVibeBookingを指していません」のような見出しは、一度は配信できていたレコードが見えなくなったときに出ます。DNS 管理画面で、レコードを消したり値を変えたりしていないか確かめてください。そのあいだ、ページは当社のドメインで配信されています。画面の「DNSに追加するレコード」を追加し直すと、自動で元に戻ります。

### 証明書を発行できていないとき

「証明書を発行できていません」は、レコードは見えているのに、独自ドメイン用の HTTPS の証明書を発行できていないときの表示です。そのあいだ、ページは当社のドメインで配信されています。次の順に確かめてください。

1. DNS 管理画面のレコードが、画面の「DNSに追加するレコード」と同じか。
2. ドメインに、証明書の発行元を限る CAA レコードを設定していないか。設定していると、それが原因のことがあります。DNS をウェブ担当者に任せているなら、担当者にご確認ください。

設定を直すと、独自ドメインでの配信に自動で切り替わります。当社でも、証明書の発行を自動で試し続けます。解決しないときは、[お問い合わせ](https://docs.vibebooking.ai/custom-domain#contact) ください。

### 施設を対象にできない

「agents.hana-kyoto.jp は yado-nara.jp の下にないため、この施設には使えません。」のような表示は、設定した名前が、その施設のサイトとは別のドメインにあるときに出ます。たとえば `agents.hana-kyoto.jp` で配信できるのは、サイトが `hana-kyoto.jp` の施設だけです。ほかのサイトの施設には、そのサイトのサブドメインを [別の独自ドメインとして設定](https://docs.vibebooking.ai/custom-domain#set-up) してください。

### 操作が完了しなかった

次の表示は、当社の側で処理が止まったときのものです。少し待ってから、同じ操作をもう一度行ってください。何度試しても同じときは、[お問い合わせ](https://docs.vibebooking.ai/custom-domain#contact) ください。

- 「設定できませんでした。もう一度お試しください。」
- 「変更できませんでした。もう一度お試しください。」
- 「外せませんでした。ドメインはそのままです。もう一度お試しください。」

## 独自ドメインを外す

外すと、ページは当社のドメインでの配信に戻ります。外せるのは「オーナー」と「管理者」です。

1. **「この独自ドメインを外す」を押す**

   外したいドメインのカードで押します。

2. **「外す」を押す**

   「agents.hana-kyoto.jp を外しますか？」のように確認されます。「外す」を押すと、「agents.hana-kyoto.jp を外しました」と表示されます。

3. **DNS レコードを消す**

   DNS 管理画面で、追加したレコードを消します。外したあとなら、いつ消しても構いません。

## お問い合わせ

解決しないときは、エラーの下にある「解決しない場合はお問い合わせ」から送ってください。画面と参照番号も自動で届くので、どの操作でつまずいたかを当社で確認できます。エラーが出ていないときの開き方と受付時間は、[お問い合わせ](https://docs.vibebooking.ai/troubleshooting#contact) にあります。

# レポートを見る

> **ご利用いただけるプラン**
>
> - 読まれた回数、計測できた予約：すべてのプランでご利用いただけます。
> - 前の期間との比較、予約ページへ移動した回数、90日より前の記録：Standard・Proプランでご利用いただけます。
> - どのAIが読んだか、AIが調べた項目：Standard・Proプランでご利用いただけます。Freeプランでも画面に表示されますが、ご利用はStandardプランからです。

## ホームの数字

「ホーム」の「AIに読まれた回数」で、AI に読まれた回数を確かめます。画面の説明は「ChatGPTやPerplexityなどが施設のページを読んだ回数です。本当にそのAIからのアクセスだと確認できたものだけを数えます。」です。ここに出る数字は次のとおりです。

- 「読まれた回数」と、前の期間との比較
- 「予約ページへ移動した回数」
- 「計測できた予約」
- 回数の移り変わりのグラフ（「表で見る」で同じ数字を表にできます）
- 「どのAIが読んだか」と「AIが調べた項目」

「期間」と「集計の単位」で、見る範囲を変えられます。施設が 2 つ以上あれば、「施設」で施設ごとに絞り込めます。施設ごとの回数は、「施設」の「一覧」の「AIに読まれた回数（7日間）」にも出ます。

![ホームの数字。AIに読まれた回数と、その移り変わりのグラフが表示される。](https://docs.vibebooking.ai/screenshots/ja/go-live-report-desktop.webp)
*ホームの数字。AIに読まれた回数と、その移り変わりが表示される。*

プランによっては、数字の代わりに鍵のマークと、その数字が見られるプランの名前が出る項目があります。

## 週ごとに見る

「集計の単位」で「1週間ごと」を選ぶと、1 週間ずつの数字になります。施設を 1 つに絞れば、その施設の週ごとのレポートです。お知らせメールのレポートのリンクからも、同じ画面が開きます。

## まだ読まれていないとき

まだ一度も読まれていないときは、「最初のアクセス待ち」と出ます。説明は「公開したページをAIが初めて読むまで、数日から数週間かかります。読まれると、ここに回数が並びます。」です。その下に、ページが正しく配信されているかの確認結果が並びます。施設のサイトからリンクすると、見つけてもらいやすくなります（[サイトからリンクする](https://docs.vibebooking.ai/link-from-site)）。

# うまくいかないとき

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

コンソールにエラーが出たら、そのメッセージをこのページで探してください。連携と独自ドメインのエラーは、それぞれのページにあります（[Beds24](https://docs.vibebooking.ai/connect-beds24#troubleshooting)、[Channex](https://docs.vibebooking.ai/connect-channex#troubleshooting)、[独自ドメイン](https://docs.vibebooking.ai/custom-domain#troubleshooting)）。

## 参照番号

当社の側で処理が止まったときは、エラーの下に「お問い合わせの際の参照番号: 8F3A-2B9C」のような番号が表示されます。この番号で、どの操作で何が起きたかを当社が確かめられます。

番号の横にある「解決しない場合はお問い合わせ」から送ると、番号も自動で届きます。メールで送るときは、番号を書き添えてください。

## よく表示されるエラー

### 当社の側で問題が起きた

「問題が発生しました。時間をおいてもう一度お試しください。」は、当社の側で処理が止まったときの表示です。設定の問題ではありません。少し待ってから「再試行」を押すか、同じ操作をもう一度行ってください。何度試しても同じときは、[お問い合わせ](https://docs.vibebooking.ai/troubleshooting#contact) ください。

### サーバーに接続できない

「サーバーに接続できません。」は、コンソールから当社のサーバーに接続できなかったときの表示です。ほかのサイトが開けるか確かめ、少し待ってから「再試行」を押してください。ほかのサイトは開けるのに同じ表示が続くときは、当社の側の問題です。コンソールからのお問い合わせも届かないので、hello@vibebooking.ai にメールでご連絡ください。

### 権限がない

「この操作を行う権限がありません。」は、コンソールでの役割では行えない操作をしようとしたときの表示です。「閲覧者」は、施設の追加、連携、公開などができません。必要なときは、アカウントの「オーナー」にご相談ください。別のアカウントのページを開いたときも、この表示になります。

### ページが見つからない

「見つかりませんでした。」は、開こうとしたページがないときの表示です。削除した施設や独自ドメインのページを、古いリンクから開いた場合もこの表示になります。メニューから開き直してください。

### アカウントが削除された

「このアカウントは削除されました。」は、アカウントが削除されたあとの表示です。施設、連携、メンバーはすべて削除されています。「新しいアカウントを作る」から、もう一度始められます。

## ログインできないとき

### ログインが途中で止まった

「ログインを完了できませんでした。もう一度お試しください。」は、Google や LINE でのログインが途中で止まったときの表示です。もう一度「Googleで続ける」か「LINEで続ける」を押してください。ブラウザで別の Google アカウントにログインしているときは、使うアカウントを選び直してください。

### 招待制と表示される

「現在は招待制です。ご案内した方のみログインできます。」と表示されたときは、当社からのご案内が届いたメールアドレスで、ログインしているか確かめてください。

### まだ利用できないと表示される

「このアカウントではまだご利用いただけません。ご案内をお待ちください。」は、ログインしたアカウントで、まだ利用を始められないときの表示です。当社からのご案内をお待ちください。

## お問い合わせ

解決しないときは、コンソールからお問い合わせください。どの画面で何が表示されたかは当社に届くので、改めてご説明いただく必要はありません。

1. **お問い合わせを開く**

   エラーの下にある「解決しない場合はお問い合わせ」を押します。エラーが出ていないときは、画面左下のアカウント名を押し、「ヘルプ」から「お問い合わせ」を開きます。

2. **内容を書く**

   「お問い合わせ内容」に、気づいたことや試したことを書きます。画面、表示されたメッセージ、参照番号は「一緒に送る情報」に表示され、そのまま当社に届きます。

3. **「送信する」を押す**

   「お問い合わせを受け付けました」と表示され、確認のメールが届きます。

![お問い合わせの画面。お問い合わせ内容を書く欄と、送信するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/help-form-desktop.webp)
*お問い合わせの画面。*

平日10:00〜18:00（日本時間）に確認し、翌営業日までにお返事いたします。返信は、ログインに使ったアカウントのメールアドレスに届きます。アカウントにメールアドレスがないときは、返信先を入力する欄が表示されます。

「送信できませんでした。もう一度お試しください。」と表示されたときは、「メールアプリで送る」から、同じ内容をメールで送れます。ログインできないときは、hello@vibebooking.ai にメールでご連絡ください。

# よくある質問

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

## VibeBooking について

### VibeBooking とは何ですか？

宿泊施設の情報を、AI が読める形で公開するサービスです。料金と空室は予約システム（Beds24 か Channex）から読み取り、公開する内容はコンソールで確かめます（[コンソールでできること](https://docs.vibebooking.ai/getting-started#what-the-console-is-for)）。

### どの言語で使えますか？

コンソールとこのドキュメントは、日本語と英語で表示できます。英語のコンソールは [console.vibebooking.ai/en](https://console.vibebooking.ai/en) です。

コンソールの言語は、アカウント名を押して開くメニューの「表示言語」で切り替えます。

![アカウントのメニューを開いたところ。表示言語に、日本語とEnglishが並ぶ。](https://docs.vibebooking.ai/screenshots/ja/language-menu-desktop.webp)
*アカウントのメニュー。表示言語から、日本語とEnglishを選べる。*

### 読み取ったデータは何に使われますか？

予約システムから読み取った料金は、「公開する」を押した施設のページに載ります。AI は、そのページを読みます。ページは、当社のドメインか、設定した [独自ドメイン](https://docs.vibebooking.ai/custom-domain) で配信されます。

## ログイン

### 誰でもログインできますか？

いいえ。現在は招待制で、当社からご案内したメールアドレスのアカウントだけがログインできます。ほかのアカウントでは「このアカウントではまだご利用いただけません。ご案内をお待ちください。」と表示されます（[ログインする](https://docs.vibebooking.ai/getting-started#sign-in)）。

### LINE でログインできないのはなぜですか？

LINE からは、コンソールにメールアドレスが届きません。招待制のあいだはメールアドレスで確認するため、LINE ではログインできません。Google でログインしてください（[ログインする](https://docs.vibebooking.ai/getting-started#sign-in)）。

## Beds24 との連携

### Beds24 の内容が書き換えられることはありますか？

ありません。VibeBooking が受け取るのは読み取りの権限だけで、Beds24 の内容は書き換えられません（[VibeBooking が読み取れる情報](https://docs.vibebooking.ai/connect-beds24#what-vibebooking-reads)）。

### Beds24 から何を読み取りますか？

施設と部屋タイプの一覧、料金と空室、基本の予約情報です。宿泊者の氏名、連絡先、支払いの情報は読み取りません（[VibeBooking が読み取れる情報](https://docs.vibebooking.ai/connect-beds24#what-vibebooking-reads)）。

### 連携を解除するには？

「施設」の「連携」タブで、Beds24 のカードにある「連携を解除する」を押します。料金の取得が止まり、VibeBooking の権限は Beds24 の側でも取り消されます。公開中のページは残りますが、料金は表示されなくなります。操作は、連携したときと同じ端末で行います（[連携を解除する](https://docs.vibebooking.ai/connect-beds24#disconnect)）。

## 公開とレポート

### 連携すると、すぐに公開されますか？

いいえ。紐づけた施設は「プレビュー」になり、まだ公開されません。AI が読めるのは、「公開する」を押した施設だけです（[公開する](https://docs.vibebooking.ai/go-live#go-live)）。

### 公開をやめるには？

施設の「設定」タブで「非公開に戻す」を押します。施設は「プレビュー」に戻り、AI は読めなくなります（[公開をやめる](https://docs.vibebooking.ai/go-live#back-to-preview)）。

### 独自ドメインは必要ですか？

必要ありません。設定しない場合、ページは当社のドメインで配信されます（[独自ドメインで配信する](https://docs.vibebooking.ai/custom-domain)）。

### 公開したのに、読まれた回数が 0 のままです

AI が公開したページを初めて読むまで、数日から数週間かかります。施設のサイトからリンクすると、見つけてもらいやすくなります（[まだ読まれていないとき](https://docs.vibebooking.ai/report#no-reads-yet)）。

### 表示されない数字があるのはなぜですか？

見られる数字は、プランによって変わります。見られない項目には、鍵のマークと、その数字が見られるプランの名前が出ます（[レポートを見る](https://docs.vibebooking.ai/report)）。

# サイトコントローラー・PMS との連携

> **ご利用いただけるプラン**
>
> このページの機能は、すべてのプランでご利用いただけます。

VibeBooking は、貴社システムから施設の部屋タイプ・料金・在庫を取得し、AI アシスタント経由の予約を貴社システムに登録します。貴社の API に合わせたアダプター（接続部分）は、当社が作ります。

## 貴社システムに求める機能

| 機能 | 求める内容 |
| --- | --- |
| 部屋タイプ・料金・在庫の取得 | 料金プラン、日別の料金と在庫、最低泊数、チェックイン・チェックアウトの制限（CTA・CTD） |
| 予約の登録 | 1 回の宿泊を 1 件の予約として登録し、予約 ID を返す。当社の予約番号を予約に保持する |
| 受付不可と無応答の区別 | 受け付けられない予約には、明確なエラーを返す |
| 当社予約番号での検索 | 当社の予約番号で予約を検索できる |
| 予約 ID での照会 | 予約の有無、キャンセル済みかどうか、当社の予約番号を返す |
| 予約のキャンセル | 予約 ID でキャンセルできる。キャンセル済みの予約への再送もエラーにしない |
| キャンセル・変更時の在庫戻し | 在庫が自動で戻る設定かどうかを取得できる。戻らない施設の予約は、当社が受け付けない |
| 支払方法の記録 | 事前決済か現地払いか、決済済みの金額を記録できる |

タイムアウトとサーバーエラーは、予約が登録された可能性があるものとして扱います。

### 予約が入るまでの流れ

```mermaid
sequenceDiagram
    autonumber
    participant G as 宿泊者・AI アシスタント
    participant V as VibeBooking
    participant S as Stripe（施設のアカウント）
    participant P as 貴社システム
    G->>V: 予約を申し込む
    V->>P: 最新の料金と在庫を確認
    V->>S: カードの与信を取る
    V->>P: 予約を登録（当社の予約番号つき）
    P-->>V: 予約 ID
    V->>S: 売上を確定
    V-->>G: 予約確定のメール
```

### 決済

決済の主体は施設で、代金は施設ご自身の Stripe アカウントに入ります。当社は代金を預からず、手数料もいただきません。貴社システムに登録できなかった予約は、与信を取り消し、請求しません。

## 当社側で担保すること

- すべての API 呼び出しは冪等です。再送しても結果は変わりません。
- 同じ予約を二重に登録しません。
- 決済に失敗した予約は、貴社システム上でもキャンセルします。
- 予約データを定期的に突合し、差異があればお知らせします。
- 宿泊者情報は予約専用のデータベースにのみ保存し、貴社には必要な項目だけを送ります。

貴社システムから応答がないときは、次のように処理します。

```mermaid
sequenceDiagram
    participant V as VibeBooking
    participant P as 貴社システム
    participant S as Stripe
    V-xP: 予約を登録
    Note over V,P: タイムアウト。再送しない
    V->>P: 当社の予約番号で検索
    alt 予約あり
        V->>S: 売上を確定
    else 予約なし
        V->>S: 与信を取り消す
    end
```

## 送信する予約データ

予約 1 件ごとに、当社から貴社システムへ次の項目を送ります。

| 項目 | 内容 |
| --- | --- |
| 当社の予約番号 | 例: `VB-ABC123`。検索・照会・キャンセルにも使います |
| 部屋タイプ、料金プラン | 貴社システムの ID |
| チェックイン日、チェックアウト日 |  |
| 人数 | 大人、子供 |
| 1 泊ごとの料金、通貨 | 合計を泊数で割った額。現地払いの宿泊税を含みます |
| 支払い | 事前決済: 決済済みの額と Stripe の決済 ID。合計との差額は現地で受け取ります。現地払い: 全額を現地で受け取ります |
| 代表者の氏名、メールアドレス、電話番号 |  |
| ふりがな | 漢字の氏名の方 |
| 海外在住 | 海外にお住まいの方。日本国籍の場合はその旨も |
| 国籍、旅券番号 | 日本に住所のない外国籍の方。旅館業法で宿泊者名簿に記載する項目です |
| 流入元 ID | どの AI 経由の予約かを示す当社の ID |

項目を受け取れる欄が貴社システムにないときは、備考に 1 行ずつ書きます。旅券の確認は、チェックイン時に施設が対面で行います。カード情報は送りません。

## API の方式

貴社の API がどの方式でも、必要であれば当社が貴社専用のアダプターを作ります。予約の仕組みはそのままで、貴社ごとに接続部分だけを足すつくりです。

| 方式 | 対応 |
| --- | --- |
| REST（JSON） | 実装済み（Channex、Beds24） |
| SOAP・XML over HTTPS | 貴社の仕様に合わせて実装します |
| TravelXML | 貴社の仕様に合わせて実装します |
| 認証 | API キー、リフレッシュトークン |
| 通信 | HTTPS のみ |

### OpenTravel との対応

当社は OpenTravel（OTA）のメッセージを標準ではやり取りしません。貴社の API が OTA の XML（`http://www.opentravel.org/OTA/2003/05`）を使うときは、`OTA_HotelResNotifRQ` で次のように送ります。要素名とコードは OpenTravel 2017B に基づきます。

| 送信する項目 | OpenTravel の要素 |
| --- | --- |
| 当社の予約番号 | `UniqueID`（`Type="14"`） |
| 部屋タイプ、料金プラン | `RoomType@RoomTypeCode`、`RatePlan@RatePlanCode` |
| チェックイン日、チェックアウト日 | `TimeSpan@Start`、`TimeSpan@End` |
| 人数 | `GuestCount@AgeQualifyingCode`（大人 `10`、子供 `8`） |
| 1 泊ごとの料金、通貨 | `Rate/Base@AmountAfterTax`、`@CurrencyCode` |
| 支払い | `Guarantee@GuaranteeType`（事前決済は `PrePay`、現地払いは `None`）。決済済みの額は `DepositPayments` |
| 代表者の氏名、メールアドレス、電話番号 | `Customer` の `PersonName`、`Email`、`Telephone` |
| 国籍、旅券番号 | `CitizenCountryName`、`Document`（`DocType="2"`） |
| ふりがな、海外在住 | 対応する要素がないため、`ResGlobalInfo/Comments` に書きます |
| 流入元 ID | `POS/Source/BookingChannel` |
| キャンセル | `ResStatus="Cancel"` |

カード情報（`PaymentCard`）は送りません。

## 対応済みのシステム

### Channex

| 機能 | Channex での対応 |
| --- | --- |
| 取得 | 部屋タイプ、料金プラン、在庫、販売制限 |
| 予約の登録 | Booking CRS の `POST /bookings`（ステータス `new`、`ota_name` は `Offline`） |
| 当社予約番号の保持 | `ota_reservation_code` と `meta` |
| 当社予約番号での検索 | 予約一覧を当社の予約番号で照合 |
| 予約 ID での照会 | `GET /bookings/:id` |
| 予約のキャンセル | `PUT /bookings/:id`（ステータス `cancelled`） |
| 在庫戻し | `allow_availability_autoupdate_on_cancellation` と `allow_availability_autoupdate_on_modification` が両方オン |
| 事前決済 | `payment_collect` は `ota`、決済額はデポジットとして記録 |
| 現地払い | `payment_collect` は `property` |

ふりがなと宿泊者名簿の項目は、フロントで読めるよう、予約の備考（`notes`）に日本語で 1 行ずつ書きます。

| 宿泊者情報 | Channex での記録先 |
| --- | --- |
| 氏名 | `customer` の姓・名と、部屋ごとの宿泊者（`guests`） |
| メールアドレス、電話番号 | `customer` の `mail`、`phone` |
| ふりがな | 備考 `ふりがな: …` |
| 海外在住 | 備考 `居住: 海外`、日本国籍の方は `居住: 海外（日本国籍）` |
| 国籍 | 備考 `国籍: …` |
| 旅券番号 | 備考 `旅券番号: …` |
| テスト予約 | 備考の先頭に `[TEST]` |

- Channex に Booking CRS アプリをインストールしておく必要があります。
- 在庫を戻す設定は初期状態でオフです。施設が Channex でオンにします。
- API は非同期のため、登録直後の照会で 404 が返ることがあります。当社はこれを予約なしとは判断しません。

### 施設側の接続

施設は VibeBooking のコンソールで Channex の API キーを貼り付けて連携します。連携すると、「施設」の「連携」に Channex が表示されます。

![Channexと連携する画面。APIキーを貼り付ける欄と連携するボタンがある。](https://docs.vibebooking.ai/screenshots/ja/channex-key-desktop.webp)
*API キーを貼り付けて連携する画面。*

![施設の連携タブ。Channexと連携済みの表示が出ている。](https://docs.vibebooking.ai/screenshots/ja/channex-connected-desktop.webp)
*連携後の「連携」。*

## お問い合わせ

連携をご検討の事業者様は、hello@vibebooking.ai までご連絡ください。

# VibeBooking Docs

The VibeBooking console is where you publish your property's details in a form AI agents can read. New here? Start with [Getting started](https://docs.vibebooking.ai/en/getting-started).

## Reading these docs from an AI agent

Add `.md` to any page's URL to get it as Markdown, or request the page with `Accept: text/markdown`.

```sh
curl https://docs.vibebooking.ai/en/getting-started.md
```

| URL | What it holds |
| --- | --- |
| [/llms.txt](https://docs.vibebooking.ai/llms.txt) | A list of every page, Japanese and English |
| [/llms-full.txt](https://docs.vibebooking.ai/llms-full.txt) | The text of every page, Japanese and English |
| [/llms-full.en.txt](https://docs.vibebooking.ai/llms-full.en.txt) | The English pages only |
| [/llms-full.ja.txt](https://docs.vibebooking.ai/llms-full.ja.txt) | The Japanese pages only |

What an assistant can do for you, and what stays with you, is in [What AI assistants can and cannot do](https://docs.vibebooking.ai/en/ai-assistants).

# Getting started

> **Plans**
>
> Everything on this page is available on every plan.

## What the console is for

The console is where you publish your property's details for AI agents to read. In it you:

- add your property's website (**Add a property**)
- connect your reservation system so rates and availability can be read (**Connect a reservation system**; see [Beds24](https://docs.vibebooking.ai/en/connect-beds24) or [Channex](https://docs.vibebooking.ai/en/connect-channex))
- check what will be listed on the **Facts** and **Preview** tabs, then press **Go live** (see [Go live](https://docs.vibebooking.ai/en/go-live#go-live))
- once live, see on **Home** how often AI read your pages (see [Read the report](https://docs.vibebooking.ai/en/report))

## Sign in

![The console sign in screen, with Continue with LINE and Continue with Google buttons.](https://docs.vibebooking.ai/screenshots/en/sign-in-desktop.webp)
*The sign in screen. Only an invited account can sign in.*

1. **Open the console**

   Go to [console.vibebooking.ai/en](https://console.vibebooking.ai/en). You land on **Sign in**. There is no password.

2. **Choose an account**

   Press **Continue with LINE** or **Continue with Google** and sign in with the account you already use.

3. **Your account is created**

   The first time you sign in, the console creates your account and opens **Home**. You are its **Owner**. If you came from an invitation link, you see **Invitation to VibeBooking** instead (see [If you were invited](https://docs.vibebooking.ai/en/getting-started#accept)).

## Invite someone

Invite the people you work with by email. Only the **Owner** can invite. Anyone else who opens **People** sees "The owner manages people."

1. **Open People**

   Press **People** in the menu.

2. **Enter an address and a role**

   Under **Invite someone**, fill in their **Email address** and pick a **Role**.

3. **Send the invitation**

   Press **Send the invitation**. They receive an email with the subject "You're invited to VibeBooking". The invitation works for 7 days. Right after sending, **Revoke** on the same screen takes it back.

![The invite someone form, with fields for an email address and a role.](https://docs.vibebooking.ai/screenshots/en/people-invite-desktop.webp)
*The invite someone form.*

What each role can do is below. An invitation offers **Manager** or **Viewer**.

| Role | What it can do |
| --- | --- |
| **Owner** | Everything, including paying, people and deleting the account. |
| **Manager** | Connect, go live, edit facts. Not people, not deleting the account. |
| **Viewer** | Sees everything, changes nothing. |

### If you were invited

1. **Open the link in the invitation email**

   Sign in, and **Invitation to VibeBooking** opens with the account and the role you are invited as.

2. **Press Accept**

   You join the account. To say no, press **Decline** instead.

![The invitation screen opened from the email link, with the role explained and Accept and Decline buttons.](https://docs.vibebooking.ai/screenshots/en/invitation-accept-desktop.webp)
*What the link in the invitation opens.*

A link older than 7 days no longer works. Ask the person who invited you to send a new one.

# What AI assistants can and cannot do

> **Plans**
>
> Everything on this page is available on every plan.

## What works today

Connect VibeBooking to ChatGPT or Claude and your assistant can help with these. [Connect an AI assistant](https://docs.vibebooking.ai/en/connect-assistant) has the steps.

- Check your site and find what AI cannot read on it
- Add your property's website, and link it to the reservation system you have connected
- Draft your property's details from your site, your reservation system or text you paste, and ask you to check them
- Draft details shared by all your properties
- Add room types by hand and match them to your reservation system's
- Set up a custom domain until its record takes effect. You choose the properties it serves
- Read your report, your connections and what to do next
- Read these docs and walk you through a task

Every page is also plain Markdown: add `.md` to its URL. [/llms.txt](https://docs.vibebooking.ai/llms.txt) lists every page.

```sh
curl https://docs.vibebooking.ai/en/connect-beds24.md
```

### An assistant only ever drafts

Anything an assistant writes about your property is saved as a draft, next to what is listed now. Nothing it writes is listed until you say so.

An assistant never publishes, approves or goes live. No setting changes that.

### The three things you do yourself

These three steps stay yours:

1. Create your account and allow the assistant to connect.
2. Connect your reservation system ([Beds24](https://docs.vibebooking.ai/en/connect-beds24), [Channex](https://docs.vibebooking.ai/en/connect-channex)).
3. Check the assistant's drafts, and publish them.

### Checking the drafts

When an assistant asks you to check its drafts, a notice arrives in your inbox and by email. However often it asks, you hear at most once an hour.

1. **Press Review them**

   **Review before publishing** opens, one draft to a card, each next to what is listed now.

2. **Choose the drafts to publish**

   Tick **Publish** on each draft that is right. Press **Edit** to change one first, or **Reject** to drop it.

3. **Press the publish button**

   The button names how many drafts go live, such as **Approve and publish 2**. Check the number, then press it.

![The Review before publishing screen, with each suggestion from an assistant beside what is live now.](https://docs.vibebooking.ai/screenshots/en/review-drafts-desktop.webp)
*Review before publishing: each suggestion sits beside what is live now.*

What you approve counts as your own words.

## An assistant should never guess

Your prices, cancellation terms, capacity and check-in times come from you or from your reservation system, nowhere else. These docs tell AI assistants not to guess anything they do not say.

If an answer does not look right, check it on the console's screens.

# Connect an AI assistant

> **Plans**
>
> Everything on this page is available on every plan.

Add VibeBooking's address to ChatGPT or Claude and your assistant can check your site and draft your property's details. You check the drafts and publish them yourself.

## Before you start

- No account yet? You do not need to make one first. When the assistant asks you to sign in, sign in with Google: the account is created with you as its **Owner**, and you go straight on to allow the connection. While the console is invitation-only, this works only for an email address we have contacted (see [Sign in](https://docs.vibebooking.ai/en/getting-started#sign-in)).
- Already in an account? Your role there is **Owner** or **Manager**. A **Viewer** cannot connect an assistant.

## Find the address

Open **Settings** and choose **Connected assistants**. **Set up with an AI assistant** shows the address to add, and **Copy the address** copies it.

```text
https://mcp.vibebooking.ai/mcp
```

![The Connected assistants tab, showing the address to add to an assistant and a Copy the address button.](https://docs.vibebooking.ai/screenshots/en/assistant-address-desktop.webp)
*The Connected assistants tab.*

## Add it to Claude

Any plan can add it: Free, Pro or Max. Free allows one custom connector.

1. **Open the connector settings**

   In Claude, open Settings and choose Connectors. Press Add, then Add custom connector.

2. **Enter the address**

   Enter a name (such as VibeBooking) and the address, and press Continue. Claude shows two sign-in options: leave both as they are and press Add.

3. **Connect**

   Press Connect. The console's confirmation page opens. Check it and press **Allow** (see [What to check before you allow it](https://docs.vibebooking.ai/en/connect-assistant#consent)).

## Add it to Claude Code

Add it from the terminal. No key is needed.

1. **Add it with a command**

   Run the command below. It adds the server to the project you are in; add `--scope user` to use it in every project.

   ```sh
   claude mcp add --transport http vibebooking \
     https://mcp.vibebooking.ai/mcp
   ```

2. **Sign in**

   In Claude Code, type `/mcp`, choose vibebooking and press Authenticate. The console's confirmation page opens in your browser. Check it and press **Allow** (see [What to check before you allow it](https://docs.vibebooking.ai/en/connect-assistant#consent)).

## Add it to ChatGPT

Plus, Pro, Business, Enterprise and Edu plans can add it, on the web. ChatGPT calls this developer mode.

1. **Turn on developer mode**

   In Settings, open Security and login and turn on Developer mode.

2. **Create the app**

   In the list of apps, press the plus button and create one with a name and the address.

3. **Allow the connection**

   The console's confirmation page opens. Check it and press **Allow** (see [What to check before you allow it](https://docs.vibebooking.ai/en/connect-assistant#consent)).

ChatGPT asks you to confirm each time before it drafts anything.

> **Note**
>
> Claude and ChatGPT rename their screens from time to time. If you cannot find one, check their help pages: [Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), [ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta).

## What to check before you allow it

The page asks "Let claude.ai connect to your account?", with the name of your assistant. Before you press **Allow**, check three things:

![The consent screen for connecting an assistant, listing where it connects, what it can do and which accounts.](https://docs.vibebooking.ai/screenshots/en/assistant-consent-desktop.webp)
*The confirmation page, opened from Claude.*

| On the page | What to check |
| --- | --- |
| **Connecting to** | You recognise the address. If not, press **Deny**. |
| **What it may do** | **Read and draft** is chosen to start with, and lets it draft your property's details. **Read only** reads and changes nothing. |
| **Accounts** | It can reach only the accounts ticked here. |

Whatever you choose, an assistant can only draft. Publishing and approving stay with you.

## After you connect

When your assistant drafts something and asks you to check it, a notice arrives in your inbox and by email. **Review them** shows the drafts, and you choose which ones go live. The steps are in [Checking the drafts](https://docs.vibebooking.ai/en/ai-assistants#review).

An assistant cannot connect your reservation system. Connect it yourself in the console, as [Beds24](https://docs.vibebooking.ai/en/connect-beds24) and [Channex](https://docs.vibebooking.ai/en/connect-channex) describe.

## API keys, for scripts

An assistant needs no key. Make one only for a script or an agency's tool.

1. **Open Developer**

   Open **Settings** in the menu and choose **Developer**.

2. **Fill in Create an API key**

   Enter a **Name**, pick when it **Expires after**, and choose read or write.

3. **Press Create**

   The key appears. It starts `vbk_` and is shown only this once: copy it and keep it somewhere safe.

![The Create an API key form, with name, access, accounts and expiry.](https://docs.vibebooking.ai/screenshots/en/api-key-create-desktop.webp)
*The Create an API key form.*

**Revoke** on a key stops it at once.

## Disconnect

In **Settings**, under **Connected assistants**, press **Disconnect** beside the assistant, or **Disconnect all** to remove every one. From that moment it can no longer act on this account.

# Connect Beds24

> **Plans**
>
> Everything on this page is available on every plan.

Once Beds24 is connected, VibeBooking can read your property list, rates and availability from it. You move between the console and Beds24's control panel to set it up.

## Before you start

Check two things:

- Your role in the console is **Owner** or **Manager**. A **Viewer** cannot connect.
- You can sign in to Beds24's control panel. The console notes: "It may ask for two-factor authentication. The owner should be the one at the keyboard."

### Add the website first

You enter each Beds24 property's website after connecting. You can also add it beforehand.

1. **Open Add a property**

   Press **Properties** in the menu and open **Add a property** on **All**. With no properties yet, it is already open.

2. **Enter the domain**

   Under **The property's website**, enter your site's domain, without `https://` or a path (for example `hana-kyoto.jp`).

3. **Press Add**

   The property joins the list. Its state is **Not connected**.

![The Add a property form, with a field for the property website and an Add button.](https://docs.vibebooking.ai/screenshots/en/add-property-desktop.webp)
*The Add a property form.*

## Connect

On **Properties** › **All**, press **Connect a reservation system** to open the **Integrations** tab. Under **Your reservation system**, press **Connect Beds24** to open the connect screen.

![The Connect Beds24 screen, with a field to paste the invite code and a Connect button.](https://docs.vibebooking.ai/screenshots/en/connect-wizard-desktop.webp)
*The connect screen, with a field to paste the invite code.*

1. **Open Beds24**

   Press **Make an invite code in Beds24**. Beds24's control panel opens in a new tab. The link already carries the three read permissions VibeBooking asks for.

2. **Make an invite code in Beds24**

   On the Beds24 screen, do this (the console shows the same two steps):

   1. In “Name for this token”, type a name you will recognise (e.g. VibeBooking)
   2. Press “Generate invite code”

   Copy the invite code you get. Beds24 explains invite codes in its own documentation, under [API V2](https://wiki.beds24.com/index.php/Category:API_V2).

3. **Paste the invite code**

   Go back to the console tab, paste it into **Invite code** and press **Connect**.

Once the code is confirmed, you land on **Beds24 is connected**. Link your properties to their websites there next: see [Link a property](https://docs.vibebooking.ai/en/go-live#link).

![The table for linking Beds24 properties to their websites.](https://docs.vibebooking.ai/screenshots/en/connect-linking-desktop.webp)
*The table for linking Beds24 properties to their websites.*

## What VibeBooking can read

VibeBooking asks for these three read permissions and nothing else. It never changes anything in Beds24.

| Permission | What it reads | What it is used for |
| --- | --- | --- |
| Properties | Your properties and room types in Beds24 | Linking them to your websites |
| Rates and availability | The rate for given dates and guests, and which rooms are free | Filling **What does a night cost for my dates and party?** on a property's **Facts** tab |
| Bookings | Basic booking records only | Counting **Bookings we could measure** in the report |

VibeBooking does not ask for permission to read guest names, contact details or payment details. Beds24 defines the permissions in its [API reference](https://beds24.com/api/v2).

Only the properties you take live with **Go live** are published for AI agents (see [Go live](https://docs.vibebooking.ai/en/go-live#go-live)).

## When it does not work

### The invite code is not accepted

If, after you press **Connect**, the console says "That code is wrong or already used. Make a new one in Beds24 and paste it here.", check these in order:

1. Is there a space inside the code? Spaces around it are removed, but a space in the middle stays.
2. Have you used this code before? A used code does not work again. Make a new one in Beds24.
3. Wait a moment, then press **Connect** again.

### A permission is missing

"This invite code cannot read everything we need. Make the invite code again in Beds24." means the code is missing one of the permissions VibeBooking asks for. Open Beds24 again from **Make an invite code in Beds24** and make a new invite code. Beds24's documentation on permissions is under [API V2](https://wiki.beds24.com/index.php/Category:API_V2).

## Disconnect

An **Owner** or a **Manager** can disconnect.

1. **Open the Integrations tab**

   Press **Properties** in the menu, then the **Integrations** tab.

2. **Press Disconnect**

   On the **Beds24** card, press **Disconnect**.

3. **Confirm**

   The console asks **Disconnect Beds24?** Press **Disconnect**. The card then says "Disconnected."

![The Beds24 card on the Integrations tab, with Review the links and Disconnect buttons.](https://docs.vibebooking.ai/screenshots/en/connection-beds24-desktop.webp)
*The Beds24 card on the Integrations tab.*

When you disconnect:

- Reading rates and availability stops. VibeBooking also revokes the access it was given, at Beds24 itself, and reads nothing more from it.
- Live pages stay up, but no longer show rates. To take a property off, see [Stop being live](https://docs.vibebooking.ai/en/go-live#back-to-preview).
- Nothing is deleted.

If the console says "That did not work. Try again.", the connection is still in place. Start again from **Disconnect**.

### When the connection's details are not there

The **Beds24** card may show only how many properties are linked, with no **Disconnect** button. The connection is remembered by the browser that made it. Sign in on the same device and browser, and **Disconnect** appears. Clearing that browser's data has the same effect.

### Revoke it in Beds24

Without the device that made the connection, you can revoke VibeBooking's access in Beds24's control panel. Beds24's documentation, under [API V2](https://wiki.beds24.com/index.php/Category:API_V2), says where.

# Connect Channex

> **Plans**
>
> Everything on this page is available on every plan.

Once Channex is connected, VibeBooking can read your properties, rates and availability from it. You make one API key in Channex and paste it into the console. It takes about two minutes.

## Before you start

Check two things:

- Your role in the console is **Owner** or **Manager**. A **Viewer** cannot connect.
- You can sign in to Channex and make an API key there.

Channex does not tell us the address of the page where guests book. If you use a booking engine, have its booking page's address ready. You can also add it later ([Add your booking page](https://docs.vibebooking.ai/en/connect-channex#booking-page)).

## Connect

On **Properties** › **All**, press **Connect a reservation system** to open the **Integrations** tab. Under **Your reservation system**, press **Connect Channex**.

![The Connect Channex screen, with fields for the API key and the booking page URL and a Connect button.](https://docs.vibebooking.ai/screenshots/en/connect-channex-wizard-desktop.webp)
*Paste the API key here, and your booking page if you have one.*

1. **Open the API key settings in Channex**

   Press **Open the API key settings in Channex**. Channex's API key settings open in a new tab.

2. **Make an API key in Channex**

   Follow what the console lists:

   1. "Name the key something you will recognise (e.g. VibeBooking)"
   2. "Copy the key it shows you"

3. **Paste the API key**

   Go back to the console tab and paste it into **API key**. Spaces before or after it are fine.

4. **Enter your booking page**

   In **Your booking page (recommended)**, enter the address of your booking engine's page. You can connect with it empty.

5. **Press Connect**

   Once the key checks out, the screen moves on to "Channex is connected".

On that screen, link each Channex property to your website next. The steps are in [Link a property](https://docs.vibebooking.ai/en/go-live#link). If you did not enter a booking page, the screen says "No booking page yet. Agents have no booking link to give guests."

## Add your booking page

Agents send guests to the page you enter here. You can take a property live without one, but agents then have no booking link to give guests.

1. **Open the Integrations tab**

   Press **Properties** in the menu, then the **Integrations** tab.

2. **Enter the address**

   Under **Booking page** on the Channex card, enter the address of your booking engine's page.

3. **Press Save**

   The screen says "Booking page saved."

![The Channex card on the Integrations tab, with a field for the booking page URL and a Save button.](https://docs.vibebooking.ai/screenshots/en/connection-channex-desktop.webp)
*The Channex card on the Integrations tab, where the booking page goes.*

The address has to start with `https://` and be your own booking engine's page. A booking site's page, such as Rakuten Travel or Booking.com, cannot be used. To remove it, empty the field and press **Save**: the screen says "Booking page removed."

If your booking engine is on a different domain from your property's website, the screen says "This is not on your website's domain. That is fine if your booking engine lives on another one." If it is your booking engine's page, leave it as it is.

## Choose your VibeBooking channel

This is how bookings that come in through VibeBooking links get counted. You create one booking page (a channel) in Channex just for VibeBooking, then choose it under **VibeBooking channel** on the Channex card. Bookings made on that channel count as bookings through VibeBooking. They are counted for the channel as a whole, not per AI.

Until you set it, the card says "Not set, so bookings through VibeBooking are not counted yet."

1. **Create the channel in Channex**

   In Channex, create one channel just for VibeBooking. Put "VibeBooking" in its name and the console selects it for you. Until you have one, the card shows **Create the booking page in Channex**, which opens Channex's channels page.

2. **Choose it**

   Back on the **Integrations** tab, choose your channel from the **VibeBooking channel** list. If its name has "VibeBooking" in it, the card says "The channel named VibeBooking is selected. Save to confirm it." Channels for booking sites such as Booking.com are left out of the list.

3. **Press Save**

   The screen says "Channel ID saved."

If your channel is not in the list, open **Not in the list? Paste its ID**, open the channel in Channex, paste the address from your browser's address bar, and press **Save**. If the console could not read your channels, the field is called **Your VibeBooking channel ID** instead; paste the address there the same way.

Only an **Owner** or a **Manager** can change it.

## What VibeBooking reads

With the API key, VibeBooking reads your properties, rates and availability from Channex. It never changes anything in Channex.

Only the properties you take live are published for AI agents ([Go live](https://docs.vibebooking.ai/en/go-live#go-live)).

## When it does not work

### The key is not confirmed

If, after you press **Connect**, you see "Not confirmed. The key may be mistyped, or Channex could not be reached just now. Paste it again, or try again in a moment.", check these in order:

1. You copied the whole key. It is a long string, and copying can cut it short. Copy it again from Channex.
2. You did not paste a different key.
3. Wait a moment and press **Connect** again.

### A permission is missing

If you see "This key cannot read everything we need. Make the API key again in Channex.", open Channex again from **Open the API key settings in Channex**, make a new key and paste it.

### The booking page address is refused

A refused address shows one of these:

| Message | Why, and what to do |
| --- | --- |
| "Use an address that starts with https://." | An `http://` address cannot be used. Enter your booking engine's `https://` page. |
| "A booking site cannot be your booking page. Enter your own booking engine's address." | It is a page on a booking site such as Rakuten Travel or Booking.com. Enter the page of the booking engine your property uses. |
| "That is a VibeBooking address. Enter your own booking page." | Enter your booking engine's page instead. |
| "Take the user name and password out of the address." | The address contains a sign-in name or password. Remove them and enter it again. |
| "Check the address, for example https://book.example.jp/" | It could not be read as an address. Copy it again from your browser's address bar. |

## Disconnect

Only an **Owner** or a **Manager** can disconnect.

1. **Open the Integrations tab**

   Press **Properties** in the menu, then the **Integrations** tab.

2. **Press Disconnect**

   Press **Disconnect** on the Channex card.

3. **Confirm**

   You are asked "Disconnect Channex?". Press **Disconnect**, and the screen says "Disconnected."

4. **Delete the API key in Channex**

   Channex is not told when you disconnect. In Channex's API key settings, delete the key you made for VibeBooking.

When you disconnect:

- Reading rates and availability stops.
- Live pages stay up, but no longer show rates. To take a property off, see [Stop being live](https://docs.vibebooking.ai/en/go-live#back-to-preview).
- Nothing is deleted.

If you see "That did not work. Try again.", the connection is still there. Start again from **Disconnect**.

# The traveller connector

> **Plans**
>
> Everything on this page is available on every plan.

Travellers' assistants find your property through a second MCP server, vibebook. It is not the one you add to your own assistant ([Connect an AI assistant](https://docs.vibebooking.ai/en/connect-assistant)): that one manages your account and needs you to sign in. vibebook only reads what you have published, and anyone can add it.

## The two addresses

| Address | For | Sign-in |
| --- | --- | --- |
| `https://vibebook.vibebooking.ai/mcp` | A traveller's assistant: find a stay, read rates, get the booking link | None |
| `https://mcp.vibebooking.ai/mcp` | You and your assistant: check your site, draft your property's details | Yes, see [Connect an AI assistant](https://docs.vibebooking.ai/en/connect-assistant) |

vibebook is listed in the official MCP Registry as `ai.vibebooking/vibebook`. Its server card is at `https://vibebook.vibebooking.ai/.well-known/mcp/server-card.json`.

## What it can do

| Tool | What it answers |
| --- | --- |
| `search_hotels` | Live properties in an area, such as 京都市東山区 or Gion |
| `resolve_hotel` | Whether a website is a VibeBooking property, from its domain |
| `get_hotel` | A property's published details and room types |
| `get_rates` | Live rates for a stay, each with its total, cancellation terms and a booking link |
| `book_link` | The link to your booking page for a stay, or for one offer from `get_rates` |

Every tool only reads. Nothing is booked, held or paid through vibebook: the booking link opens your own booking page, checks the price again, and the traveller books and pays there.

## Which properties it shows

Only properties that are live. A property you have not put live (see [Go live](https://docs.vibebooking.ai/en/go-live)) is not in its answers. What it says about yours is what you published.

## Add it to an assistant

Claude Code:

```sh
claude mcp add --transport http vibebook \
  https://vibebook.vibebooking.ai/mcp
```

In Claude or ChatGPT, add the same address as a custom connector or app, as on [Connect an AI assistant](https://docs.vibebooking.ai/en/connect-assistant#claude), and skip the sign-in: there is none.

# Go live

> **Plans**
>
> Everything on this page is available on every plan.

A property's state shows in the list on **Properties** › **All**, and next to its name on its own screen.

| State | What it means |
| --- | --- |
| **Not connected** | Not linked to a property in your reservation system yet. |
| **Preview** | Linked, but not live yet. |
| **Live** | AI agents can read it. |
| **Demo (hidden from AI)** | Set as a demonstration on the **Settings** tab. Even when live, AI does not see it. |

## Link a property

Once your reservation system is confirmed, the console opens a screen such as **Beds24 is connected**. The **Properties in Beds24** table lists the properties in your reservation system.

1. **Enter the website**

   In the **Website** column of each property you want to publish, enter that property's website. Websites you have added are offered as you type. A website not linked yet may already be filled in.

2. **Press Prepare**

   The website is saved and the property's **Facts** tab opens. The property moves to **Preview**. Nothing goes live yet.

![The table for linking Beds24 properties to their websites.](https://docs.vibebooking.ai/screenshots/en/connect-linking-desktop.webp)
*The properties in your booking system, one row each, with a website to enter.*

**See your properties** takes you to **Properties** › **All**. To come back to this screen later, press **Review the links** on the integrations tab of **Properties**.

If you press **Prepare** with no website entered, the row says "Enter this property's website first." Entries with no room count are listed apart, under **Other entries**. A day-use plan or a test entry needs no link.

## Check the facts

In **Properties** › **All**, press a property to open it. It has three tabs, **Facts**, **Preview** and **Settings**, and opens on **Facts**. Above the tabs are the property's state and how many facts are left before it can go live.

Under **Required to be listed**, the **Facts** tab lists the six facts a property needs before it can go live. As the tab says, "Six facts are needed to go live. Agents see exactly what you save here."

### Let them fill in themselves

Most of the six fill in without typing. We recommend this order:

1. From your reservation system and your website: when you open the property, whatever we could read is already in, with a line such as "4 fields filled in from your website and booking system." A fact read from your site is marked **From your website**, with the page it came from.
2. With **Fill in from text or a file**: paste a brochure, a booking site's description or an email draft, or add a file (PDF, Word, Excel or text). AI reads it and fills the empty facts; where a fact already has a value, the one from your text is offered as a choice. What you paste is not kept.
3. From your AI assistant: once you [connect an assistant](https://docs.vibebooking.ai/en/connect-assistant), it can draft the facts for you. You check them before they go live (see [Checking the drafts](https://docs.vibebooking.ai/en/ai-assistants#review)).

Nothing is listed until you save it. Type in only what is left.

| Fact | Typing it in |
| --- | --- |
| **What does a night cost for my dates and party?** | From your reservation system. Nothing to enter. |
| **Check-in from / check-out by?** | Pick from a list. |
| **Can I cancel? Free until when, what penalty, no-show charge?** | Pick how many days before from a list, then enter the fee as a percentage. |
| **Where exactly is it? (postal address)** | Type it in. |
| **How far is it from the nearest station / airport, and how do I get there?** | Type it in. |
| **How many people can stay in a room (adults / children)?** | Type it in. |

Check-in and check-out, and the cancellation policy, can be entered once for every property. On the **Defaults** tab of **Properties**, fill in **Defaults for all properties** and press **Save for all properties**.

### Check and save

1. **Check what is there**

   Correct anything that is wrong.

2. **Save**

   While something is unsaved, a button such as **Save 7 changes** shows at the bottom of the screen. Press it. Once all six are in, the screen says "6 saved. All six facts are in.", with **Go live** beside it.

![A property's Facts tab: the items required to be listed, filled in from the booking system, and the save button.](https://docs.vibebooking.ai/screenshots/en/go-live-facts-desktop.webp)
*Required to be listed, on the Facts tab. Anything unsaved brings up the save button below.*

A saved fact says **Saved**. To change one, press **Edit**.

## Check the preview

The **Preview** tab shows what AI is told.

| On the tab | What it is |
| --- | --- |
| **What AI is told** | What AI uses to answer a traveller about this property. A fact not filled in yet says **Not filled in**. |
| **The page AI reads (English)** | The page AI actually reads. **Open in a new tab** opens it in a tab of its own. |

![A property's Preview tab, showing what AI is told and the Go live button.](https://docs.vibebooking.ai/screenshots/en/go-live-preview-desktop.webp)
*The Preview tab, with what AI is told.*

An **Owner** or a **Manager** also sees **Share a preview link**. That link opens without signing in, until the date shown. Use it to show the page to your web person or a partner.

## Go live

Only an **Owner** or a **Manager** can go live. **Go live** sits at the top of the property's screen, on every tab. The line beside it depends on the property:

| It says | What to do |
| --- | --- |
| "Connect a reservation system first." | The property is not linked yet. Connect your reservation system ([Beds24](https://docs.vibebooking.ai/en/connect-beds24), [Channex](https://docs.vibebooking.ai/en/connect-channex)). |
| A line such as "2 more to fill in before going live." | Fill in the missing facts on the **Facts** tab. |
| "Ready to go live: all six facts are in." | You can go live. |

1. **Press Go live**

   With all six facts in, press **Go live**.

2. **Check the result**

   The screen says "Live. AI can read this page now." and the property's state becomes **Live**. The address of the page agents read shows too.

### Stop being live

On the **Settings** tab, under **Stop serving it**, press **Back to preview**. The property goes back to **Preview**, and AI agents can no longer read it. Its facts and preview stay, so you can go live again at any time.

# Link from your site

> **Plans**
>
> Everything on this page is available on every plan.

A link from your property's site helps AI find your live page.

## Where the link points

The link points at the address your live page is served from, which is one of these:

| Served from | The link |
| --- | --- |
| Our domain | `https://vibebooking.ai/hotels/…`. Nothing to set up. |
| Your own domain | A subdomain of your property's site, such as `https://agents.hana-kyoto.jp/hotels/…`. Needs [Serve on your own domain](https://docs.vibebooking.ai/en/custom-domain). |

Once your own domain is ready, the snippets under **Link from your site** switch to it. If you already added a link with our domain, replace it.

## Add the link

Once the property is live, the **Preview** tab shows **Link from your site**. It says "Any of the three is enough. We check on the next scan." and lists three snippets:

- **A link for your site's footer**
- **A line for your site's robots.txt**
- **A line for your site's llms.txt**

![A live property's Preview tab, showing the Link from your site snippets.](https://docs.vibebooking.ai/screenshots/en/go-live-publish-desktop.webp)
*A live property's Preview tab, with the Link from your site snippets.*

1. **Press Copy**

   Press **Copy** under the snippet you want, and add it to your property's site.

2. **Press I've added it**

   Open **Getting found by AI** on the **Facts** tab and press **I've added it**.

# Take bookings on your booking pages

> **Plans**
>
> Available on Standard and Pro. On Free the console shows that these are there, but you need Standard or higher to use them.

A guest who follows your booking link from an AI answer lands on your current booking page today. Finish the items on the **Booking pages** tab and you can send that link to VibeBooking's booking pages instead, in your logo and colour.

> **Note: Test mode for now**
>
> Card payments go through Stripe's test mode, so no real bookings or payments are made.

## Before you start

- It's for properties on Channex. [Connect Channex](https://docs.vibebooking.ai/en/connect-channex) first.
- An **Owner** or a **Manager** sets it up.
- On Free, the tab says **Available on Standard**.

## Open the setup

Open the property and its **Booking pages** tab. **Before you take bookings** is at the top, with a count such as "1 of 6 done".

![Before you take bookings on the Booking pages tab: the payment options, and the list of items still to do.](https://docs.vibebooking.ai/screenshots/en/engine-setup-desktop.webp)
*Before you take bookings, at the start. Items already done are ticked.*

## Choose how guests pay

Under **How guests pay**, choose one or both, then click **Save payment options**.

| Option | When guests pay | Stripe account |
| --- | --- | --- |
| **Pay by card when booking** | As they book, by card | Needed |
| **Pay at the property** | At check-in, to you | Not needed |

**Pay by card when booking** unlocks once you [set up Stripe](https://docs.vibebooking.ai/en/booking-engine#stripe).

![How guests pay: checkboxes for card payment when booking and payment at the property, and a save button.](https://docs.vibebooking.ai/screenshots/en/engine-modes-desktop.webp)
*Card payment chosen and saved.*

## Set up Stripe

Card payments go to your own Stripe account, and guests see your name on their statements. Your VibeBooking account has one Stripe account, shared by all its properties.

1. **Click Set up Stripe**

   A Stripe account is created for your property, and Stripe's sign up pages open.

2. **Sign up on Stripe**

   The business itself enters its details, its representative's identity and the bank account for payouts. Stripe receives them; VibeBooking never sees them.

3. **Come back**

   When you finish, Stripe sends you back to the **Booking pages** tab.

If Stripe still needs something, **Continue on Stripe** picks up where you left off. Stripe's review can take a few days.

## Work through the checklist

**Before you take bookings** has six items. Each one not yet done says what it's waiting for.

![The list of items before taking bookings, the finished ones ticked and the statement name still to check.](https://docs.vibebooking.ai/screenshots/en/engine-checklist-desktop.webp)
*Done up to the test booking. The statement name is left.*

| Item | How to finish it |
| --- | --- |
| Card payments on Stripe | Finish [Set up Stripe](https://docs.vibebooking.ai/en/booking-engine#stripe). Not needed for **Pay at the property** alone. |
| Bookings reach your reservation system | If you see "Your reservation system isn't answering. Check its connection settings.", check that Channex's Booking CRS application is installed and your API key is still valid. |
| Cancelled rooms go back on sale | Turn on both of Channex's availability settings (off by default). [How VibeBooking works with your system](https://docs.vibebooking.ai/en/inventory-systems#channex) names them. |
| A test booking, made and cancelled | **Run a test booking** writes one booking to Channex and cancels it. If it fails, check the two items above and run it again. |
| Your name on guests' card statements | See [Your statement name](https://docs.vibebooking.ai/en/booking-engine#descriptor). Not needed for **Pay at the property** alone. |
| The six facts filled in, and live | See [Go live](https://docs.vibebooking.ai/en/go-live). |

### Your statement name

Compare **On card statements (Stripe)** with **On your checkout**. A statement name that looks nothing like your property's can make a guest dispute the charge. You can change it in your Stripe dashboard. When it's right, click **This name is fine**.

![The name on card statements at Stripe beside the name on your checkout, with a This name is fine button.](https://docs.vibebooking.ai/screenshots/en/engine-descriptor-desktop.webp)
*Compare the name at Stripe with the name on your checkout.*

If you change the name at Stripe later, check it again.

## Switch your booking link

Once every item is done, click **Send guests to this checkout**. From then on, guests who follow your booking link book on your booking pages.

![Where your booking link goes, with every item done and the Send guests to this checkout button ready to press.](https://docs.vibebooking.ai/screenshots/en/engine-ready-desktop.webp)
*Every item done, ready to switch.*

After the switch, your logo and colour settings sit at the top of the tab ([Brand your booking pages](https://docs.vibebooking.ai/en/checkout-brand)). To undo, click **Go back to your current booking page**.

![The booking link switched to this checkout, with a button to go back to your current booking page.](https://docs.vibebooking.ai/screenshots/en/engine-switched-desktop.webp)
*Switched. You can go back to your current booking page.*

### When it won't switch

If something changed after you opened the page, such as the statement name at Stripe, the switch is refused and names the items still to do. Finish them and click again.

![The switch refused, with the items still to do listed by name.](https://docs.vibebooking.ai/screenshots/en/engine-not-ready-desktop.webp)
*The items still to do, by name.*

## If your plan changes

If the property moves to Free, guests go to your current booking page again. Back on a plan with booking pages, they book on them again, with nothing to set up.

# Brand your booking pages

> **Plans**
>
> Available on Standard and Pro. On Free the console shows that these are there, but you need Standard or higher to use them.

You can put your logo and one colour on the pages where guests book. Leave both unset and the pages stay plain black and white.

## Before you start

- On Free, the **Booking pages** tab says **Available on Standard**, and **I'd like to use it** lets us know.
- An **Owner** or a **Manager** can change it. A **Viewer** sees it read-only.

## Set your logo and colour

Open the property and its **Booking pages** tab. The settings are on the left, under **Logo and colour on your booking pages**, and a live preview of your booking pages is on the right.

1. **Choose a logo**

   Upload one with **Choose a logo image** (PNG, JPEG or WebP), or pick one of the property's photos under **Or use one of your photos**.

2. **Choose a colour**

   Click the swatch under **Colour** and pick one.

3. **Check the preview**

   The preview follows your changes before you save. Switch pages with **Details**, **Review**, **Confirmed** and **Manage**, and width with **Desktop** and **Phone**.

4. **Click Save**

   You see "Saved. Guests see it on your booking pages too."

![The booking page logo and colour settings, with the logo and colour on the left and a preview of the booking page on the right.](https://docs.vibebooking.ai/screenshots/en/checkout-brand-desktop.webp)
*The logo and colour settings, and the live preview.*

| Setting | Where guests see it |
| --- | --- |
| Logo | At the top of every page, left of your property's name. |
| Colour | The buttons, the confirm booking button among them, and the progress bar. |

![The guest details page, showing the property logo and colour.](https://docs.vibebooking.ai/screenshots/en/checkout-details-desktop.webp)
*The guest details page with your logo and colour.*

To undo, click **Remove the logo** or **Use the default colour**, then **Save**.

## Colours that are too light

White text sits on your colour. If white text would be hard to read on the one you pick, you see "This colour is too light: white text on it is hard to read. Choose a darker one." and cannot save it.

The bar is a contrast ratio of 4.5:1 against white text (WCAG AA). Darker colours pass.

![The colour field with a light yellow chosen, and the message that it is too light for white text.](https://docs.vibebooking.ai/screenshots/en/checkout-brand-too-light-desktop.webp)
*A light yellow is refused: white text on it is hard to read.*

## Try your booking pages

**Try your booking pages** opens your booking pages in a new tab, exactly as a guest sees them, and lets you book right through. Pay with Stripe's test card `4242 4242 4242 4242`, any future expiry date and any three-digit security code.

Nothing about it is real:

|  | When you try it |
| --- | --- |
| Charges | None. |
| Reservation system | Nothing is written to it. |
| Bookings | None is kept. |
| Emails | The confirmation and the receipt go to your own email address, with `[PREVIEW]` at the start of the subject. |

![The Confirm booking button, in the property colour.](https://docs.vibebooking.ai/screenshots/en/checkout-confirm-desktop.webp)
*The final button wears your colour too.*

![The booking confirmed page, showing the property logo and colour.](https://docs.vibebooking.ai/screenshots/en/checkout-done-desktop.webp)
*The booking confirmed page. A try's booking number starts with PREVIEW.*

## Let your AI assistant suggest one

With your AI assistant connected ([Connect an AI assistant](https://docs.vibebooking.ai/en/connect-assistant)), it can suggest a logo and colour (the `draft_brand` tool). The **Booking pages** tab then shows "Your AI assistant suggested a logo and colour".

![A logo and colour suggested by an AI assistant, with Try the suggestion and Not now buttons.](https://docs.vibebooking.ai/screenshots/en/checkout-proposal-desktop.webp)
*A suggestion from your AI assistant.*

**Try the suggestion** puts it in the preview. Guests see nothing new until you click **Save**. **Not now** sets it aside.

# Serve on your own domain

> **Plans**
>
> Everything on this page is available on every plan.

Live pages are normally served on our domain. With your own domain set up, they are served on a subdomain of your property's site instead (for example `agents.hana-kyoto.jp`). You do not have to set one up.

## Before you start

Check three things:

- Your role in the console is **Owner** or **Manager**. A **Viewer** sees "Read-only. An owner or manager changes the domain."
- The name is a subdomain of your property's site. For a site at `hana-kyoto.jp`, that is a name like `agents.hana-kyoto.jp`. The site's own domain cannot be used.
- You can change your domain's DNS. If someone else looks after it, see [Ask your web person](https://docs.vibebooking.ai/en/custom-domain#web-person).

## Set it up

1. **Open the Your domain tab**

   Press **Properties** in the menu, then the **Your domain** tab.

2. **Enter a subdomain**

   Under **Set up your domain**, enter the name in **Subdomain to use** and press **Use this name**.

3. **Add the DNS record**

   **The record to add** shows a **Type**, a **Name** and a **Value (points to)**. In your DNS panel, add this one line exactly as shown. **Copy** copies all three at once.

4. **Wait for it to take effect**

   The heading moves from "Waiting for DNS" to "Certificate pending". When everything is ready it reads like "Ready: served on agents.hana-kyoto.jp". While the page is open, it checks again by itself. To check straight away, press **Check again**.

5. **Choose the properties**

   Under **Properties served on this domain**, press **Serve on this domain** for each property. A property served there shows **Served here**. **Stop serving** takes one off.

![A custom domain card, showing the DNS record to add and the properties served on the domain.](https://docs.vibebooking.ai/screenshots/en/custom-domain-record-desktop.webp)
*A custom domain just after it is set: the record to add, and the properties it serves.*

On Cloudflare, set the record's proxy status to "DNS only". While it is "Proxied", we cannot see the record and the setup does not move on. The screen shows the same note under the record.

## Ask your web person

If someone else looks after your DNS, press **Send to your web person**. It opens a page with the record in Japanese and English. Only someone signed in as a member of your account can open that page, so [invite them](https://docs.vibebooking.ai/en/getting-started#invite) first.

An [AI assistant](https://docs.vibebooking.ai/en/ai-assistants) can also add the domain and check its record for you. Choosing the properties it serves stays with you.

On that page, **Check** tells them whether the record has taken effect: "The record is in place." once it has, "Not seen yet." until then.

## What the status means

The heading on the domain screen tells you how far the setup has got. At every stage your pages are served: on our domain until everything is ready, and on yours after.

| Heading | What it means | What to do |
| --- | --- | --- |
| "Waiting for DNS" | We cannot see the record yet. This can take minutes or hours. | Once you have added the record, just wait. |
| "Certificate pending" | The record is in place. It moves on once the HTTPS certificate is issued. | Nothing. |
| "Ready: served on agents.hana-kyoto.jp" | Your pages are served on your domain. | Nothing. |
| A heading like "Your domain stopped pointing at VibeBooking on 9/25/2026" | It was working, and then we could no longer see the record. | See [When the record is gone](https://docs.vibebooking.ai/en/custom-domain#lapsed). |
| "The certificate has not been issued" | The record is in place, but the HTTPS certificate could not be issued. Your pages are still served on our domain. | See [When the certificate has not been issued](https://docs.vibebooking.ai/en/custom-domain#certificate-failed). |

## When it does not work

### You entered the site's own domain

If you see "Use a subdomain, such as agents.hana-kyoto.jp.", the name you entered is the site's own domain (`hana-kyoto.jp`). Put a name such as `agents.` in front of it, as in `agents.hana-kyoto.jp`, and try again.

### The name is used by another account

"That name is already used by another account." means another VibeBooking account has already set up the same name. Check whether someone at your company set it up in a different account. If not, use another name (for example `ai.hana-kyoto.jp`), or [contact us](https://docs.vibebooking.ai/en/custom-domain#contact).

### It stays at "Waiting for DNS"

If nothing changes after a few hours, check the record in your DNS panel, in this order:

1. The name is not doubled. Some DNS services want only the `agents` part in the **Name** field. Typing `agents.hana-kyoto.jp` there makes a different name, `agents.hana-kyoto.jp.hana-kyoto.jp`.
2. The type is CNAME, and the value matches **Value (points to)** exactly. Copying it with **Copy** is the safest way.
3. On Cloudflare, the proxy status is "DNS only".
4. No other record (an A record, for example) is left on the same name. If one is, you may not be able to add the CNAME, or we may not see it correctly.

Then press **Check again**.

### DNS could not be checked

"We could not check DNS. This is the last known state; we retry automatically." means our side could not check DNS just now. Nothing is wrong with your setup. The screen keeps the last known state and checks again by itself. Nothing to do.

### When the record is gone

A heading like "Your domain stopped pointing at VibeBooking on 9/25/2026" appears when we can no longer see a record that used to work. Check in your DNS panel whether the record was deleted or its value changed. Meanwhile your pages are served on our domain. Add the record shown under **The record to add** again, and it recovers by itself.

### When the certificate has not been issued

"The certificate has not been issued" appears when we can see your record but could not issue the HTTPS certificate for your own domain. Meanwhile your pages are served on our domain. Check these in order:

1. The record in your DNS panel matches **The record to add** on the screen.
2. Your domain has no CAA record limiting who may issue its certificates. If it has one, that can be the cause. If a web person set up your DNS, ask them to check.

Once it is right, serving on your domain starts on its own. We keep trying to issue the certificate too. If that does not solve it, [contact us](https://docs.vibebooking.ai/en/custom-domain#contact).

### A property cannot be served here

A line like "agents.hana-kyoto.jp is not under yado-nara.jp, so it cannot serve this property." means the property's site is on a different domain from the one this name is under. For example, `agents.hana-kyoto.jp` can only serve properties whose site is `hana-kyoto.jp`. For a property on another site, set up that site's subdomain as [another domain of your own](https://docs.vibebooking.ai/en/custom-domain#set-up).

### Something did not finish

These mean the work stopped on our side. Wait a moment and do the same thing again. If it keeps happening, [contact us](https://docs.vibebooking.ai/en/custom-domain#contact).

- "That did not save. Try again."
- "That did not change. Try again."
- "That did not work, so the domain is unchanged. Try again."

## Remove your domain

Once removed, your pages are served on our domain again. Only an **Owner** or a **Manager** can remove it.

1. **Press Remove this domain**

   Press it on the card of the domain you want to remove.

2. **Press Remove**

   You are asked something like "Remove agents.hana-kyoto.jp?". Press **Remove**, and the screen shows "Removed agents.hana-kyoto.jp".

3. **Delete the DNS record**

   In your DNS panel, delete the record you added. Any time after removing is fine.

## Contact us

If none of this solves it, press **Still stuck? Contact us** under the error. The screen and the reference go with it, so we can see which step went wrong. How to reach us with no error on screen, and when we reply, are in [Contact us](https://docs.vibebooking.ai/en/troubleshooting#contact).

# Read the report

> **Plans**
>
> - Reads and bookings we could measure: Available on every plan.
> - The period before, handoffs to your booking page, and records older than 90 days: Available on Standard and Pro.
> - Which AI read your pages and what AI looked up: Available on Standard and Pro. On Free the console shows that these are there, but you need Standard or higher to use them.

## On Home

**Times AI read your pages** on **Home** shows how often AI read your pages. The screen explains: "How often ChatGPT, Perplexity and the like read your property's pages. Only visits we confirmed really came from that AI are counted." It shows:

- **Reads**, against the period before
- **Handoffs to your booking page**
- **Bookings we could measure**
- a chart of the count over time (**Show as a table** shows the same figures as a table)
- **Which AI read your pages** and **What AI looked up**

**Period** and **Counted per** change what you see. With two or more properties, **Property** narrows it to one. Each property's count also shows under **AI reads (7 days)** in **Properties** › **All**.

![The figures on Home, with how often AI read your pages and a chart of how that changed.](https://docs.vibebooking.ai/screenshots/en/go-live-report-desktop.webp)
*The figures on Home: how often AI read your pages, and how that changed.*

Depending on your plan, some figures show a lock and the name of the plan that shows them, in place of the figure.

## Week by week

Choose **Week** under **Counted per** to see the figures a week at a time. Narrowed to one property, that is the property's weekly report. The report link in a notice email opens the same screen.

## When nothing has been read yet

Until the first read, the screen says "Waiting for the first read" and explains: "It takes days to weeks before AI reads a newly live page for the first time. Once it does, the count shows here." Below that are the results of checking that the page is served correctly. A link from your property's site makes the page easier to find (see [Link from your site](https://docs.vibebooking.ai/en/link-from-site)).

# When something does not work

> **Plans**
>
> Everything on this page is available on every plan.

When the console shows an error, look for its message on this page. Errors about connecting and your own domain are on their own pages ([Beds24](https://docs.vibebooking.ai/en/connect-beds24#troubleshooting), [Channex](https://docs.vibebooking.ai/en/connect-channex#troubleshooting), [Your domain](https://docs.vibebooking.ai/en/custom-domain#troubleshooting)).

## The reference

When something stops on our side, the error shows a line like "Reference when you contact us: 8F3A-2B9C". With it, we can check which step went wrong and what happened.

Contact us from **Still stuck? Contact us** beside the reference, and the reference and the screen are sent along for you. If you email us instead, include it.

## Common errors

### Something went wrong on our side

"Something went wrong. Try again in a moment." means the work stopped on our side. Nothing is wrong with your setup. Wait a moment and press **Retry**, or do the same thing again. If it keeps happening, [contact us](https://docs.vibebooking.ai/en/troubleshooting#contact).

### The server could not be reached

"We could not reach the server." means the console could not reach our server. Check that other sites open, wait a moment and press **Retry**. If other sites open and the same message keeps appearing, the problem is on our side. Email us at hello@vibebooking.ai: the form in the console cannot reach us either.

### No permission

"You do not have permission to do that." means your role in the console does not allow what you tried. A **Viewer** cannot add properties, connect or go live. If it needs doing, ask your account's **Owner**. Opening another account's page shows it too.

### Page not found

"Not found." means the page does not exist. An old link to a property or domain that was removed shows it too. Open it again from the menu.

### The account was deleted

"This account was deleted." appears once the account has been closed. Its properties, connection and members are gone. **Make a new account** starts again.

## When you cannot sign in

### Sign-in stopped partway

"Sign-in did not complete. Try again." means signing in with Google or LINE stopped partway. Press **Continue with Google** or **Continue with LINE** again. If your browser is signed in to a different Google account, choose the one you use.

### Invitation-only

If you see "The console is invitation-only for now. Only people we have contacted can sign in.", check that you are signing in with the email address our invitation was sent to.

### Not yet available

"This account cannot use the console yet. We will be in touch." means the account you signed in with cannot start yet. We will contact you.

## Contact us

If none of this solves it, contact us from the console. We can see which screen you were on and what it showed, so there is no need to explain it again.

1. **Open Contact us**

   Press **Still stuck? Contact us** under the error. With no error on screen, press your account name at the bottom left, then open **Help** and choose **Contact us**.

2. **Write what happened**

   In **What happened**, write what you noticed and what you tried. The screen, the message shown and the reference are shown under **Sent along with it**, and reach us as they are.

3. **Press Send**

   The screen says "We received your message", and a confirmation email arrives.

![The Contact us screen, with a box for what happened and a Send button.](https://docs.vibebooking.ai/screenshots/en/help-form-desktop.webp)
*The Contact us screen.*

We read messages on weekdays, 10:00 to 18:00 Japan time, and reply by the next business day, to the email address of the account you signed in with. If your account has no email address, the form asks where to reply.

If you see "That did not send. Try again.", **Send from your email app** sends the same content by email. If you cannot sign in at all, email hello@vibebooking.ai.

# FAQ

> **Plans**
>
> Everything on this page is available on every plan.

## About VibeBooking

### What is VibeBooking?

A service that publishes your property's details in a form AI agents can read. Rates and availability come from your reservation system (Beds24 or Channex). You check what will be published in the console before it goes live (see [What the console is for](https://docs.vibebooking.ai/en/getting-started#what-the-console-is-for)).

### Which languages does it support?

Japanese and English, for both the console and these docs. The English console is at [console.vibebooking.ai/en](https://console.vibebooking.ai/en).

To switch the console's language, select your account name to open its menu, then choose **Language**.

![The account menu open, with Language offering 日本語 and English.](https://docs.vibebooking.ai/screenshots/en/language-menu-desktop.webp)
*The account menu, with Language open.*

### What happens to the data VibeBooking reads?

The rates read from your reservation system appear on the page of each property you take live, and AI agents read that page. The page is served on our domain, or on [your own domain](https://docs.vibebooking.ai/en/custom-domain) if you set one up.

## Signing in

### Can anyone sign in?

No. The console is invitation-only for now: only accounts with an email address we have contacted can sign in. Any other account sees "This account cannot use the console yet. We will be in touch." (see [Sign in](https://docs.vibebooking.ai/en/getting-started#sign-in)).

### Why can't I sign in with LINE?

LINE does not pass an email address to the console. While the console is invitation-only it checks that address, so with LINE it has nothing to check. Use Google (see [Sign in](https://docs.vibebooking.ai/en/getting-started#sign-in)).

## Connecting Beds24

### Does VibeBooking change anything in Beds24?

No. VibeBooking holds read permissions only, and cannot change anything in Beds24 (see [What VibeBooking can read](https://docs.vibebooking.ai/en/connect-beds24#what-vibebooking-reads)).

### What does VibeBooking read from Beds24?

Your properties and room types, rates and availability, and basic booking records. It does not read guest names, contact details or payment details (see [What VibeBooking can read](https://docs.vibebooking.ai/en/connect-beds24#what-vibebooking-reads)).

### How do I disconnect Beds24?

On the **Integrations** tab of **Properties**, on the **Beds24** card, press **Disconnect**. Reading rates stops, and VibeBooking's access is revoked at Beds24 as well. Live pages stay up, but no longer show rates. Do it on the device you connected from (see [Disconnect](https://docs.vibebooking.ai/en/connect-beds24#disconnect)).

## Going live and the report

### Does connecting make my property live straight away?

No. A linked property goes to **Preview** first. AI agents can read only the properties you take live with **Go live** (see [Go live](https://docs.vibebooking.ai/en/go-live#go-live)).

### How do I stop being live?

Press **Back to preview** on the property's **Settings** tab. The property goes back to **Preview**, and AI agents can no longer read it (see [Stop being live](https://docs.vibebooking.ai/en/go-live#back-to-preview)).

### Do I need my own domain?

No. Without one, your pages are served on our domain (see [Serve on your own domain](https://docs.vibebooking.ai/en/custom-domain)).

### My property is live, but nothing has read it yet

It takes days to weeks before AI reads a newly live page for the first time. A link from your property's site makes the page easier to find (see [When nothing has been read yet](https://docs.vibebooking.ai/en/report#no-reads-yet)).

### Why are some figures not shown?

Some figures depend on your plan. Where a figure is not shown, the console shows a lock and the name of the plan that shows it (see [Read the report](https://docs.vibebooking.ai/en/report)).

# How VibeBooking works with your system

> **Plans**
>
> Everything on this page is available on every plan.

VibeBooking reads a hotel's rooms, rates and availability from your system, and writes the bookings AI assistants make back into it. We build the adapter for your API ourselves.

## What we need from your system

| Function | What we need |
| --- | --- |
| Read rooms, rates and availability | Rate plans, rates and availability by date, minimum stay, closed to arrival or departure |
| Create a booking | One booking per stay, answered with your id. Store our reference on it |
| Tell a refusal from no answer | A clear error when you cannot take the booking |
| Find by our reference | Look up a booking by our reference |
| Read by your id | Whether it exists, whether it is cancelled, and our reference |
| Cancel | Cancel by your id. Cancelling a cancelled booking succeeds |
| Room back on cancel or change | Tell us whether the room goes back. If not, we take no bookings there |
| Record how it is paid | Paid now or pay at the property, and the amount paid |

A timeout or a server error means the booking may have landed, and we treat it that way.

### How a booking goes through

```mermaid
sequenceDiagram
    autonumber
    participant G as Guest or AI assistant
    participant V as VibeBooking
    participant S as Stripe (the hotel's account)
    participant P as Your system
    G->>V: Asks to book
    V->>P: Re-checks rate and availability
    V->>S: Authorises the card
    V->>P: Creates the booking, with our reference
    P-->>V: Your id
    V->>S: Captures the payment
    V-->>G: Confirmation email
```

### Payment

The hotel is the merchant of record and is paid through its own Stripe account. VibeBooking never holds the money and takes no fee. A booking that cannot be written is never charged.

## What we promise

- Every call is idempotent: a retry gives the same result.
- A booking is never created twice.
- If the payment fails, we cancel the booking in your system too.
- We reconcile regularly and flag any difference.
- Guest details live only in the booking service's database, and we send only what is needed.

When your system does not answer:

```mermaid
sequenceDiagram
    participant V as VibeBooking
    participant P as Your system
    participant S as Stripe
    V-xP: Creates the booking
    Note over V,P: Timeout. Not sent again
    V->>P: Looks it up by our reference
    alt Found
        V->>S: Captures the payment
    else Not found
        V->>S: Releases the authorisation
    end
```

## What we send with each booking

| Field | What it holds |
| --- | --- |
| Our booking reference | For example `VB-ABC123`. Also how we search for, read and cancel the booking |
| Room type, rate plan | Your system's ids |
| Check-in, check-out |  |
| Guests | Adults and children |
| Price per night, currency | The total divided by the nights, including any accommodation tax paid at the property |
| Payment | Paid now: the amount paid online and the Stripe payment id; the rest of the total is collected at the property. Pay at the property: all of it is collected there |
| Lead guest's name, email, phone |  |
| Furigana | A name written in kanji |
| Lives abroad | A guest living outside Japan, and whether they are a Japanese national |
| Nationality, passport number | A foreign national with no address in Japan: fields of Japan's guest register |
| Source id | Our id for which AI assistant the booking came through |

Where your system has no field for one of these, we write it in the booking's notes, one per line. The passport is checked at check-in, face to face. Card details never reach your system.

## API styles

Whatever style your API uses, we build an adapter for it if we need to. Our booking side stays the same; each system gets its own adapter.

| Style | Support |
| --- | --- |
| REST (JSON) | In use (Channex, Beds24) |
| SOAP or XML over HTTPS | Built to your specification |
| TravelXML | Built to your specification |
| Authentication | API keys, refresh tokens |
| Transport | HTTPS only |

### OpenTravel mapping

We do not speak OpenTravel (OTA) messages as standard. If your API takes OTA XML (`http://www.opentravel.org/OTA/2003/05`), we send each booking as an `OTA_HotelResNotifRQ`, as below. Element names and codes follow OpenTravel 2017B.

| What we send | OpenTravel element |
| --- | --- |
| Our booking reference | `UniqueID` (`Type="14"`) |
| Room type, rate plan | `RoomType@RoomTypeCode`, `RatePlan@RatePlanCode` |
| Check-in and check-out dates | `TimeSpan@Start`, `TimeSpan@End` |
| Guests | `GuestCount@AgeQualifyingCode` (adults `10`, children `8`) |
| Price per night, currency | `Rate/Base@AmountAfterTax`, `@CurrencyCode` |
| Payment | `Guarantee@GuaranteeType` (`PrePay` when paid online, `None` when paid at the property); the amount paid in `DepositPayments` |
| Lead guest's name, email, phone | `PersonName`, `Email` and `Telephone` under `Customer` |
| Nationality, passport number | `CitizenCountryName`, `Document` (`DocType="2"`) |
| Furigana, lives overseas | No element for these, so they go in `ResGlobalInfo/Comments` |
| Source ID | `POS/Source/BookingChannel` |
| Cancellation | `ResStatus="Cancel"` |

We never send card details (`PaymentCard`).

## Systems we work with

### Channex

| Function | In Channex |
| --- | --- |
| Read | Room types, rate plans, availability, restrictions |
| Create a booking | Booking CRS `POST /bookings` (status `new`, `ota_name` `Offline`) |
| Our reference | `ota_reservation_code` and `meta` |
| Find by our reference | The bookings list, matched on our reference |
| Read by your id | `GET /bookings/:id` |
| Cancel | `PUT /bookings/:id` (status `cancelled`) |
| Room back | `allow_availability_autoupdate_on_cancellation` and `allow_availability_autoupdate_on_modification` both on |
| Paid now | `payment_collect` `ota`, amount as a deposit |
| Pay at the property | `payment_collect` `property` |

Furigana and the guest register items go in the booking notes, one line each, in Japanese for the front desk.

| Guest data | In Channex |
| --- | --- |
| Name | `customer` surname and name, and the room's guest |
| Email, phone | `customer` `mail`, `phone` |
| Furigana | Notes `ふりがな: …` |
| Lives abroad | Notes `居住: 海外`, or `居住: 海外（日本国籍）` for a Japanese national |
| Nationality | Notes `国籍: …` |
| Passport number | Notes `旅券番号: …` |
| A test booking | Notes start with `[TEST]` |

- The Booking CRS application must be installed.
- The room-back settings are off by default; the hotel switches them on in Channex.
- The API is asynchronous: a read right after a create can answer 404. We never take that as no booking.

### How a hotel connects

The hotel pastes a Channex API key into the VibeBooking console. Once connected, Channex appears under **Properties** › **Integrations**.

![The Connect Channex screen, with a field to paste the API key and a Connect button.](https://docs.vibebooking.ai/screenshots/en/channex-key-desktop.webp)
*Pasting the API key to connect.*

![The Connections tab, showing Channex connected.](https://docs.vibebooking.ai/screenshots/en/channex-connected-desktop.webp)
*Integrations, once connected.*

## Adding your system

Email hello@vibebooking.ai.