# 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) の操作をします。
- データは削除されません。

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