Beds24 と連携する

Beds24 で招待コードを作り、コンソールに貼り付けて連携します。読み取れる情報と、連携の解除も説明します。

Markdown で見る

このページの内容

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

始める前に

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

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

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

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

「施設を追加」を開く

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

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

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

施設を追加する欄。施設のウェブサイトを入力して、追加するボタンを押す。 — 施設を追加する欄。

連携する

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

Beds24 を開く

「Beds24で招待コードを作る」を押します。Beds24 の管理画面が新しいタブで開きます。VibeBooking が求める 3 つの読み取り権限は、このリンクに入っています。
Beds24 で招待コードを作る
Beds24 の画面で、次のとおり操作します。コンソールにも同じ案内が出ます。
1. 「Name for this token」欄に、わかる名前を入力する（例：VibeBooking）
2. 「Generate invite code」を押す
できた招待コードをコピーします。招待コードについては、Beds24 の公式ドキュメント API V2（新しいタブで開きます）に説明があります。
招待コードを貼り付ける

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

コードが確認できると、「Beds24との連携を確認しました」の画面に移ります。続けてこの画面で、Beds24 の施設をウェブサイトに紐づけます。手順は施設を紐づけるにあります。

VibeBooking が読み取れる情報

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

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

宿泊者の氏名、連絡先、支払いの情報を読む権限は求めません。権限の定義は、Beds24 の API リファレンス（新しいタブで開きます）にあります。

AI 向けに公開されるのは、「公開する」を押した施設だけです（公開する）。

うまくいかないとき

招待コードが通らない

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

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

権限が足りない

「この招待コードでは、必要な情報の一部を読み取れません。Beds24で招待コードを作り直してください。」は、招待コードに VibeBooking が求める権限の一部が入っていないときの表示です。「Beds24で招待コードを作る」から Beds24 を開き直し、新しい招待コードを作ってください。権限については、Beds24 の公式ドキュメント API V2（新しいタブで開きます）に説明があります。

連携を解除する

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

「連携」タブを開く

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

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

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

連携タブのBeds24のカード。紐づけを見直すボタンと、連携を解除するボタンがある。 — 連携タブのBeds24のカード。

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

料金と空室の取得が止まります。連携で受け取った権限は、VibeBooking が Beds24 の側でも取り消します。以後、Beds24 からは何も読み取りません。
公開中のページは残りますが、料金は表示されなくなります。公開をやめるときは、施設ごとに公開をやめるの操作をします。
データは削除されません。

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

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

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

Beds24 の側で取り消す

連携した端末が使えないときは、Beds24 の管理画面で、VibeBooking に渡した権限を取り消せます。操作の場所は、Beds24 の公式ドキュメント API V2（新しいタブで開きます）で確かめてください。

次に読む

公開する施設を紐づけて内容を確かめ、公開します。