# 外部連携 ヘルプ ## 概要 外部連携ページは、UnlockOSと外部サービスの連携をカード形式で一覧表示するハブです。各カードから個別の連携設定ページに移動できます。 主な対応先： - **ねっぱん!** — サイトコントローラー（予約・在庫の双方向同期） - **Beds24** — 主要OTA（Booking.com / Airbnb / Expedia / 楽天 / じゃらん）の予約をまとめて同期 - **Cloudbeds** — 予約の同期と、鍵情報・チェックインURLの返却 - **Mews** — 予約の同期（鍵情報の書き戻しには対応していないため、UnlockOS でのチェックインを使います） - **Roomboss** — 予約の同期と、鍵情報の予約メモへの書き込み - **Googleカレンダー** — UnlockOS の予約を Googleカレンダーに書き込み、他チャネルとのダブルブッキングを防止 - **CIV カメラ** — ネットワークカメラ連携によるチェックイン本人確認 - **SMS/音声通知 (Twilio)** — 電話番号のSMS確認や解錠鍵のSMS送信・音声案内に使う送信元の設定 - **固定コード錠** — テンキーなど、暗証番号が変わらないロックを登録（[固定コード錠](fixed-code-connection.md)） --- ## アクセス方法 接続設定 → **外部連携** タブ --- ## カード一覧 各プロバイダーカードには以下が表示されます： | 要素 | 説明 | |------|------| | アイコン | プロバイダーを示すアイコン | | 名前 | プロバイダー名 | | 説明 | 連携の用途を 1 行で説明 | | ステータスバッジ | 現在の連携状態（後述） | | ボタン | 「接続」または「設定を開く」 | ### ステータスバッジ | バッジ | 意味 | |--------|------| | ✓ 連携中 | 認証済みで、連携が正常に動作しています | | ○ 未接続 | まだ接続していません。カードをクリックして接続を開始できます | | ⚠ 要再認可 | 認証が失効しました。プロバイダー側で取り消された可能性があります。再接続が必要です | | … 確認中 | ステータスを取得しています | ステータスは色だけでなくアイコンと aria-label でも識別できるため、色覚の影響を受けません。 --- ## 操作 カード本体またはボタンをクリックすると、個別のプロバイダー設定ページに移動します。 - 未接続のカード → 接続フロー（OAuth 同意 / API 資格情報入力など） - 連携中のカード → 設定変更・切断・同期ログ閲覧など --- ## チェックインの主体を選ぶ 宿泊PMS（ねっぱん! / Beds24 / Cloudbeds / Mews / Roomboss）の設定画面には **「チェックインの主体」** という項目があります。取り込んだ予約を、連携先とUnlockOSのどちらでチェックインするかを接続ごとに選べます。 | 選択肢 | 連携先に返すもの | チェックインする場所 | |---|---|---| | 連携先でチェックインする | 解錠番号・QRのみ | 連携先の画面 | | **UnlockOS でチェックインする（推奨）** | チェックインURL + 解錠番号・QR | UnlockOS | | UnlockOS でチェックインする（URLのみ） | チェックインURLのみ | UnlockOS | - 既存の接続は「連携先でチェックインする」のまま変わりません。新しく作る接続は「UnlockOS でチェックインする」が最初から選ばれています。 - **UnlockOS でチェックインする**を選ぶと、ゲストがチェックインを完了した分が請求対象になります。 - 解錠番号も一緒に返すと、フロントの画面で番号を確認できて便利ですが、ゲストが番号だけで入室してチェックインを飛ばすことがあります。それが多い場合は **URLのみ** に切り替えてください。 ### チェックイン転換率 設定画面の下部に、直近30日の「取り込んだ予約数」「チェックインが完了した数」「転換率」が表示されます。 転換率が **50% を下回っている**（かつ予約が10件以上ある）場合は、解錠番号での直接入室が常態化している可能性があります。画面にも切り替えの案内が出ます。 --- ## Webhook（Beds24 / Cloudbeds） Beds24 と Cloudbeds は、予約の変更・キャンセルを **その場で**受け取れます。設定画面の「Webhook」から URL を発行し、連携先の管理画面に貼り付けてください。 - 登録しなくても定期同期で取り込まれます（反映が同期間隔ぶん遅れるだけです）。 - **URLを再発行すると、古いURLはすぐに使えなくなります。** 再発行したら連携先の登録も貼り替えてください。 - 最後に受信した時刻が同じ画面に表示されるので、届いているかを確認できます。 --- ## よくある質問 ### Q: タブが見えません A: `tab_integrations` フィーチャーフラグが OFF の場合、外部連携タブは表示されません。サポートに有効化をご依頼ください。 ### Q: 自分の施設では使えないプロバイダーが表示されます A: 各プロバイダーは `card_neppan` / `card_beds24` / `card_cloudbeds` / `card_mews` / `card_roomboss` / `card_gcal` / `card_civ_camera` / `card_twilio_sms` / `card_fixed_code` のフィーチャーフラグで個別に制御されています。サポートにお問い合わせください。 ### Q: 「固定コード錠」のカードが表示されません A: `card_fixed_code` は**本番環境ではまだ有効化されていません**（ステージングでのみ有効）。利用をご希望の場合はサポートにお問い合わせください。詳しくは[固定コード錠](fixed-code-connection.md)を参照してください。 ### Q: Mews に QRコードが返りません A: Mews には解錠番号を書き戻す専用の項目があり、そこへ有効期間つきで返します。ただし QRコードに該当する項目が Mews 側にないため、QRコードは返せません。QRコードをゲストに渡したい場合は「UnlockOS でチェックインする」を選んでください。 ### Q: 連携先に古い解錠番号が残りませんか A: 残りません。解錠番号を再発行したときは、連携先に書いた値を**書き換え**ます（追記しません）。Roomboss の予約メモの場合は、UnlockOS が自分の区画だけを書き換えるので、前後に書かれた申し送りはそのまま保たれます。 ### Q: SMS/音声通知 (Twilio) のカードが「未接続」のままです。プラットフォーム（UnlockOSから送る）を選んでいるのに A: このカードのステータスは自社Twilio（BYO）の連携状況のみを表示します。「UnlockOSから送る」を選んでいる場合でも、このカードは「未接続」のまま表示されることがあります。実際の送信元は、カードから開く設定画面（[SMS電話番号確認](sms-verification.md)を参照）でご確認ください。 ### Q: 旧 URL `/camera-connection` `/google-calendar-connection` をブックマークしています A: 旧 URL は自動的に新パス `/integrations/civ-camera` `/integrations/google-calendar` にリダイレクトされるため、そのまま開いても問題ありません。 --- ## 関連ページ - [Googleカレンダー 連携](google-calendar-integration.md) - [ねっぱん! 連携](integration.md) - [CIV カメラ連携](camera-connection.md) - [SMS電話番号確認](sms-verification.md) - [固定コード錠](fixed-code-connection.md) - [ロック接続](lock-connection.md)