# 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) で確かめてください。