ロック接続 ヘルプ
概要
ロック接続では、スマートロックとの連携設定を行います。連携することで、チェックイン時の自動解錠が可能になります。
UnlockOSはLock Adapter層の上に構築されており、公開クラウドAPIを持つスマートロックであれば接続できます。KEYVOXは標準搭載されており、この画面から自分で設定できます。他社製ロックは機種ごとの統合対応となるため、お使いの機種をお問い合わせください。以下はKEYVOXタブの操作手順です。
テンキーなど、暗証番号が変わらないロックはクラウドAPIを持たないため、この画面ではなく固定コード錠の画面で登録します（外部連携 → 固定コード錠）。
主な機能
- KEYVOXアカウントとの連携
- 登録済みロックデバイスの一覧表示
- 連携の解除
- KEYVOXからの通知（Webhook）の自動設定
タブ
| タブ名 | 説明 |
|---|---|
| KEYVOX | KEYVOXスマートロックとの連携 |
| Stripe | Stripe決済との連携 |
| LINE | LINE公式アカウントとの連携 |
Stripe決済連携タブ
Stripeタブでは、Stripeアカウントと連携してオンライン決済を有効化できます。連携完了後は、チェックイン時にゲストへ前払い/後払い/デポジットの請求が可能になります。
KEYVOX連携
接続状態
| 状態 | 説明 |
|---|---|
| 接続済み | KEYVOXアカウントと正常に連携しています |
| 未接続 | KEYVOXアカウントとの連携がありません |
ボタン
| ボタン | 説明 |
|---|---|
| KEYVOXでログイン | KEYVOXアカウントでOAuth認証を行います |
| ログアウト | KEYVOXとの連携を解除します |
Webhook（入退館の受信）
KEYVOX の錠が開いた・閉まった・開かなかった、ロッカーに預け入れがあった、という通知を KEYVOX から受け取るための設定です。この通知で、予約詳細の利用状況などが更新されます。接続状態カードの下半分に表示されます。
KEYVOX と接続すると、UnlockOS が自動で KEYVOX に登録します。Stripe 決済設定の Webhook と同じように、「自動設定する」を押せば何度でもやり直せます。この設定は、同じ組織のすべての施設で共通です。
この欄は順次提供しています。表示されない場合は、これまでどおり BACS 管理画面で錠ごとに設定してください。
| 表示 | 意味 | すること |
|---|---|---|
| 設定済み | KEYVOX に登録済みです | なし |
| 未設定 | KEYVOX にまだ登録がありません | 「自動設定する」を押す |
| 更新が必要です | 登録はありますが、受け取るイベントが足りません | 「自動設定する」を押す（登録し直します） |
| 署名鍵の同期待ち | 署名鍵を更新したあと、この KEYVOX アカウントにまだ新しい鍵を届けられていません | 「自動設定する」を押す。古い鍵も 7 日間は受け付けます |
| UnlockOS の別の組織で使われています | 同じ KEYVOX アカウントを、UnlockOS の別の組織が使っています | 1 つの KEYVOX アカウントを複数の組織で使うことはできません。その組織の施設で「登録を解除」してから、こちらで「自動設定する」を押します |
| 別の宛先に登録されています | この KEYVOX アカウントに、UnlockOS 以外の宛先が登録されています | その宛先を使っている方に確認し、KEYVOX の管理画面で削除してから「自動設定する」を押します |
| 確認できません | KEYVOX に問い合わせられませんでした。理由が横に出ます | 「KEYVOX 側で現在、Webhook の自動設定の受け付けを停止しています。」と出ている間も、BACS 管理画面で錠ごとに設定した Webhook はこれまでどおり届きます |
| ボタン | 説明 |
|---|---|
| 自動設定する | KEYVOX に登録します。施設オーナー以上が押せます |
| 署名鍵を更新 | 新しい署名鍵を作り、KEYVOX の登録を差し替えます。受信は途切れません。この組織のすべての施設に適用され、古い鍵も 7 日間は受け付けます。組織オーナーにだけ表示されます |
| 登録を解除 | KEYVOX から UnlockOS 宛ての登録を削除します。解除すると、入退館とロッカーへの預け入れが記録されなくなります。同じ KEYVOX アカウントをほかの施設が使っている場合は、KEYVOX 側の登録は残し、この施設の記録だけを外します |
署名鍵は画面に表示されません。UnlockOS が KEYVOX に直接渡します。
BACS 管理画面で錠ごとに Webhook を設定している場合は、ここが「設定済み」になったら、錠ごとの設定を削除してください。残っていると、同じ通知が 2 回届きます。
デバイス一覧
場所（Place）
登録されたロックは場所ごとにグループ化されて表示されます。
ドア
各場所の下に、登録されたドアとスマートロックが表示されます。
表示項目
| 項目 | 説明 |
|---|---|
| 場所名 | ロックが設置されている場所の名前 |
| ドア名 | ドアの名前 |
| スマートロック名 | スマートロックの名前 |
| ユニットID | KEYVOXユニットの識別子（クリックでコピー可能） |
| 解錠ロック | リモート解錠で使用するロックID（管理者が選択） |
操作
KEYVOXとの連携
- 「KEYVOXでログイン」ボタンをクリック
- KEYVOXのログイン画面に遷移
- KEYVOXアカウントでログイン
- 認証完了後、自動的にUnlockOSに戻ります
- 登録済みのロックデバイスが一覧表示されます
ユニットIDのコピー
ユニットIDをクリックすると、クリップボードにコピーされます。チェックイン設定で使用します。
解錠ロックIDの設定（リモート解錠に必須）
ゲストがリモート解錠ボタンを使用できるようにするには、各ユニットに対して「解錠ロック」を指定します。
- デバイス一覧でユニットを開く
- 「解錠ロック」のドロップダウンから、そのユニットで使用するロックIDを選択する
- 選択後、設定は自動的に保存されます（✓マークが表示される）
KEYVOXユニットに複数のロックIDが紐づいている場合、ドロップダウンに全候補が表示されます。適切なロック（ゲストが解錠するドアに対応するもの）を選択してください。
解錠ロックIDが設定されていない場合、ゲストがリモート解錠を試みると「Lock ID not found」エラーが表示されます。
連携の解除
- 「ログアウト」ボタンをクリック
- 確認ダイアログで「はい」を選択
- KEYVOXとの連携が解除されます
よくある質問
Q: KEYVOXとの連携が切れた場合はどうすればいいですか？
A: 再度「KEYVOXでログイン」ボタンをクリックして連携してください。
Q: 複数の施設でKEYVOXを使用できますか？
A: はい、各施設ごとにKEYVOXアカウントを連携できます。
Q: ロックが表示されない場合は？
A: KEYVOXのダッシュボードでロックが正しく登録されているか確認してください。
Q: チェックイン設定でロックを指定するには？
A: チェックイン設定画面で、一覧からユニットIDをコピーして設定してください。
Q: 解錠ロックのドロップダウンが表示されません
A: KEYVOXユニットにロックIDが1つも紐づいていない場合、ドロップダウンは表示されません。KEYVOXダッシュボードでユニットにロックが正しく割り当てられているか確認してください。
関連ページ
- チェックイン設定
- チェックイン一覧
- 基本設定
- LINE連携設定
- 固定コード錠
- アクセスキー表示（QR・PIN・リモート解錠）
- 通知ワークフロー ヘルプ