Channex と連携する
Channex の API キーをコンソールに貼り付けて連携します。予約ページの URL の入れ方と、連携の解除も説明します。
このページの内容
Channex と連携すると、VibeBooking が Channex から施設の一覧、料金、空室を読み取れるようになります。Channex で API キーを 1 つ作り、コンソールに貼り付けます。2 分ほどで終わります。
始める前に
次の 2 つを確かめてください。
- コンソールでの役割が「オーナー」か「管理者」であること。「閲覧者」は連携できません。
- Channex の管理画面にログインして、API キーを作れること。
お客様が予約するページの URL は、Channex からは読み取れません。予約エンジンをお使いなら、予約ページの URL を手元に用意してください。あとから入力することもできます（予約ページを入力する）。
連携する
「施設」の「一覧」で「予約システムと連携する」を押すと、「連携」タブが開きます。「お使いの予約システム」の「Channexと連携する」を押します。
Channex の API キー設定を開く
「ChannexでAPIキー設定を開く」を押します。Channex の API キーの設定画面が、新しいタブで開きます。
Channex で API キーを作る
コンソールの案内のとおりに操作します。
- 「キーに、わかる名前を付ける（例：VibeBooking）」
- 「表示されたキーをコピーする」
API キーを貼り付ける
コンソールのタブに戻り、「APIキー」欄に貼り付けます。前後に空白が入っていても構いません。
予約ページの URL を入力する
「予約ページのURL（おすすめ）」に、予約エンジンのページの URL を入力します。空欄のままでも連携できます。
「連携する」を押す
キーが確認できると、「Channexとの連携を確認しました」の画面に移ります。
続けてこの画面で、Channex の施設をウェブサイトに紐づけます。手順は 施設を紐づける にあります。予約ページを入力しなかったときは、この画面に「予約ページが未設定です。AIはお客様を予約ページへ案内できません。」と表示されます。
予約ページを入力する
AI は、ここに入力したページへお客様を案内します。入力しなくても施設は公開できますが、AI はお客様を予約ページへ案内できません。
「連携」タブを開く
メニューの「施設」を押し、「連携」タブを開きます。
URL を入力する
Channex のカードの「予約ページ」に、予約エンジンのページの URL を入力します。
「保存する」を押す
「予約ページを保存しました。」と表示されます。
入力できるのは、https:// で始まる、お使いの予約エンジンのページです。楽天トラベルや Booking.com のような予約サイトのページは使えません。欄を空にして「保存する」を押すと、「予約ページを削除しました。」と表示されます。
予約エンジンが施設のサイトと別のドメインにあると、「施設のウェブサイトとは別のドメインです。予約エンジンが別のドメインにあるなら、このままで問題ありません。」と表示されます。予約エンジンのページで合っていれば、そのままで構いません。
VibeBooking専用チャネルを選ぶ
VibeBooking のリンクから入った予約を数えるための設定です。Channex に VibeBooking 専用の予約ページ（チャネル）を 1 つ作り、Channex のカードの「VibeBooking専用チャネル」で選びます。そのチャネルに入った予約が、VibeBooking 経由として数えられます。数えるのはチャネル全体で、AI ごとには分かれません。
設定するまでは「未設定です。VibeBooking経由の予約は、まだ数えられません。」と表示されます。
Channex でチャネルを作る
Channex で、VibeBooking 専用のチャネルを 1 つ作ります。名前に VibeBooking と入れておくと、コンソールで最初から選ばれます。まだ作っていないときは、カードの「Channexで予約ページを作る」から Channex のチャネルの画面を開けます。
チャネルを選ぶ
コンソールの「連携」タブに戻り、「VibeBooking専用チャネル」の一覧から、作ったチャネルを選びます。名前に VibeBooking が入っていれば「VibeBookingという名前のチャネルを選んであります。保存すると決まります。」と表示されます。Booking.com のような予約サイトのチャネルは、一覧に出ません。
「保存する」を押す
「チャネルIDを保存しました。」と表示されます。
一覧にないときは「一覧にないときは、IDを貼り付ける」を開きます。Channex でそのチャネルを開き、アドレスバーの URL を貼り付けて「保存する」を押します。一覧を読み取れなかったときは、欄の名前が「VibeBooking専用チャネルのID」になり、同じように URL を貼り付けます。
変更できるのは「オーナー」と「管理者」です。
VibeBooking が読み取る情報
VibeBooking は API キーで、Channex から施設の一覧、料金、空室を読み取ります。Channex の内容を書き換えることはありません。
AI 向けに公開されるのは、「公開する」を押した施設だけです（公開する）。
うまくいかないとき
キーが確認できない
「連携する」を押したあと、「確認できませんでした。キーの入力が間違っているか、Channexに届いていない可能性があります。もう一度貼り付けるか、しばらくしてからお試しください。」と表示されたときは、次の順に確かめてください。
- キーを最後までコピーしたか。長い文字列なので、コピーのときに途中で切れることがあります。Channex の画面でもう一度コピーします。
- 別のキーを貼り付けていないか。
- 少し待ってから、もう一度「連携する」を押す。
権限が足りない
「このキーでは、必要な情報の一部を読み取れません。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 として読み取れませんでした。ブラウザのアドレス欄からコピーし直します。 |
連携を解除する
連携を解除できるのは「オーナー」と「管理者」です。
「連携」タブを開く
メニューの「施設」を押し、「連携」タブを開きます。
「連携を解除する」を押す
Channex のカードにある「連携を解除する」を押します。
「解除する」を押す
「Channexとの連携を解除しますか？」と確認されます。「解除する」を押すと、「連携を解除しました。」と表示されます。
Channex で API キーを削除する
解除しても、Channex には通知が届きません。Channex の API キーの設定画面で、VibeBooking 用に作ったキーを削除してください。
解除すると、次のようになります。
- 料金と空室の取得が止まります。
- 公開中のページは残りますが、料金は表示されなくなります。公開をやめるときは、施設ごとに 公開をやめる の操作をします。
- データは削除されません。
「解除できませんでした。もう一度お試しください。」と表示されたときは、連携はまだ続いています。もう一度「連携を解除する」から操作してください。