外部連携 ヘルプ
概要
外部連携ページは、UnlockOSと外部サービスの連携をカード形式で一覧表示するハブです。各カードから個別の連携設定ページに移動できます。
主な対応先：
- ねっぱん! — サイトコントローラー（予約・在庫の双方向同期）
- Googleカレンダー — UnlockOS の予約を Googleカレンダーに書き込み、他チャネルとのダブルブッキングを防止
- CIV カメラ — ネットワークカメラ連携によるチェックイン本人確認
将来的に Beds24 / Airbnb 直販 / その他 OTA アダプタもこのハブに追加されます。
アクセス方法
接続設定 → 外部連携 タブ
カード一覧
各プロバイダーカードには以下が表示されます：
| 要素 | 説明 |
|---|---|
| アイコン | プロバイダーを示すアイコン |
| 名前 | プロバイダー名 |
| 説明 | 連携の用途を 1 行で説明 |
| ステータスバッジ | 現在の連携状態（後述） |
| ボタン | 「接続」または「設定を開く」 |
ステータスバッジ
| バッジ | 意味 |
|---|---|
| ✓ 連携中 | 認証済みで、連携が正常に動作しています |
| ○ 未接続 | まだ接続していません。カードをクリックして接続を開始できます |
| ⚠ 要再認可 | 認証が失効しました。プロバイダー側で取り消された可能性があります。再接続が必要です |
| … 確認中 | ステータスを取得しています |
ステータスは色だけでなくアイコンと aria-label でも識別できるため、色覚の影響を受けません。
操作
カード本体またはボタンをクリックすると、個別のプロバイダー設定ページに移動します。
- 未接続のカード → 接続フロー（OAuth 同意 / API 資格情報入力など）
- 連携中のカード → 設定変更・切断・同期ログ閲覧など
よくある質問
Q: タブが見えません
A: tab_integrations フィーチャーフラグが OFF の場合、外部連携タブは表示されません。Platform Admin に有効化を依頼してください。
Q: 自分の施設では使えないプロバイダーが表示されます
A: 各プロバイダーは card_neppan / card_gcal / card_civ_camera のフィーチャーフラグで個別に制御されています。Platform Admin に問い合わせてください。
Q: 旧 URL /camera-connection /google-calendar-connection をブックマークしています
A: 旧 URL は自動的に新パス /integrations/civ-camera /integrations/google-calendar にリダイレクトされるため、そのまま開いても問題ありません。