smartphone KEY
Main site Admin Panel API setup
JA
Admin Panel · リファレンス

Admin Portal ユーザーガイド

SmartphoneKey Admin Portal の完全な文書リファレンスです。すべてのセクション、ボタン、ワークフローを網羅しています。目次からトピックに移動するか、インタラクティブなウォークスルーと併せてご利用ください。

インタラクティブなウォークスルーを開く
セクション 1

このガイドについて

このガイドでは、登録以降の SmartphoneKey Admin Portal の使い方を説明します。システム内部の処理には触れず、ポータルのインターフェースで実行できる操作を扱います。

アカウントに表示されるセクションやボタンは、ロールと権限によって異なります。以下で説明する機能の一部しか表示されない場合があります。

セクション 2

アカウントを作成して最初のロックを登録する

管理者または設置業者から提供された登録リンクを使用します。

手順

  1. registration page（登録ページ）を開きます。
  2. メールアドレスを入力します。
  3. パスワードを作成します。
  4. ロックのシリアル番号を入力します。
  5. ロックに付属の Matter コードまたはペアリングコードを入力します。
  6. 住所欄が表示されている場合は、住所を入力します。
  7. Register または Create Account をクリックします。
  8. 登録が完了したら、ポータルが自動的に開かない場合はサインインします。

これで、アカウントが最初の物件とロックに紐付けられました。

登録に失敗した場合

次の点を確認してください。

  • シリアル番号が正しいこと。
  • Matter コードまたはペアリングコードが正しいこと。
  • ロックがまだ登録されていないこと。
  • パスワードが最小要件を満たしていること。

問題が解決しない場合は、管理者に連絡してください。

セクション 3

Admin Portal にサインインする

  1. SmartphoneKey Portal のログインページを開きます。
  2. メールアドレスとパスワードを入力します。
  3. Sign In をクリックします。
  4. ログイン後、SPK Portal を開きます。

Sign in with Google または Sign in with Apple ボタンを使って、ワンクリックでサインインすることもできます。この場合、ポータルアカウントと同じメールアドレスを使用してください。

ポータルを開いている間にセッションの有効期限が切れると、ポータルから再度サインインするよう求められます。

セクション 4

現在の物件を選択する

Entity（物件）とは、作業対象のデバイスとユーザーが属する組織、建物、拠点、または管理区域のことです。

複数の物件にアクセスできる場合：

  1. ポータルヘッダーの物件セレクター（右上。現在の物件名とロック数が表示されます）を見つけます。
  2. ドロップダウンリストを開きます。
  3. 目的の物件を選択します。
  4. ページのデータが更新されるまで待ちます。

アクセスできる物件が 1 つだけの場合は、その名前がヘッダーに表示されますが、切り替え用のドロップダウンは表示されません。

ユーザーの作成、キーの割り当て、デバイスの追加、ログの確認を行う前に、必ず選択中の物件を確認してください。

セクション 5

メインナビゲーション

左側のメニューには、固定されたトップレベルのセクションがあります。権限に応じて、すべて、または一部だけが表示されます。

セクション用途
Dashboard概要の指標と最近のアクティビティを確認します。
Entities物件とその Local Admin を作成・管理します。
Usersポータルユーザーを作成・管理します。
Keysデジタルキー、物理キー、Wallet Keys を管理します。
Devicesロック、ハブ、Matter デバイスを管理します。
Camerasカメラとカメラロールを追加・管理します。
Logsアクティビティイベントと監査履歴を確認します。
Settingsプロフィール、サブスクリプション、通知、アクセスリクエスト、請求を管理します。

いくつかのセクションでは、個別のメニュー項目の代わりに、ページ上部のタブで切り替えます。

  • Keys → キー、物理キー、Wallet Keys
  • Devices → ロック、ハブ、Matter
  • Cameras → カメラ、カメラロール
  • Logs → アクティビティ、監査
  • Settings → プロフィール、サブスクリプション、通知、アクセスリクエスト、請求

アカウントによっては、すべてのセクションやタブが表示されない場合があります。

サブスクリプションに含まれていないセクションやボタンは、ロックアイコン付きのロックされた状態で表示されます。ロックされた項目をクリックすると、不足しているパッケージを Settings → Subscription ページで購入するよう案内するウィンドウが開きます（23.2 を参照）。Matter デバイスタブ、カメラページとログページ、ゲストキー、およびモバイルアプリやインターホンのアクセス付与は、この方法でロックを解除できます。

ポータルヘッダーの右上、物件セレクターの隣で、SPK Portal のインターフェース言語を変更できます。言語セレクターを開き、英語、ウクライナ語、スペイン語、ギリシャ語、ドイツ語、フランス語、韓国語、日本語、ポーランド語、ポルトガル語のいずれかを選択すると、ポータルが選択した言語で再読み込みされます。その隣の Welcome Page リンクは、SmartphoneKey Portal カードのあるポータルのホームページに戻ります。選択内容はアカウントに保存されるため、セッションやデバイスをまたいでもインターフェースはその言語のままです。ライト／ダークテーマの切り替えと Admin Panel のバージョンは、左側メニューの下部に表示されます。スマートフォンでは、言語セレクターはサイドメニューの下部にも表示され、下部のナビゲーションバーからよく使うセクションにワンタップでアクセスできます。Menu タブを開くとフルメニューが表示されます。フルメニューは、左にスワイプするか、デバイスの「戻る」ジェスチャーで閉じることもできます。

セクション 6

ダッシュボード

Dashboard では、選択中の物件の概要をすばやく確認できます。

ダッシュボードの用途：

  • 上部のゲージタイルを確認します。Total Locks（オンライン、オフライン、未報告のロック）、Matter Devices（閲覧できるすべての物件にわたって、ハブ経由でコミッショニングされたすべてのデバイス。オンライン、オフライン、未報告）、Total Keys（ユーザーが保有するキーの種類別の数。Wallet Keys、物理キー、ゲストキー、インターホンアクセス）、Total Users（フルアクセスのユーザー、電話番号のみの制限付きアクセスのユーザー、無効化されたユーザー）。各半円リングの中央の数字が合計で、色付きのセグメントごとに件数が表示され、リングの下の凡例がセグメントの名前を示します。タイルの隅の矢印をクリックすると、対応するページが開きます。
  • ゲージの下にあるロック、カメラ、Matter の各パネルは、タブスイッチャー（複数のビューが利用できる場合に表示）で切り替えます。Matter パネルでは、接続済みのハブパネルにハブの合計が表示されます。
  • 最近のアクティビティを確認します。
  • 正しい物件で作業していることを確認します（ダッシュボードには物件名とコードが表示されます）。
  • ロールで利用できる場合は、クイックアクションボタン（アクセスを付与、ゲストキー、アクセスを削除）とクイックアクセスのショートカットを使用します。

物件を切り替えると、ダッシュボードは自動的に更新されます。

セクション 7

物件を管理する

Entities を開いて、組織、建物、拠点、その他の管理区域を作成・管理します。物件はカード（グリッド表示）または行（リスト表示）として表示され、フィルター、検索、並べ替えができます。

7.1 物件を作成する

  1. Entities を開きます。
  2. Create Entity をクリックします。
  3. 物件名を入力します。
  4. 必要に応じて説明を追加します。
  5. 必要に応じて、Add Local Admin に最初の Local Admin のメールアドレスを入力します。
  6. 必要に応じて、その Local Admin に移動する Wallet Keys の数を入力します。
  7. Create をクリックします。

物件コード

物件のカードや行に表示される物件コードは、物件名から自動的に生成されます（大文字と数字で構成され、一意になるよう調整されます）。作成後に変更することはできません。

7.2 物件を編集する

  1. Entities を開きます。
  2. 目的の物件を見つけます。
  3. 設定（歯車）アイコンをクリックするか、カードメニューを開いて Edit details を選択します。
  4. 名前または説明を更新します。
  5. Save Changes をクリックします。

7.3 物件を削除する

  1. Entities を開きます。
  2. 目的の物件を見つけます。
  3. カードメニューを開いて Delete entity を選択します。
  4. 確認メッセージをよく読みます。
  5. 削除を確定します。

物件にロックが残っている間は削除できません。先にロックを削除するか、別の物件に移してください。

7.4 物件情報ウィンドウ

物件名をダブルクリック（スマートフォンではダブルタップ）すると、Entity Information ウィンドウが開きます。これは、その物件に関するすべての情報をまとめた読み取り専用の概要です。同じウィンドウは、物件の行やカードの情報アイコン、行やカードのメニュー（Entity Information）、および概要テーブルの情報アイコン（7.5 を参照）からも開けます。

  • Header — 物件のモノグラム、名前とコード、有効／非アクティブのステータス、選択中の物件である場合の CURRENT マーク、ネストされている場合の親物件、および説明。
  • Summary tiles — ユーザー、発行済みキー、ロック、Matter デバイス、カメラの概要。それぞれに最も有用な詳細（空きキー、オンラインのロックなど）が添えられます。
  • Keys — ユーザーが現在保有しているキー。種類別（Wallet、Physical、Guest、QR Intercom）のカラーバーに加え、空きプール、30 日以内に期限切れになるキー、期限切れおよび取り消し済みのキー、共有（複数ロック）ゲストキーを表示します。会社で Expiring Wallet Keys（Odoo：Configuration > Settings > Portal Interface。デフォルトはオフ）が有効になっている場合、このセクションには、まもなく期限切れになる Wallet Keys が、保有者の名前、メールアドレス、ロック、有効期限とともに一覧表示されます。
  • Users — フルアクセス、制限付きアクセス（電話番号のみ）、無効化されたユーザー。Users ページと同じ区分です。
  • Administrators — 所有者、すべての Local Admin（Wallet Key の残高付き）、およびこの物件を対象とする管理ロールを持つ全員。連絡先とロールのチップ付きで表示されます。カードの ID カードアイコンをクリックすると、Users ページでその人のユーザー情報ウィンドウが開きます。名前が表示されるのは自分が管理している物件のみで、それ以外の物件では件数だけが表示されます。
  • Locks — すべてのロックと、そのオンライン／オフライン／未接続の状態、発行済みキーの数、プログラマーリーダーおよび Matter 接続のマーク。
  • Devices and Cameras — Matter ハブとデバイス（オンライン、オフライン、未報告）、カメラ（有効、無効）、カメラロール。これらのページを開ける場合にのみ表示されます。
  • Recent Activity — 過去 14 日間にこの物件のロックで発生したイベントのグラフ（1 日につき 1 本の棒。棒にポインターを合わせると日付と件数が表示されます）と、それに続く最新 5 件のイベント（新しい順、関係者付き）。
  • Details — コード、親物件、サブ物件、および物件の作成日時と作成者。

セクションの見出しをクリックすると折りたたまれます。ウィンドウはその選択をブラウザーに記憶し、次に開く物件にも適用します。フッターの Download PDF は、ウィンドウ全体をお使いの言語の PDF レポートとして保存するため、そのまま建物の所有者に送付できます。このウィンドウ自体は何も変更しません。フッターの Add user、Edit、Open は、行のボタンと同じ操作につながります。

7.5 物件の概要テーブル

検索ボックスの隣にある表示切り替え（リストアイコン／テーブルアイコン）を使うと、物件の行が、閲覧できるすべての物件を 1 つにまとめたテーブルに置き換わります。各行には、物件のステータス、ユーザー（フル／制限付きの内訳付き）、発行済みキー（種類別バー付き）と空きキー、ロック（オンライン数付き）、Matter デバイスとカメラ（それらのページを開ける場合）、管理者、および過去 14 日間にそのロックで発生したイベント数が表示されます。最終行は各列の合計です。

列見出しをクリックするとその列で並べ替えられ、もう一度クリックすると順序が反転します。フィルターチップと検索ボックスは、行を絞り込むのと同じようにテーブルも絞り込みます。行をダブルクリックするか、その情報アイコンをクリックすると、物件情報ウィンドウが開きます。ポータルは最後に使用した表示を記憶します。

セクション 8

Local Admin を管理する

Local Admin は、特定の物件内でユーザーを管理し、割り当てられた Wallet Keys を配布できます。

Local Admins は、個別のページではなく、物件の編集ウィンドウ内で管理します。

このセクションは、物件の所有者だけでなく、その物件の管理を許可されているすべての管理者が利用できます。Local Admin は、さらに別の Local Admin を追加することはできません。

Local Admin ができることは、会社の管理者がバックオフィスの Configuration → Role Configurator → Local Admin → Company settings で会社ごとに絞り込めます。Local Admin がハブと Matter デバイスを追加・管理できるか、カメラを他の人と共有できるか、各 Local Admin が物件内で何人のユーザーを作成できるかを決めます。この設定がない場合、Local Admin は他の物件管理者と同じようにハブ、Matter デバイス、カメラへのアクセスを管理し、制限なくユーザーを作成します。この設定はその会社の物件にのみ適用され、別の管理役割も併せ持つアカウントはその役割の権限をそのまま保持します。

8.1 Local Admin を追加する

  1. Entities を開きます。
  2. 目的の物件を編集用に開きます（歯車アイコンまたは Edit details）。
  3. Manage Local Admins セクションまでスクロールします。
  4. Add Local Admin で、既存の物件メンバーを選択するか、新しいメールアドレスを入力します。
  5. 必要に応じて、移動する Wallet Keys の数を入力します。
  6. Add をクリックします。

メールアドレスが既存のユーザーのものでない場合、そのユーザーに招待が送られます。物件の作成時に最初の Local Admin を追加することもできます（7.1 を参照）。

8.2 Local Admin に Wallet Keys を追加で移動する

自分の空き残高から Local Admin に Wallet Keys を移動するには、この手順を使用します。

  1. 物件を編集用に開きます。
  2. Manage Local Admins で、目的の Local Admin を見つけます。
  3. その Local Admin の隣にある Wallet Keys フィールドに数量を入力します。
  4. Transfer をクリックします。

8.3 Local Admin の権限を削除する

  1. 物件を編集用に開きます。
  2. Manage Local Admins で、目的の Local Admin を見つけます。
  3. 削除ボタンをクリックします。
  4. 操作を確定します。

Local Admin の権限を削除しても、ユーザーアカウントは削除されません。

セクション 9

ユーザーを管理する

Users を開いて、自分の物件内のポータルユーザーを管理します。ユーザーは検索可能なテーブルに表示され、検索ボックスはユーザーの名前、メールアドレス、電話番号、住所、ナンバープレートに一致します。All / Active / Deactivated チップでステータスを絞り込み（ページを開いた時点では Active が選択されています）、並べ替えセレクターで名前、住所、ロックアクセス、または新しいアカウント順に並べ替えます。ロックアクセス順に並べ替えると、セレクターの隣に矢印が表示されます。矢印は、リストがロック数の多い順か少ない順かを示し、クリックすると順序が反転します。ユーザーの行をダブルクリック（ダブルタップ）すると、読み取り専用の User Information ウィンドウが開きます（9.8 を参照）。Address 列と License Plates 列は、一覧内の少なくとも 1 人のユーザーに住所またはナンバープレートがある場合にのみ表示されます。スマートフォンでは、テーブルに主要な列（名前、主な連絡先、ロックアクセス、操作）のみが表示されます。残りの詳細は、ユーザー情報ウィンドウまたはユーザーの編集時に確認できます。

自分の物件に追加された社内チームメンバー（会社スタッフのアカウント）は、Internal バッジ付きで同じテーブルに表示されます。そのロックアクセスやキーは他のユーザーと同様に管理できますが、アカウント自体（編集、無効化、再有効化）を変更できるのは SmartphoneKey の管理者のみです。他の管理者には、それらの操作は表示されません。

自分自身のアカウントも一覧に表示されるため、自分のロックアクセスとキーを確認・管理できます。このページから自分のアカウントを編集または無効化することはできません。自分の行では、それらの操作は表示されません。

9.1 ユーザーを作成する

  1. Users を開きます。
  2. New User をクリックします。
  3. 必要に応じてプロフィール写真を追加します（PNG または JPG、最大 6 MB）。
  4. ユーザーの氏名を入力します。
  5. ユーザーのメールアドレスを入力します（これがログイン用のメールアドレスになります）。
  6. 必要に応じて電話番号を入力します。番号の前にあるドロップダウンから国を選び、国内番号を入力します。国は 2 文字のコードと国番号で一覧表示され（`UA (+380)`、`DE (+49)`、米国とカナダは 1 つの国番号を共有するため `US/CA (+1)`）、インターフェース言語の国が先頭に、その後に他のすべての国がコードのアルファベット順に続きます。番号フィールドは数字のみを受け付け、選択した国で使われる番号の長さで入力が止まります。桁数が足りない間は、フィールドの下にあと何桁必要かを示すメッセージが表示されます。
  7. 必要に応じて住所／部屋番号を入力します。
  8. 必要に応じて 1 つ以上のナンバープレートを追加します。
  9. 物件を選択します。
  10. Create User をクリックします。

そのメールアドレスが既に別の物件や別の会社のユーザーのものである場合、2 つ目のアカウントは作成されません。その人は選択した物件（とその会社）に追加され、ウィンドウにその旨が表示されます。

新しいユーザーにウェルカムメールを送るかどうかは、Settings の Defaults タブ（「ユーザー歓迎メール」の動作）で制御されます。このダイアログにチェックボックスはありません。

Enterprise および Community Manager サブスクリプションでは、CSV または Excel ファイルから多数のユーザーを一度に作成するための Import Users ボタンもウィンドウに表示されます（9.7 を参照）。

9.2 ユーザーを編集する

  1. Users を開きます。
  2. 目的のユーザーを見つけます。
  3. 編集（鉛筆）アクションをクリックするか、ユーザー情報ウィンドウの Edit User ボタンをクリックします（9.8 を参照）。
  4. 必要なフィールドを更新します。
  5. Entities ドロップダウンで物件のメンバーシップを確認します（1 つ以上の物件を選択）。管理する物件が 1 つだけの場合、このドロップダウンは表示されません。
  6. 必要に応じて、住所、ナンバープレート、プロフィール写真を更新します。
  7. Save Changes をクリックします。

ユーザーは少なくとも 1 つの物件に紐付いている必要があります。

9.3 ユーザーを検索する

検索フィールドでは、次の項目で検索できます。

  • 名前
  • メールアドレス
  • 電話番号
  • ナンバープレート

長い一覧は 1 ページあたり 50 人ずつ表示され、ページリンクはテーブルの下にあります。検索、ステータスチップ、並べ替えは、画面上のページだけでなく、選択中の物件のすべてのユーザーを常に対象とします。新しく検索すると、その結果の最初のページに戻ります。

検索に数字が含まれる場合、ちょうどその号室に住んでいる人が最初に表示され、次に住所にその数字を含むだけの人（「7」で検索すると、17、37、75 号室より先に 7 号室が見つかります）、最後に電話番号やナンバープレートだけが一致した人が表示されます。建物内で探しているのは、たいてい部屋番号だからです。並べ替えセレクターで選んだ順序は、これらの各グループ内でそのまま適用されます。

Physical Keys 列は、各ユーザーが保有する個別のカードの数を示します。3 つのロックに追加された 1 枚のカードは 1 と数え、同じドア用の 2 枚の別々のカードは 2 と数えます。この列は、Settings → Defaults で Show the Physical Keys column on the Users page がオンになっている場合にのみ表示されます（23.5 を参照）。デフォルトではオフです。

9.4 ユーザーを無効化する

ユーザーに有効なアクセスを持たせるべきでなくなった場合に、この操作を使用します。

  1. Users を開きます。
  2. 目的のユーザーを見つけます。
  3. 無効化アクションをクリックします。
  4. 確認メッセージを読みます（無効化すると、ロックアクセスが削除され、ポータルへのログインが無効になり、SmartKey ユーザーが停止されます）。
  5. 必要に応じて理由を入力します。
  6. 操作を確定します。

9.5 ユーザーを再有効化する

  1. Users を開きます。
  2. 無効化されたユーザーを見つけます。
  3. Reactivate User をクリックします。
  4. 操作を確定します。

9.6 制限ユーザー（電話番号のみ、ログインなし）を作成する

制限ユーザー（Limited User）は、ポータルへのログインを持たない、電話番号のみの軽量な ID です。フルアカウントを与えずにキーを発行するだけでよい人に使用します。Users テーブルでは、これらのエントリのメールアドレス列に Limited access と表示されます。

  1. Users を開き、New User をクリックします。
  2. ユーザーの氏名を入力します。
  3. 電話番号フィールドの隣にある Just phone number をオンにします。
  4. 電話番号を入力します（必須。これがこのユーザーの識別子になります）。国番号は番号の前にあるドロップダウンから選び、通常のユーザーと同じ国別の桁数チェックが適用されます（9.1 を参照）。
  5. 必要に応じてメールアドレスを入力します。
  6. 必要に応じて住所／部屋番号を入力します。
  7. 1 つ以上の物件を選択します（管理する物件が 1 つだけの場合は自動的に選択され、フィールドは表示されません）。
  8. Create Limited User をクリックします。

制限ユーザーには、通常のユーザーと同じ Edit、Give Access、Deactivate/Reactivate の操作があり（セクション 9.2、9.4、9.5、10 を参照）、行の Lock Access ボタンからは同じロック別アクセスのポップアップ（セクション 10）が開きます。ただし、ポータルへのログインがないため、Wallet Key ボタンはありません。ウィザードでアクセスを付与する場合は、Physical Key と QR Intercom が選択できます。電話番号は同じ方法（編集アクション）で編集画面に表示されますが、恒久的な識別子であるため変更できません。

制限ユーザーをフルユーザーに変換する。 編集アクションを開き、メールアドレスを設定します。保存すると制限ユーザーではなくなり、そのアドレスでサインインできる通常のポータルユーザーになります。ID は同じままなので、すでに発行済みのキー、ナンバープレート、ロックの付与はすべて有効なままで、電話番号もそのまま残ります。そのメールアドレスは、他のユーザーや連絡先ですでに使われていないものである必要があります。また、ログインを持つようになるため、この変換はサブスクリプションのユーザー数上限にカウントされます。新しいポータルユーザーと同様に、まだパスワードはありません。ログインページの Reset Password で本人が設定します。その手順を記載したウェルカムメールを受け取るかどうかは、Settings の Defaults タブで制御されます。

9.7 ファイル（CSV または Excel）からユーザーを一括作成する

Enterprise および Community Manager サブスクリプションでは、ユーザー作成ウィンドウに、多数のユーザーを一度に作成するための Import Users ボタンが表示されます。プレーンな CSV ファイルと Excel ブック（`.xlsx`、最初のワークシート）の両方に対応しています。

  1. Users を開き、New User をクリックします。
  2. Import Users をクリックします。
  3. 対象の物件を選択します。
  4. Example CSV または Example Excel をクリックして、対応するすべての列を含むファイルをダウンロードします。
  5. 1 行に 1 人ずつ入力し、Choose CSV or Excel file でファイルをアップロードします。
  6. 必要に応じて、メールアドレスがすでに存在する場合に既存ユーザーを更新するオプションをオンにします。
  7. Import Users をクリックし、行ごとの結果を確認します。

インポートが完了すると、追加されなかった行が 1 行でもあれば Import report ウィンドウが自動的に開きます。結果の件数の横にある Import report ボタンからも開けます。レポートには、各行のファイル内の番号、人の名前、メールアドレスまたは電話番号、結果（Created、Updated、Skipped、Failed のいずれか）、そして行がスキップされた（ユーザーが既に存在していた）または失敗した理由の全文が一覧表示されます。Only rows that were not added をオフにすると、作成・更新された行も表示されます。Download the report (CSV) でコピーを保存できます。

作成されたポータルユーザーは、Settings の Defaults タブ（「ユーザー歓迎メール」の動作）に従ってウェルカムメールを受け取ります。

ファイルの列：

  • name — すべての行で必須。
  • email — フルのポータルユーザーを作成します（これがログイン用のメールアドレスになります）。電話番号のない行でも問題ありません。その場合、ユーザーは電話番号なしで作成されます。
  • phone — ポータルユーザーでは任意。電話番号があり、メールアドレスがない行は、制限ユーザーを作成します（9.6 を参照）。 すべての番号は国番号と先頭の `+` を含む国際形式で記入してください（例: `+380501234567`）。国番号のない番号は拒否されます。Excel では `+` が残るように電話番号の列を文字列形式にしてください。
  • address — 任意。ユーザーカードに表示される住所／部屋番号のメモです（9.1 を参照）。
  • license_plate — 任意。ポータルユーザーのみ。複数のプレートは `;` で区切ります。

1 回のインポートで最大 500 行まで処理されます。失敗した行（たとえば無効なメールアドレスや電話番号）は個別に報告され、ファイルの残りの処理は止まりません。

名前には任意の文字体系（たとえばキリル文字）を使用できます。Excel でファイルを編集する場合、最も安全なのは Excel の例をもとに作成し、`.xlsx` としてアップロードすることです。Excel のプレーン CSV 形式はラテン文字以外の文字を疑問符に置き換えるため、そのような行はインポート時に拒否されます。CSV を使いたい場合は、CSV UTF-8 として保存してください。

9.8 ユーザー情報ウィンドウ

ユーザーの行をダブルクリック（スマートフォンではダブルタップ）すると、User Information ウィンドウが開きます。これは、その人に関するすべての情報をまとめた読み取り専用の概要です。

  • Header — プロフィール写真、名前、メールアドレスと電話番号（タップ可能）、およびステータスチップ：有効または無効、制限付きアクセス、内部、通常ユーザー以外のロール（たとえば Local Manager と、その対象の物件）、その人がサブスクリプションパッケージを持っている場合はそのパッケージ、そして Local Admin の場合は自身の Wallet Key 残高。 名前の横の封筒アイコンは、この人に招待メールが送信済みかどうかを示します。未送信なら薄く、送信済みなら濃く表示され（ポインターを合わせると送信日時が表示されます）、クリックすると招待を再送します。メールアドレスのないユーザーにはアイコンは表示されません。
  • Profile — 住所／部屋番号、物件のメンバーシップ、アカウントの作成日時と作成者、最終ポータルログイン、ナンバープレート、SmartKey のステータス。
  • Wallet Key — キーのステータスと有効期限、発行日時と発行者、およびそのキーで開けるすべてのロック（各アクセスの付与日と付与者付き）。
  • Physical Keys — 各カードの番号、シリアル、技術、発行日時と発行者、およびそのロック。 見出しには、その人が保有している異なるカードの枚数が表示されます。1 枚のカードは、いくつのロックを開けられても 1 枚として数えます。
  • App and Intercom Access — モバイルアプリまたは QR インターホンのアクセスがオンになっているロックと、それぞれの付与者および付与日時。
  • Cameras — その人が所有するカメラと所属するカメラロール（ライブストリーミングの付与はカメラ側で管理され、ここには表示されません）。
  • Matter Devices — その人に接続されているスマートデバイスと、ハブおよび接続日。
  • Recent Activity — その人の最新 5 件のロックイベント（新しい順）。View all activity をクリックすると、その人で絞り込まれたアクティビティページが開きます（メールアドレスのあるユーザーで利用可能）。

セクションの見出しをクリックすると、そのセクションが折りたたまれて見出しだけが残ります。もう一度クリックすると元に戻ります。ウィンドウは折りたたんだ内容を記憶するため、次のユーザーを開いても同じセクションが折りたたまれたままになり、実際に使う部分だけに絞り込めます。この選択は自分だけのもので、ブラウザーに保存されます。他の人の表示には影響しません。

このウィンドウは純粋に情報表示用で、ここでアクセスが変更されることはありません。フッターの Edit User で編集ダイアログに移動するか（編集できるアカウントでのみ表示）、従来どおり Lock Access ポップアップからロック別のアクセスを管理します（10 を参照）。このウィンドウは、編集ダイアログが開けない無効化されたユーザーや社内ユーザーでも開けます。

セクション 10

ユーザーのロックへのアクセスを管理する

Users セクションでは、ユーザーのロック別アクセスをすべて 1 つのポップアップで管理します。

  1. Users を開きます。
  2. 目的のユーザーを見つけます。
  3. Lock Access 列のボタンをクリックします。ボタンには、その人が現在開けるロックの数が表示されます（例：3 locks）。

ポップアップが開き（スマートフォンでは全画面表示）、物件のすべてのロックが一覧表示されるため、その人がまだ持っていないロックへのアクセスも付与できます。各ロックの行には 4 つのボタンがあります。

  • Card — Wallet Key（スマートフォンのウォレットに入るデジタルキー）。
  • Key — 物理 NFC キー。
  • Phone — モバイルアプリのアクセス。
  • Camera — QR インターホンのアクセス。

押された状態で表示されているボタンは、そのユーザーがそのロックでその種類のアクセスを現在持っていることを示します。押されていないボタンをクリックするとその種類のアクセスが付与され、押されているボタンをクリックすると取り消されます。

10.1 Wallet Key（カードボタン）

  • ユーザーがまだキーを持っていない場合、新しい Wallet Key を割り当ててメールアドレスに送信することを提案するダイアログが表示されます。
  • ユーザーが別のロックで有効な Wallet Key をすでに持っている場合、その同じキーがこのロックに追加されるだけです。
  • 押された状態のカードボタンをクリックすると、そのロックから Wallet Key が取り消されます。

制限（電話番号のみ）ユーザーは Wallet Keys を利用できないため、カードボタンは表示されません。

10.2 物理キー（キーボタン）

  • ユーザーが有効な物理キーをすでに持っている場合、その同じキーをこのロックに追加するか、新しいキーをプログラムするかを選ぶダイアログが表示されます。 ユーザーが複数の物理キーを持っている場合、ダイアログにはそれぞれのキーが短い番号、カードの種類、すでに開けられるロックとともに一覧表示されるので、1 つ以上のキーにチェックを入れて（または Select all を使って）から Add Existing Key をクリックします。チェックを入れたキーはすべてこのロックに追加されます。
  • 新しいキーをプログラムすると、ロックとユーザーが選択済みの状態で Physical Key Wizard が開きます（セクション 14 を参照）。
  • 押された状態のキーボタンをクリックすると、そのロックの物理キーの取り消しダイアログが開きます。 ロックにそのユーザーの物理キーが複数ある場合は 1 つずつ取り消され、ダイアログには取り消されるキーの UUID が表示されます。

10.3 モバイルアプリのアクセス（電話ボタン）

  • 電話ボタンをクリックするとモバイルアプリのアクセスが付与され、押された状態のボタンをクリックすると（確認のうえ）取り消されます。
  • Professional および Enterprise サブスクリプションでは、その人がそのロックのキーをまだ持っていなくても付与できます。他のプランでは、キーが割り当てられるまでボタンは無効のままです。

10.4 QR インターホンのアクセス（カメラボタン）

  • カメラボタンをクリックすると QR インターホンのアクセスが付与され、押された状態のボタンをクリックすると（確認のうえ）取り消されます。
  • QR インターホンのアクセスを付与すると、その人がまだ持っていない場合はモバイルアプリのアクセスも付与されます。インターホンの呼び出しはアプリで応答するためです。後でインターホンのアクセスを取り消しても、モバイルアプリのアクセスはそのまま残ります。
  • Professional および Enterprise サブスクリプションでは、その人がそのロックのキーをまだ持っていなくても付与できます。他のプランでは、キーが割り当てられるまでボタンは無効のままです。

Managed Access Control Service（パートナー）プランでは、QR インターホンのアクセスを付与するには、有効な Resident Digital Access Package アドオンが必要です。購入するまで付与ボタンは表示されません。アドオンの購入方法は 23.2 を参照してください。既存のアクセスの取り消しは常に可能です。

モバイルアプリまたは QR インターホンのアクセスの付与や取り消しが、SmartKey の記録とポータルの不一致により失敗した場合、ポータルは自動的に再同期して再試行します。それでも失敗する場合は「問題が発生しました。管理者にお問い合わせください。」と表示され、失敗は監査証跡に記録されます。

セクション 11

デジタルキーを管理する

Keys（Keys タブ）を開いて、デジタルキーの割り当て、更新、共有、取り消しを行います。キーはカードとして表示されます。

各キーはカードとして表示されます。表面にはロック、キーの種類、番号、保有者、有効期間が表示されます。カードをタップすると裏返り、裏面にはキーのステータス、保有者のメールアドレスまたは電話番号とその下に連絡先に住所がある場合の保有者の住所、モバイルとインターホンのアクセスチップ、Apple／Google ウォレットのリンク、Lock Details ボタンと User Details ボタン（Devices → Locks の Lock Details（15.14）および Users のユーザー情報ウィンドウ（9.8）とまったく同じウィンドウが開きます）、および操作（メニュー、ゲストキーの Update／Delete、インターホンアクセスの Revoke）が表示されます。裏面、またはその隅にある小さな矢印をタップすると、カードが表面に戻ります。表面の左上にあるチェックボックスは、カードを裏返さずに一括操作用にキーを選択します。表面でロック名が途中で切れている場合は、ポインターを合わせると全体が表示されます。

11.1 キー一覧を絞り込む

フィルターを使って、次の条件で一覧を絞り込めます。

  • ロック
  • ステータス（有効、期限切れ、取り消し済み、利用可能）
  • 種類（Wallet Key、物理キー、インターホン、ゲストキー）

検索フィールドでは、キー UUID、ユーザー名、メールアドレス、電話番号、住所で検索できます。

検索に数字が含まれる場合、ちょうどその号室に住んでいる人のキーが最初に表示され、次に住所にその数字を含むだけの人のキー（「7」で検索すると、17、37、75 号室より先に 7 号室が見つかります）、最後に他のフィールドだけが一致したキーが表示されます。建物内で探しているのは、たいてい部屋番号だからです。

11.2 キーを割り当てる（バインドする）

  1. Keys を開きます。
  2. Bind Key をクリックします。キー割り当てウィザードが開きます。
  3. ステップ 1 — キーで開けるようにするすべてのロックにチェックを入れます。一覧が長い場合は Select all または Clear を使います。
  4. ステップ 2 — 既存のユーザーを選択するか、Create User をクリックして追加します。 ユーザー欄は検索ボックスです。名前、メールアドレス、または電話番号を入力し始めると、その下のリストが入力に合わせて絞り込まれます。マウス、または矢印キーと Enter で人を選択します。Show address にチェックを入れると、リストで各人の住所が名前の上に表示され、住所でも検索できるようになります。このとき住所の一致が名前の一致より先に表示されます。Show address の初期状態は Settings → Defaults に従います（23.5 を参照）。
  5. ステップ 3 — キーの種類を選択します。
    • Wallet Key
    • Physical Key
    • QR Intercom
  6. 選択したキーの種類に応じて表示されるオプションを設定します。
  7. 最後のボタン（キーの種類に応じて Assign Key、Grant Access、または Continue to Programming）をクリックします。

制限ユーザー（9.6 を参照）の場合、ステップ 2 では通常メールアドレスが表示される場所に電話番号が表示され、ステップ 3 では Physical Key と QR Intercom のみが選択できます。制限ユーザーにはポータルへのログインがないため、Wallet Key は利用できません。

複数のロックを一度に選択する

複数のロックを選択すると、それらすべてを開ける 1 つの Wallet Key が発行されるため、ユーザーはドアごとに 1 つずつではなく、1 つのパスを受け取ります。この方法で発行できるのは Wallet Key のみです。Physical Key と QR Intercom はロック単位のオプションで、複数のロックを選択している間は表示されません。

いずれかのロックで完了できなくても、残りは処理されます。ウィザードは開いたままになり、ロックごとの結果（追加済み、すでにこのキーを保持、または失敗とその理由）を表示するため、気付かないうちに失敗することはありません。キーのメールは、ロックごとではなく、一括処理全体で 1 通送信されます。

11.3 Wallet Key を割り当てる

モバイルの Wallet アクセスには、このオプションを使用します。

  1. ウィザードで Wallet Key を選択します。
  2. ポータルから Wallet リンクを自動的にメールで送信する場合は、Send email with key を有効にします。
  3. Assign Key をクリックします。

そのロックに対するモバイルアプリと QR インターホンのアクセスは自動的に付与されます。ユーザーが再利用可能なキー ID をすでに持っている場合、ポータルはそれを再利用することがあります。Send email with key の初期状態と、どのアクセスが付与されるかは、アカウントに設定されたデフォルトの動作に従うため、これらのオプションがあらかじめ設定されている場合があります。

11.4 QR インターホンのアクセスを割り当てる

Wallet Key なしで QR インターホンのアクセスが必要な場合に、このオプションを使用します。

  1. ウィザードで QR Intercom を選択します。
  2. ユーザーとロックを確認します。
  3. Grant Access をクリックします。

11.5 キーを更新する

キーカードの操作メニューを開きます。キーの種類に応じて、次の操作が利用できます。

  • Set Validity（有効開始日／有効期限の変更）
  • Send Wallet Email
  • Add to Another Lock（キー UUID を他のロックで再利用）
  • Revoke Key

Add to Another Lock はキーの性質を保ちます。物理キーを別のロックに追加すると、そのロックにも同じカードが物理キーとして追加されます。モバイルアプリや QR インターホンのアクセスは付与されず、それらは Wallet Key の機能のままです。物理カードは、その有効期間中いつでも別のロックに追加できます。拒否されるのは取り消し済みのカードだけです。

複数の対象ロックに一度にチェックを入れることができます。同じキーがそれぞれのロックに追加され、いずれかのロックで完了できなかった場合はロックごとの結果が表示されます。

また、カードから直接、モバイルとインターホンの権限チップを切り替えたり、Apple Wallet または Google Wallet のリンクをコピーしたりすることもできます。

11.6 キーを取り消す

  1. Keys を開きます。
  2. キーを見つけます。
  3. 操作メニューを開いて Revoke Key を選択します（インターホンカードでは Revoke ボタンを使います）。
  4. 操作を確定します。

Wallet Key を取り消しても、そのキーが永久に廃止されるわけではありません。ユーザーはシステムに存在する限り 1 つの Wallet Key を保持するため、同じロックまたは別のロックで再度アクセスを付与すると、新しいキーが発行されるのではなく、まったく同じキーが復活します。スマートフォンにすでに保存されているパスが再び使えるようになるため、ユーザーが再度追加する必要はありません。物理カードは異なります。取り消されたカードが復活することはなく、新しいカードをプログラムする必要があります。

11.7 一括操作を使用する

チェックボックスでキーを選択すると、一括操作バーが表示されます。

  1. Keys を開きます。
  2. 目的のキーを選択します（または「すべて選択」／「フィルター結果を選択」を使います）。
  3. 一括操作を選択します。
    • Bind（利用可能なキーの場合）
    • Add to Lock（キー UUID の再利用）
    • Send Emails（Wallet メール）
    • Revoke
  4. 確定し、完了するまで進行状況を確認します。

Bind では、Assign Key ウィザードと同じ検索欄でユーザーを選びます。名前、メールアドレス、または電話番号を入力し始めるとリストが絞り込まれ、その下の Show address にチェックを入れると住所の表示と検索ができます（11.2 を参照）。

Add to Lock では、単一キーのダイアログと同様に、複数の対象ロックにチェックを入れることができます。選択したすべてのキーが選択したすべてのロックに追加され、それぞれの UUID、アクセスレベル、有効期間はそのまま保たれます。ロックがすでに持っているキーは、そのロックについてのみ報告され、残りの処理は止まりません。

11.8 オフラインのロックと保留中の変更

キーをロックに実際に追加または削除できるのは、ロックに接続できる間だけです。現在 Offline のロック、または接続状態をまだ報告していないため Not connected のロックでキーを割り当て、更新、または取り消すと、ポータルはロックとの接続がないことを知らせ、失敗させる代わりに変更を保留します。

  • キーカードがグレーになり、Pending バッジが付いて、待機中の内容（追加、削除、または更新）が表示されます。
  • 保留中のカードで利用できる操作は Cancel のみで、保留中の変更を取り下げてキーを以前の状態に戻します。
  • ロックがオンラインに戻ると、保留中の変更は行った順に自動的に適用されます。各変更は監査ログに 2 回表示されます。1 回はキューに入れられたとき、もう 1 回は実際に実行されたときです。
  • 変更が適用されると、「ロック『999』が 12:45 21/08/2026 にオンラインに復帰しました」のような 1 回限りのポップアップが表示され、追加、削除、更新されたキーの数が示されます。ロックがオフラインの間に何もキューに入れられなかった場合、ポップアップは表示されません。

接続状態がまだ Not connected のロックは、オフラインのロックとまったく同じように扱われます。変更は Pending として待機し、ロックが初めてオンラインを報告したときに適用されます。Online と表示されているロックだけがコマンドを直ちに受け取ります。

物理 NFC カードも同じルールに従います。オフラインのロック用に書き込んだカードは、通常どおりリーダーで書き込まれます。待機するのはロックへの登録だけで、ロックがオンラインに戻るまで、Physical Keys 一覧の Delivered 列には Delivered ではなく Pending が表示されます。この保留中の登録を取り消すとカードは取り消されます。ロックが認識していない書き込み済みカードでは解錠できないためです。

ゲストキーは例外です。SmartKey はゲストキーをロックではなくクラウドで管理するため、ゲストキーの作成・更新・削除はロックの接続状態にかかわらず直ちに反映されます（12 を参照）。

セクション 12

一時的なゲストキーを作成・管理する

期間限定の訪問者アクセスには、一時的なゲストキーを使用します。

ゲストキーはロックを待ちません（11.8 を参照）。SmartKey はゲストキーをクラウドで管理するため、ロックが Offline や Not connected の場合でも、ゲストキーの作成・更新・削除は直ちに反映されます。

12.1 ゲストキーを作成する

  1. Devices → Locks を開き、目的のロックの Guest Key ボタンをクリックします（ダッシュボードのゲストキーのクイックアクションも同じように動作します）。
  2. ウィンドウ上部の 2 つの大きなボタンでキーの種類を選びます。Link Key（既定で選択）は共有するリンクとしてキーを発行します。Wallet Key は設定した期間だけ有効な Wallet Key を発行します。このキーは他の Wallet Key と同様にロックへ送られ、下で選んだ宛先にメールで送信され（Max uses と Authorization のオプションは適用されません）、期間が終わるとロックから削除されます。Keys ページではゲストキーの中に Guest Wallet Key として表示され、カードの裏面に宛先のメールアドレスが表示されます。
  3. ロックを確認または選択します。現在の物件に有効なロックが 1 つしかない場合は、自動的に選択されます。
  4. 1 つのキーで複数のロックへのアクセスを付与するには、ロックセレクターの隣にある Multiple locks をオンにし、含めるすべてのロックにチェックを入れます。共有キーはスライドして開くリンクとして機能するため、このモードでは以下の単一ロック用のオプションは表示されません。
  5. Valid From と Valid Until を設定します。作成ボタンを押した時点で開始時刻を過ぎている場合、キーはその時点から有効になります。
  6. *（単一ロックのみ）* 必要に応じて Max uses を設定します。
  7. *（単一ロックかつ Link Key のみ）* 必要に応じて Authorization をオンにしてキーを特定の人に限定し、使用を許可する Authorized emails を入力します。オフの場合、リンクを持っている人は誰でも有効期間内に使用できます。
  8. Link Key（単一ロックのみ）では、必要に応じてリンクを自動的にメールで送信する宛先を入力します。Wallet Key（単一ロックまたは Multiple locks）では宛先を選びます。フィールドをクリックすると物件のユーザー一覧が開き、1 行目は検索ボックスです（名前またはメール）。該当するユーザーがいない場合は + ボタン（Create user）で名前とメールだけの短いフォームが開き、新しいユーザーが宛先になります。既にアカウントのあるメールの場合は、2 つ目のアカウントを作らずにその人を物件に追加します。Multiple locks がオンでも宛先はそのまま残り、Wallet Key は選択したすべてのロックに追加されます。
  9. Create Guest Key をクリックします（Multiple locks がオンの場合は Create Shared Key）。

12.2 ゲストキーを共有する

キーを作成すると、結果パネルにゲストキーのリンクが QR コードとして表示され、次の操作ができます。

  • QR コードをタップして裏返す。鍵のアイコンはゲストキーのリンクを開き、ダウンロードのアイコンはコードを画像として保存します。裏返したタイル（またはその隅の小さな矢印）をタップするとコードに戻ります。
  • Copy Link でゲストキーのリンクをコピーする。
  • メールの宛先を入力して Send Email をクリックする（ウィンドウが開いている間は再送信できます）。

共有（複数ロック）キーの場合、結果パネルにはコピー用のリンクと、そのキーで開けるロックの一覧が表示されます。

12.3 ゲストキーを更新する

  1. Keys を開き、ゲストキーのカードを見つけます。
  2. Update をクリックします。
  3. 有効期間を更新します。
  4. 変更を保存します。

12.4 ゲストキーを削除する

  1. Keys を開き、ゲストキーのカードを見つけます。
  2. Delete をクリックします。
  3. 操作を確定します。

12.5 共有（複数ロック）ゲストキーを管理する

Multiple locks で作成した共有ゲストキーは、他のキーと同様に Keys ページにカードとして表示されます。単一ロックのカードでロック名が表示される場所には Multiple と表示され、隅にロック数が示されます。ページ上部のフィルターに従うため、ページが Active で絞り込まれている間は、取り消し済みの共有キーは表示されません。

  1. カードをタップして裏返します。裏面には、キーで開けるロック、ステータス、有効期間が表示されます。
  2. 裏面で Open をクリックすると、ゲストアクセスページが表示されます。
  3. Revoke をクリックして確定すると、対象のすべてのロックで共有キーが無効になります。
セクション 13

Wallet Keys を管理する

Wallet Keys タブ（Keys の下）を開いて、Wallet Key の利用状況を確認します。

13.1 Wallet Key の残高を確認する

各所有者カードには次の情報が表示されます。

  • 空き（利用可能）の Wallet Keys
  • 割り当て済みの Wallet Keys
  • Wallet Keys の合計
  • 使用率／状態のインジケーター

13.2 Wallet Keys を購入する

このオプションは、権限のあるユーザーのみが利用できます。

  1. Wallet Keys タブを開きます。
  2. Buy Keys をクリックします。
  3. 必要な数量を入力します。
  4. Checkout をクリックして支払いを完了します。

Local Admin は Wallet Keys を購入できません。Community Manager に連絡する必要があります。

13.3 Wallet Keys を移動する

キーの移動が許可されている場合：

  1. Wallet Keys タブを開きます。
  2. Transfer to Local Admin で受け取り側を選択します。
  3. 数量を入力します。
  4. Transfer Keys をクリックします。

物件のどの管理者にも移動できます。受け取り側がその物件の Local Admin ロールを まだ持っていない場合は、移動の一環としてそのロールが付与されるため、キーはすぐに 使用できます。

13.4 Wallet Keys の出どころと、使い切ったときの動作

サブスクリプションプランには Wallet Keys が含まれています。Professional では 50、 Enterprise では 200 です。これらはアカウントに属し、キーを割り当てるたびに 1 つずつ消費されます。

  • 空きの Wallet Keys が 2 つ未満になると、ポータルを開いた時点で警告が表示され、

Buy Keys のショートカットが示されます。警告を閉じると非表示になり、残高が 回復した後に再び少なくなったときにのみ、もう一度表示されます。

  • 残りがない状態でキーを割り当てようとすると、サブスクリプションに空きの

Wallet Keys がないことが通知され、メッセージ内で Buy Wallet Keys が 提案されます。

  • Local Admin には購入ボタンが表示されません。Community Manager に連絡するよう

案内され、Community Manager が Wallet Keys を移動します。

セクション 14

物理 NFC キーをプログラムする

Physical Keys タブ（Keys の下）を開いて、物理 NFC カードのプログラムと取り消しを行います。このタブには 2 つの表示があり、一覧の上にある Assigned / Unassigned ボタンで切り替えます。

  • Assigned — 人が保有しているカードです。一覧はロックとステータス（プログラム済み、保留中、下書き、失敗、取り消し済み）で絞り込めます。カードは準備された時点から一覧に表示されるため、書き込みが確認されなかったカードも表示されたままになり、後で完了または再プログラムできます。Delivered 列は、ロックがキーを受け取ったかどうかを示します。Delivered、またはロックがオフラインの間は Pending です（11.8 を参照）。
  • Unassigned — 事前に書き込まれ、まだ誰も保有していないカードです（14.4 を参照）。ボタンには待機中のカードの数が表示されます。

開始する前に、プログラマーリーダーまたはロック内蔵のプログラマーが利用できることを確認してください。

14.1 新しい物理キーをプログラムする

  1. Physical Keys タブを開きます。
  2. Flash key をクリックして物理キーウィザードを開きます。
  3. ステップ 1 — ロックとユーザーを選択します。ユーザー欄は検索ボックスです。名前またはメールアドレスを入力し始めると、その下のリストが入力に合わせて絞り込まれ、各項目にはその人がこのロックで既に持っている物理キーの数も表示されます。欄の下の Show address にチェックを入れると、各人の住所が名前の上に表示され、住所でも検索できます。初期状態は Settings → Defaults に従います（23.5 を参照）。
  4. ステップ 2 — プログラミングデバイスを選択します（または Use lock built-in programmer のままにします）。
  5. カードの種類に合ったボタン（Flash MIFARE Classic または Flash DESFire EV3）で書き込みを開始します。
  6. 指示が表示されたら、NFC カードをプログラマーにかざします。
  7. デバイスの合図を待ちます。
  8. ポータルで Done をクリックします。
  9. カードがプログラム済みとして表示されることを確認します。

書き込み中にロックがオフラインの場合、ウィザードがその旨を表示します。カードはそれでも書き込まれ、ロックがオンラインに戻り次第、自動的にキーを認識します。それまでは、キーは Keys ページで Pending、Physical Keys 一覧の Delivered 列で Pending と表示されます（11.8 を参照）。カードを書き込む機器は別です。選択したプログラミング機器（またはロック自体の内蔵プログラマー）が Offline と表示されている場合、ウィザードは何も行う前に停止し、その機器がオフラインのため書き込みができないことを知らせます。接続可能なプログラマーを選ぶか、機器が戻るまでお待ちください。

選択したカードの種類（MIFARE Classic または DESFire EV3）はキーとともに保存され、キーカードと Physical Keys 一覧の Type 列に表示されます。

14.2 カードを消去して再プログラムする

再プログラムの際、ウィザードは消去ステップに続いて書き込みステップを実行します。

  1. 上記のとおりプログラミングウィザードを開始します。
  2. 消去ステップに従います。カードをかざし、Done をクリックします。
  3. 書き込みステップに従います。カードをもう一度かざし、Done をクリックします。

14.3 物理キーを取り消す

  1. Physical Keys タブを開きます。
  2. カードを見つけます。
  3. 取り消しアクションをクリックします。
  4. 必要に応じて取り消しの理由を入力します。
  5. 操作を確定します。

14.4 未割り当てキー：カードを事前に書き込む

Physical Keys タブを Unassigned に切り替えると、誰が保有するかが決まる前にカードをまとめて書き込んでおき、後で配布できます。各未割り当てキーは、ロック、書き込んだ日付、そして日付にかかわらずそのロック用に最後に書き込まれたカードから続く連番からなるキー名で一覧表示されます。`229/260914/1` は 2026 年 9 月 14 日にロック 229 用に書き込まれた 1 枚目のカード、`229/260914/3` は 3 枚目のカードで、翌日に書き込まれた次のカードは `229/260915/4` になります。一覧には、ロック、UUID、ロックがキーを受け取ったかどうか（Delivered: Delivered または Pending）、カードの種類、ステータス、カードが書き込まれた日時と書き込んだ人も表示されます。未割り当てキーはここにのみ表示され、Keys ページや Users ページ、ダッシュボードのタイルには表示されません。一覧は 1 ページに 50 件のキーを表示し、表の下のページリンクでページを移動できます。一覧の上の検索ボックスでは、キー名、ロック、UUID でキーを検索できます。

複数のカードを一度に書き込む

  1. Unassigned を開き、Flash unassigned keys をクリックします。
  2. ロック、カードの種類（MIFARE Classic または DESFire EV3）、プログラミングデバイス（または Use lock built-in programmer のまま）、Number of keys を選択します。必要に応じて Start number を入力します。入力すると、その実行の最初のキーにちょうどその番号が付き、以降のキーはそこから続きます。空欄のままにすると、そのロック用に最後に書き込まれたキーの続きから番号が付きます。その日にすでに使われているキー名になる開始番号は拒否されます。その後 Start flashing をクリックします。
  3. ウィンドウはカードを 1 枚ずつ順番に書き込みます。カードごとに、指示が表示されたらリーダーにかざして Done をクリックします。MIFARE Classic カードは、1 枚ずつの書き込みフローとまったく同じように、まず消去されてから書き込まれます（14.2 を参照）。
  4. 各カードの書き込み後、次のカードに進むには Next を、停止するには Abort をクリックします。Abort は実行を終了し、書き込んだキーの数を表示します。中止した時点で準備中だったカードは破棄されます。
  5. 最後のカードが完了すると、ウィンドウに書き込んだキーの数が表示されます。終了前にウィンドウを閉じた場合も、同じように実行が中止されます。

実行中にロックがオフラインでも、カードは書き込まれます。ロックへの登録はオフラインキューで待機し（11.8 を参照）、ロックがオンラインに戻るまで、各カードの Delivered には Pending が表示されます。

準備、消去、書き込み、破棄されたすべてのカードと、実行そのものが Logs に記録されます。

キーをユーザーに割り当てる

  1. 行をダブルクリック（またはダブルタップ）するか、キーの + アクションをクリックします。
  2. Assign to user ウィンドウで人を選びます。Give Access と同じ検索可能なリストで、Show address オプションがあります（11.2 を参照）。または Create User をクリックして追加します。ウィンドウにはロック、カードの種類、渡すキーも表示されます。Also add to locks では、キーで開けるロックを追加で選択できます（任意）。
  3. Assign をクリックします。その人がカードの保有者になり、キー名は表示されなくなり、キーはその人の他の物理キーとともに Assigned に一覧表示されます。Settings → Defaults の物理キーのデフォルト設定が、新しく発行されたカードと同じように適用され、割り当ては Logs に記録されます。追加のロックを選択した場合、キーは続いて Add to Another Lock と同じ方法でそれぞれのロックに追加されます。キーを追加できなかったロックはウィンドウに表示され、キーは割り当てられたままになります。

割り当てできるのは完全に書き込まれたカードのみです。まだ下書き、保留中、または失敗のカードは削除のみ可能です。ロックがオンラインである必要はありません。ロックがオフラインの間は受け渡しがキューに入り、ロックが戻るまで、キーはその人のキーの中で Pending と表示されます（11.8 を参照）。自身の配信がまだ Pending のカードも割り当てできます。その場合、保留中の登録はその人に引き継がれます。ロックが戻る前にキュー内の受け渡しを取り消すと（Keys ページの保留中キーの Cancel、またはその取り消しアクション）、カードは Unassigned ビューに戻ります。

複数のキーをまとめて操作する

キーのチェックボックスにチェックを入れます（またはヘッダーの Select all）。フローティングバーが表示され、選択したキーのうち書き込み済みのものには Assign to user、すべてのキーには Delete が使えます。

キーを削除する

行の削除アクション（またはフローティングバーの Delete）をクリックして確定します。カードはロックから削除され（ロックがオフラインの間は削除がキューに入り、オンラインに戻り次第実行されます）、一覧から消えます。配信がまだ Pending のカードを削除すると、代わりにその配信が取り消されます。削除は Logs に記録されます。

セクション 15

ロックを管理する

Devices → Locks を開いて、ロックの追加、操作、設定を行います。

15.1 ロックのステータス

ロックは次のいずれかの状態で表示されます。

  • Unclaimed
  • Claiming
  • Active
  • Inactive
  • Error

利用できる操作は現在のステータスによって異なります。有効なロックが通常の状態であるため、その場合カードにバッジは表示されません。それ以外のステータスは、ロック名の下にバッジとして表示されます。

ロック名の下には、ロックの種類（Matter ハブ経由で報告するロックの場合は Matter）と、ロックの実際の接続イベントに基づく接続インジケーター（Online または Offline）が表示されます。まだ接続を報告していないロックは Not connected と表示されます。ロックの ID、シリアル番号、ハブは Lock Details ウィンドウで確認できます（15.14 を参照）。

カードの上のフィルターボタンはリストを絞り込み、それぞれ件数を表示します：All、Unclaimed、Online、Offline、Not connected、Inactive、Error。3 つの接続フィルターはカードの接続インジケーターに従います。ボタンの横の検索欄は、入力した文字を名前に含むロックだけを残します。

15.2 ロックを追加する

  1. Devices → Locks を開きます。
  2. Add Lock をクリックします。
  3. ロックのシリアル番号を入力するか、バーコードアイコンをクリックしてカメラでシリアルをスキャンします。
  4. Matter コードを入力するか、QR アイコンをクリックしてカメラで Matter QR コードをスキャンします。
  5. Add をクリックします。

ロックは現在選択中の物件に追加されます。カメラでのスキャンには、カメラ付きのデバイスとその使用許可が必要です。代わりに手動で値を入力することもできます。

15.3 ロックをリモートで開ける

  1. Devices → Locks を開きます。
  2. 有効なロックを見つけます。
  3. Open をクリックします。
  4. 確認ウィンドウでステータスを確認し、Open Lock で確定します。

ポータルはまず解錠コマンドを送信したことを表示し、その後ロック自体が解錠したと報告するまで待ちます。通常は数秒で完了します。続いて、ロックが解錠されたこと、またはロックが解錠を確認しなかったことが表示されます。後者の場合は、ロックがオンラインであることを確認して、もう一度お試しください。

ボタンが一時的に利用できない場合は、カウントダウンが終わるまで待ってから再試行してください。

15.4 ロックの名前を変更する

  1. Devices → Locks を開きます。
  2. ロックを見つけます。
  3. ロック名の隣にある鉛筆（名前変更）アイコンをクリックします。
  4. 新しい名前を入力します。
  5. 変更を保存します。

15.5 ロックをプログラマーリーダーに設定する

互換性のあるリーダーを NFC カードのプログラムに使用する場合に、この手順を使用します。

  1. Devices → Locks を開きます。
  2. 目的のロックを見つけます。
  3. ロックの操作メニューを開いて Lock Details を選択します。
  4. Maintenance ページを開きます。タイトルの下のタブ列にあるレンチのアイコンです（どのページが開いているかはタイトルに表示されます）。
  5. Set as Programmer を選択します（無効にするには Unset Programmer）。

15.6 ロックを登録する

  1. Devices → Locks を開きます。
  2. 未登録のロックを見つけます。
  3. 操作メニューを開いて Claim Lock を選択します。
  4. 操作を確定します。

15.7 ロックを無効化する

  1. Devices → Locks を開きます。
  2. 有効なロックを見つけます。
  3. 操作メニューを開いて Lock Details を選択し、Maintenance ページ（レンチのアイコン）を開きます。
  4. Deactivate Lock を選択します。
  5. Deactivate で確定します。
  6. ロックにまだ有効なキーがある場合、ウィンドウにその旨が表示され、ボタンが Force Deactivate に変わります。クリックすると、ロックはそのまま無効化されます。キーは取り消されるか、ロックが削除されるまで（15.9）紐付いたまま動作し続けます。

15.8 ロックを再有効化する

  1. Devices → Locks を開きます。
  2. 非アクティブなロックを見つけます。
  3. Reactivate をクリックします。
  4. 操作を確定します。

15.9 ロックを削除する

  1. Devices → Locks を開きます。
  2. 対象となる未登録または非アクティブのロックを見つけます。
  3. Remove をクリックします。
  4. 警告をよく読み、What will be withdrawn の一覧を確認します。
  5. Remove Lock で確定します。
  6. 削除の実行中はウィンドウを開いたままにしてください。ステータスバーに各ステップが表示されます。概要は Done で閉じます。

ロックを削除するとアカウントから解放されますが、その前に、ロックに送信されたものがすべて SmartKey から取り消されます。対象は、各ユーザーのモバイルアプリと QR インターホンのアクセス、ロック上のすべてのキー（Wallet Keys とその他のデジタルキー、物理カード、事前に書き込まれたカード）、ゲストキー、このロックを開ける共有ゲストキー、このロックを使用するシナリオ（削除されます）、カメラのリンク（カメラ自体は残ります）です。ほかのロックも開ける共有ゲストキーは、それらのロック向けに再発行され、概要に新しいリンクが表示されます。ロックがオフラインの場合、キーの削除はロックが再びオンラインになるまで待機し、その後自動的に送信されます。モバイルアプリと QR インターホンのアクセス、およびゲストキーはすぐに取り消されます。すべてが取り消されると、ロックはキーが一つもない（内蔵キーも含む）未登録デバイスとしてシステムに登録されたままになるため、後でシリアル番号とペアリングコードを使って再度追加できます。

取り消せないものがある場合、ロックは削除されません。ロックは非アクティブのままアカウントに残り、概要に失敗した項目が表示されます。再試行するには、もう一度 Remove をクリックしてください。すでに取り消された項目はそのまま残ります。削除中にウィンドウを閉じた場合は、Remove から Continue the removal を選べます。

15.10 ロックを別の物件に送る

  1. Devices → Locks を開きます。
  2. ロックを見つけます。
  3. 操作メニューを開いて Send to Another Entity を選択します。
  4. 送り先の物件を選択します。
  5. 移動を確定します。

15.11 ロックからユーザーを削除する

  1. Devices → Locks を開きます。
  2. ロックを見つけます。
  3. 操作メニューを開いて User List を選択します。
  4. 目的のユーザーを見つけます。
  5. Remove をクリックします。
  6. 操作を確定します。

これにより、そのロックに紐付くユーザーのアクセスが削除されます。

Users on ウィンドウのフッターにある Keys ボタンをクリックすると、このロックで絞り込まれた Keys ページが開き、同じ人たちをキーとして確認できます。

15.12 ロックを Wi-Fi に接続する

Bluetooth 経由で、ポータルから近くのロックに Wi-Fi の認証情報を直接送信できます。これには Web Bluetooth に対応したブラウザー（たとえばデスクトップまたは Android デバイスの Chrome や Edge、あるいは iPhone の Bluefy – Web BLE Browser）と、ロックの近くにいることが必要です。

  1. Devices → Locks を開きます。
  2. ロックを見つけて Configure Wi-Fi を選択します。
  3. ブラウザーのプロンプトで、Bluetooth 経由でロックとペアリングすることを確認します。
  4. SSID（ネットワーク名）を入力します。Scan Wi-Fi をクリックしてロックにネットワークを検索させることもできますが、ネットワーク名は手動で入力します。
  5. Wi-Fi password を入力します。
  6. Connect Lock to Wi-Fi をクリックし、成功または失敗のメッセージを待ちます。

パスワードは Bluetooth 経由でロックに直接送信され、ポータルには保存されません。

15.13 ロックを Matter ハブに接続する

物件に Matter ハブがある場合、登録済みのロック（リーダー）を、ロックカードから直接 Thread 経由でハブにペアリングできます。ロックは従来どおり動作します。この操作はロックをハブに紐付けるだけで、ロックの制御は引き続き SmartKey サービスを通じて行われます。

  1. Devices → Locks を開きます。
  2. ロックを見つけて、そのメニューから Connect to Matter Hub を選択します。
  3. ハブを選びます。物件にハブが 1 つしかない場合は自動的に選択されます。ハブがまだない場合は、先にハブを登録する必要があることがウィンドウに表示されます。
  4. 画面の指示に従ってリーダーをペアリングモードにし、Next をクリックします。ロックに保存されているペアリングコードが自動的に使用されます。ロックにコードがない場合は、リーダーの Matter ペアリングコードを入力します。
  5. ハブがリーダーをペアリングする間、待ちます。これには数分かかることがあります。ウィンドウにはリアルタイムの進行状況が表示され、その後、成功、ハブがビジー、ハブがオフライン、またはタイムアウトのいずれかが報告されます。
  6. 成功すると、ロックカードにロックの種類として Matter が表示され、Lock Details ウィンドウにハブ名が表示されます。

ロックが Matter ハブ経由で接続されている間、カードにはロックの種類として Matter が表示されます。これには、Matter デバイスとしてコミッショニングされて自動的に Locks に移動したリーダーも含まれます。ハブ名と Thread の信号は Lock Details ウィンドウに表示されます。カードのオンライン／オフラインのインジケーターは、実際に使われている接続に従います。ハブ経由で報告するリーダーはハブ側のステータスを示し、LTE または Wi-Fi に戻したロックは再び自身の接続に従います。ロックが自身の LTE または Wi-Fi 接続に戻ると、カードには再びロック自身の種類（例：Smart Lock）が表示され、Lock Details ウィンドウでは Matter ハブが Not connected と表示されます。ロックが再びハブ経由で報告すると、Matter の表示は自動的に戻ります。

15.14 ロックの詳細と QR コード

ロックのメニュー（カードの隅にある 3 つの点）から Lock Details を選択すると、カードにないすべての情報が表示されます。物件、SmartKey のロック ID、シリアル番号、ステータス、接続状態（オンライン／オフラインと最後に変化した日時）、ロックが報告に使用する Matter ハブ、場所、および紐付けられたカメラです。同じウィンドウは、キーカードの裏面にある Lock Details ボタンからも開けます（セクション 11）。このウィンドウはタイトルの下のアイコンでページを切り替えます。Overview（情報アイコン）、Linked Cameras（カメラアイコン。カメラを管理している場合）、そしてロックを管理している場合は Maintenance（レンチのアイコン）で、開いているページの名前がタイトルに表示されます（例:「Maintenance — Front Door」）。Maintenance ページでは Set as Programmer（15.5）、Replace Lock（15.15）、Deactivate Lock（15.7）を利用できます。Linked Cameras ページでは既存のカメラを紐付けます。カメラ自体は Cameras ページで作成します。

シリアル番号のあるすべてのロックは、カードの右側に QR インターホンコードを表示します。これは、管理者がロックの設定から印刷するのと同じコードです。コードをタップするとタイルが裏返ります。

  • カメラアイコンは、そのコードのリンク先ページ、つまり訪問者がドアでコードをスキャンしたときに開くページを開きます。
  • ダウンロードアイコンは、ロック名、シリアル番号、QR コードを含む、印刷用の PDF を保存します。

タイルをもう一度タップすると元に戻ります。

15.15 ロックを置き換える、またはコピーする

ロックを新しいデバイスに交換する場合や、2 台目のロックに既存のロックと同じ設定を適用する場合に、この手順を使用します。

  1. Devices → Locks を開き、ロックのメニューを開いて Lock Details を選択します。
  2. Maintenance ページ（レンチのアイコン）を開き、次に Replace Lock をクリックします。
  3. スイッチで操作を選択します。
    • Replace — すべてが対象のロックに移動し、その後、古いロックからすべてのキーとアクセスが削除されて、古いロックは無効化されます。対象のロックは New lock name に入力した名前（変更しなければ古いロックの名前）を引き継ぎ、その名前を引き継いだ場合、古いロックの名前には「(replaced)」が付きます。
    • Copy — すべてが対象のロックにも追加されます。古いロックはそのまま残ります。
  4. Target lock（同じ物件の有効なロック）を選択するか、Add a new lock をクリックして新しいデバイスのシリアル番号と Matter コードを入力します。ロックはその場で登録され、対象として選択されます。
  5. New lock name 欄を確認します。移行後に対象のロックが持つ名前です（Replace モードでは古いロックの名前、Copy モードでは対象のロック自身の名前）。必要に応じて変更します。
  6. What will be transferred の一覧を確認し、Replace Lock（または Copy to Lock）をクリックします。

移動される内容：ロックの場所、住所、タイムゾーン、営業時間外アラートの設定、ポータルユーザー、追加の物件、ロックに限定されたロールの付与、プログラマーリーダーのフラグ、週間スケジュール（新しいロックにも送信されます）、保有者付きのすべてのキー（Wallet Keys とその他のデジタルキー、物理キー、QR インターホンアクセス、ゲストキー）と各保有者が持つモバイルアプリおよび QR インターホンのアクセス、共有（複数ロック）ゲストキー、そして新しいロックが同じ Matter ハブに接続されている場合は、そのロックを使用するシナリオです。Replace モードではリンクされたカメラも新しいロックに移動します。カメラは 1 台のロックにのみリンクできるため、Copy モードではそのまま残ります。

移動の実行中、ウィンドウには現在のステップと、完了・スキップ・失敗したステップの数を示すステータスバーが表示されます。完了するまでウィンドウを開いたままにしてください。キーのコマンドは短い間隔を空けて 1 件ずつ送信されるため、キーの多いロックでは数分かかります。途中でウィンドウを閉じたり接続が切れたりした場合は、Replace Lock を再度開くと、停止したステップから Continue the transfer できます。

最後に、実行された内容、スキップされた内容とその理由、失敗したステップの概要が表示されます。ゲストキーと共有ゲストキーは新しいロックで新しいリンクとともに再発行されます。メールで送信されていたゲストキーは新しいリンクで再度メールされ、その他の新しいリンクは概要に表示されます。すべては Logs → Audit タブに記録されます。各ロックに Replace Lock / Copy Lock のエントリが 1 件ずつ、加えて通常のキー、アクセス、ゲストキーのエントリが記録されます。

セクション 16

週間ロックスケジュールを設定する

スケジューラーを使って、曜日ごとのアクセス時間帯を定義します。

16.1 スケジュールを設定する

  1. Devices → Locks を開きます。
  2. 目的のロックを見つけます。
  3. Scheduler をクリックします。
  4. 曜日を選択します。
  5. 1 つ以上の時間帯を追加します。
  6. 残りの曜日についても繰り返します。
  7. スケジュールを保存します。変更をすぐにロックに反映したい場合は、デバイスにも同期する保存オプションを使用します。
  8. デバイスに同期すると、ロックがスケジュールを段階的に取り込む間、ポータルに進行状況が表示されます。スケジュールが適用されたと報告されるまでスケジューラーを開いたままにしてください。途中でロックが停止した場合は、どのステップで失敗したかがポータルに表示されます。

16.2 デバイスのスケジュール状態を更新する

  1. ロックのスケジューラーを開きます。
  2. 状態の更新アクションをクリックします。
  3. ポータルがデバイス情報の読み込みを終えるまで待ちます。
  4. ポータルに表示されたスケジュールを確認します。
セクション 17

ハブを管理する

Devices → Hubs を開いて、Matter ハブを管理します。

各ハブのヘッダーには 2 つのインジケーターが表示されます。ハブのライフサイクルステータス（たとえば Claimed や Suspended）と、リアルタイムの接続インジケーター（Online、Offline、またはハブがまだ接続を報告していない間は Unknown）です。接続インジケーターはハブの実際の接続イベントを反映し、ライフサイクルステータスとは独立しています。

17.1 ハブを追加する

  1. Devices → Hubs を開きます。
  2. Add Hub をクリックします。
  3. 必要に応じてハブ名を入力します。
  4. 物件を選択します。
  5. 所有者を選択します。
  6. ハブの UUID を入力します。
  7. Add Hub をクリックします。

17.2 ハブの状態を更新する

  1. Devices → Hubs を開きます。
  2. Refresh をクリックします。

17.3 ハブの名前または役割を変更する

  1. Devices → Hubs を開きます。
  2. ハブを見つけて Edit Hub を開きます。
  3. 名前を更新するか、Primary hub スイッチでプライマリまたはセカンダリに設定します。
  4. Save をクリックします。

17.4 ハブを停止する

  1. Devices → Hubs を開きます。
  2. ハブを見つけて Suspend を選択します。
  3. 理由を入力します。
  4. 操作を確定します。

17.5 ハブを再登録または移動する

ハブを別の対象物件または所有者に割り当てるには、この操作を使用します。

  1. Devices → Hubs を開きます。
  2. ハブを見つけて Re-claim を選択します。
  3. 移動先の物件を選択します。
  4. 所有者を選択します。
  5. 理由を入力します。
  6. 操作を確定します。

17.6 Matter デバイスをコミッショニングする

  1. Devices → Hubs を開いて Commission Device を選択するか、Devices → Matter を開いて Add Device をクリックします。
  2. ハブを選択します。
  3. *（任意）* デバイスが Wi-Fi 経由で接続する場合は、Matter over Wi-Fi をオンにします。次に、保存済みの Wi-Fi profile を選ぶか、新しい Wi-Fi network name (SSID) と password を入力します（パスワードは表示／非表示を切り替えられます。Save this network as a reusable Wi-Fi profile にチェックを入れると、この物件で後で再利用できます）。Wi-Fi の認証情報が不要なデバイスでは、スイッチをオフのままにします。
  4. コミッショニングコードを入力するか、カメラで Matter QR コードをスキャンします。
  5. Commission をクリックします。Matter over Wi-Fi がオンの場合、ウィンドウは Wi-Fi の認証情報を保存し、少し待ってからコミッショニングを開始します。処理中、ボタンには Saving Wi-Fi、Preparing commissioning、Commissioning の順に表示されます。
  6. デバイスが Matter タブに表示されるまで待ちます。

Matter over Wi-Fi がオンの場合：Wi-Fi の認証情報を保存しても、パスワードが正しいかどうかは検証されません。デバイスはペアリング中に接続をテストします。Wi-Fi ネットワークの保存に失敗した場合、コミッショニングは開始されず、ネットワークを修正して再試行できます。後でデバイスがネットワークに接続できない場合は、SSID、パスワード、信号強度、ネットワークの到達性を確認するよう求めるメッセージが表示されます。

ペアリングに失敗した場合、デバイスカードには平易な言葉で短い説明（たとえば、デバイスが時間内に応答しなかったなど）が表示されます。技術的なエラーの詳細は、バックオフィスとデバイスのイベントログで管理者が引き続き確認できます。

コミッショニングしたデバイスが SmartphoneKey のロックリーダーである場合、それは Locks セクションに属するため、自動的にそこへ移動します。約 30 秒間、Matter タブにそのデバイスの Transferring to Locks カードが表示され、その後デバイスは Devices → Locks の下に、すぐに使える状態で表示されます。所属する物件に登録され、リーダーの名前が付けられます。同じリーダーを再度ペアリングすると、処理中は Matter タブに通常の Commissioning… カードが表示されます。

セクション 18

Matter デバイスを管理する

Devices → Matter を開いて、ハブ経由でコミッショニングされたデバイスを確認します。

18.1 Matter デバイスを確認する

一覧には次の情報が表示されることがあります。

  • デバイス名または UUID
  • ハブ
  • 物件
  • デバイスの種類
  • ステータス
  • 稼働状況（Online、Offline、またはデバイスが存在を報告するまでは Unknown。Matter-Zigbee ゲートウェイ配下のデバイスはゲートウェイの到達性レポートに従い、ゲートウェイ自体がオフラインの間は、そのゲートウェイのすべてのデバイスがオフラインと表示されます）
  • 割り当て先ユーザー
  • イベント
  • バッテリー、信号、温度、湿度、在室、その他の利用可能な値

各デバイスカードには、Matter デバイスの種類に対応するアイコンが表示されます。これは SmartphoneKey モバイルアプリと同じアイコンセットです。スイッチ可能なデバイス（照明、プラグ、スイッチ）は報告されたオン／オフの状態を表示し、煙感知器は、相互接続された他の感知器から受信したアラームを含むアラームの状態を表示します。

ペアリングの試行が失敗した場合、カードにはしばらくの間、簡潔な説明が表示され、その後メッセージは自動的に消えます。失敗の記録は Logs → Activity とデバイスの詳細に、必要な限り残ります。すでにペアリング済みのデバイスをペアリングした場合も、同じ一時的なメッセージが表示されます。

18.2 Matter デバイスをユーザーに割り当てる

  1. Devices → Matter を開きます。
  2. デバイスを見つけます。
  3. Assign をクリックします。
  4. ユーザーを選択します。
  5. 割り当てを確定します。

ボタンが無効になっている場合は、ポータルに表示されるメッセージを確認してください。

18.3 ユーザーとデバイスの割り当てを解除する

  1. Devices → Matter を開きます。
  2. 割り当て済みのデバイスを見つけます。
  3. 割り当ての詳細を開きます。
  4. Remove をクリックします。
  5. 操作を確定します。

18.4 デバイスのイベントを表示する

  1. Devices → Matter を開きます。
  2. デバイスを見つけます。
  3. イベントまたは詳細を開きます。
  4. 利用可能なイベント履歴を確認します。

18.5 Matter デバイスをポータルから削除する

  1. Devices → Matter を開きます。
  2. デバイスを見つけます。
  3. 削除アクションを選択します。
  4. 操作を確定します。

Matter デバイスの場合、ポータルはまずハブにデバイスのペアリング解除を依頼し、その後レコードを削除します。Zigbee ゲートウェイ経由で接続されたデバイスはリモートでペアリング解除できません。ポータルのレコードだけが削除され、デバイスはリセットされるまでゲートウェイとペアリングされたままになります。

削除の実行中、アクションは Removing と表示され、再度開始することはできません。ペアリング解除には数秒かかり、同じデバイスのペアリング解除をハブに 2 回依頼してはならないためです。

ゲートウェイを削除すると、そのゲートウェイ経由で接続されているすべての Zigbee デバイスも削除されます。これらのデバイスはゲートウェイ経由でしか到達できないためです。確認ダイアログにはゲートウェイの名前と、一緒に削除される接続デバイスの数が表示されます。ハブの削除も同じように動作します。ゲートウェイとその配下の Zigbee デバイスを含め、そのハブでコミッショニングされたすべてのデバイスが一緒に削除されます。

重要：ポータルからデバイスを削除しても、物理デバイスが工場出荷時の状態にリセットされるとは限りません。必要に応じて、別途リセットまたは廃止してください。

18.6 Matter デバイスを操作する

一部の Matter デバイスは、ロールで許可されていてデバイスが対応している場合、ポータルから操作できます。

  1. Devices → Matter を開きます。
  2. デバイスを見つけます。
  3. デバイスカードに表示されるコントロールを使用します。
    • ボタン（たとえば、デバイスのオン／オフ）。
    • スライダー（明るさなどのレベルに対応するデバイス用）。スライダーはデバイスが最後に報告したレベルを反映し、デバイスがオンの間、カードには明るさのパーセンテージが表示されます。

コントロールは、操作可能な機能を報告するデバイスにのみ表示されます。それ以外のデバイスは、コントロールなしで現在の状態を表示します。

18.7 開閉センサーの開／閉表示を反転する

開閉センサーが、取り付け方向と逆に開と閉を報告する場合に、この手順を使用します。

  1. Devices → Matter を開きます。
  2. 開閉センサーのデバイスを見つけて Edit を開きます。
  3. Invert Open/Closed display をオンにします。
  4. 変更を保存します。

これにより、ポータルはそのデバイスの開と閉のラベルを入れ替え、表示される状態がドアや窓の実際の状態と一致するようになります。

18.8 Matter-Zigbee ゲートウェイ配下の Zigbee デバイス

一部の Matter デバイスは、Zigbee デバイスを中継するゲートウェイです（たとえば Matter-Zigbee ハブ）。このようなゲートウェイをコミッショニングすると、ポータルはそれをサブハブとして表示します。親ハブの下にネストされたハブ形式のヘッダーで、独自の稼働状況、詳細パネル、操作を持ちます。

  • ゲートウェイに接続された Zigbee デバイスは、ハブに直接コミッショニングされたデバイスとは別に、ゲートウェイのヘッダーの下に一覧表示されます。
  • 新しい Zigbee デバイスがゲートウェイに参加すると、ゲートウェイの下に自動的に表示されます。ポータルでの追加のコミッショニング手順は不要です。
  • すでにゲートウェイに接続されていた Zigbee デバイスは、状態を報告した時点で自動的に取り込まれます。
  • Zigbee デバイスの情報ウィンドウには、そのゲートウェイと Zigbee エンドポイントが表示されます。
  • ゲートウェイは各 Zigbee デバイスのメーカー、モデル、シリアル番号、およびゲートウェイで設定された名前を報告し、ポータルはこれらの詳細を自動的に入力します（ポータルで自分が設定した名前が上書きされることはありません）。
  • Zigbee デバイスのオンライン／オフラインのインジケーターは、そのデバイスに関するゲートウェイの到達性レポートに従います。ゲートウェイ自体がオフラインの間は、そのすべての Zigbee デバイスがオフラインと表示されます。
  • ポータルからゲートウェイを削除すると、その Zigbee デバイスも削除されます。これらはゲートウェイを通じてのみポータルに存在するためです。
  • ゲートウェイは一度に 1 つのハブにしか追加できません。まだ別のハブに追加されている場合、ペアリングは拒否され、カードにはそのハブから先に削除するよう表示されます。ゲートウェイの Zigbee デバイスはそのハブに残るため、そうしないとそこに取り残されてしまいます。
セクション 19

カメラを管理する

Cameras（Cameras タブ）を開いて、カメラを追加・管理します。ステータスで絞り込んだり、グリッドの密度を選んだりできます。

19.1 カメラを追加する

  1. Cameras を開きます。
  2. Add Camera をクリックします。
  3. カメラ名を入力します。
  4. カメラの種類を選択します。
  5. 物件を選択します。
  6. 必要に応じて所有者を選択します。
  7. 必要な接続情報を入力します。
    • RTSP カメラの場合は、RTSP URL を入力します。
    • HTTP カメラの場合は、HTTP URL を入力します。
    • Push Module カメラの場合は、カメラに印刷されている（またはプッシュモジュールから提供される）登録コードと、管理者のログイン名およびパスワードを入力します。
    • その他の対応カメラの種類では、必要なログイン名とパスワードを入力します。
    • フォームに RTSP URL フィールドが表示されている場合、完全なリンク（たとえば `rtsp://login:password@192.168.1.10:554/stream?channel=1`）を貼り付けると、そこからログイン名、パスワード、HTTP URL、カメラ名が自動入力されます。自分で入力した内容はそのまま保持されます。
  8. 必要に応じて、同じ物件内の紐付けるロックを選択します（Push Module カメラは作成後にロックへ紐付けできます）。
  9. Create をクリックします。

RTSP カメラの場合、フォームには Camera access セクションもあり、作成時にカメラをユーザーと共有できます。ユーザー欄で人を選び（Manage access と同じ検索ボックスで（19.9 を参照）、Show the address when choosing a user がオンなら住所の行が表示されます）、プラスボタンをクリックします。人ごとに繰り返します。サブスクリプションに Video archive オプションが含まれている場合は、人を追加する前に Add a manager role にチェックを入れると、Viewer（ライブ映像のみ）ではなく Manager（ライブ映像と録画）のロールを付与できます。欄の下のリストにはアクセスを受け取る人とそのロールが表示され、× で削除できます。

19.2 カメラのストリームを表示する

  1. Cameras を開きます。各タイルにはそのカメラの最後のフレームが表示されるので、何かを開く前に各カメラが何を見ているか分かります。まだフレームを送っていないカメラはプレースホルダーのままです。
  2. カメラをクリックしてウィンドウを開きます。映像を再生するまで、プレーヤーには同じ最後のフレームが日時付きで表示されます。
  3. Play Live を押すとライブ映像になります。

ウィンドウのプレーヤーは 1 つです。下の Archive ブロックの録画も同じプレーヤーで再生され、ブロックのタイトルが Live Video から Archive に変わります。Play Live を押すとライブに戻ります。

19.3 カメラを更新する

  1. Cameras を開きます。
  2. カメラを見つけます。
  3. Edit をクリックします。
  4. 必要なフィールドを更新します。
  5. Save をクリックします。

19.4 カメラをロックに紐付ける

  1. Cameras を開きます。
  2. カメラを見つけます。
  3. Link をクリックします。
  4. 同じ物件内の有効なロックを選択します。
  5. 操作を確定します。

19.5 カメラとロックの紐付けを解除する

  1. Cameras を開きます。
  2. カメラを見つけます。
  3. 紐付け解除アクションを選択します。
  4. 操作を確定します。

19.6 カメラを無効にする

  1. Cameras を開きます。
  2. カメラを見つけます。
  3. Disable を選択します。
  4. 理由を入力します。
  5. 操作を確定します。

19.7 カメラを削除する

  1. Cameras を開きます。
  2. カメラを見つけます。
  3. Delete を選択します。
  4. 操作を確定します。

19.8 RTSP カメラのストリームを開始または停止する

  1. Cameras を開きます。
  2. RTSP カメラを見つけます。
  3. 操作メニューを開きます。
  4. Start stream または Stop stream を選択します。

19.9 RTSP カメラへのアクセスを共有する

カメラを共有する相手には、次の 2 つのロールのいずれかが付与されます:

  • Viewer — ライブ映像を視聴できます。
  • Manager — ライブ映像と録画された映像（アーカイブ）を視聴できます。

Manager ロールは、録画そのものと同じく、サブスクリプションの Video archive オプションに含まれます（19.11 を参照）。このオプションがない場合、カメラを共有する相手はすべて Viewer となり、ダイアログにはマネージャーにはこのオプションが必要であることが表示されます。

  1. Cameras を開きます。
  2. RTSP カメラを見つけます。
  3. Manage access を選択します。
  4. カメラを Manager として共有するには Add a manager role にチェックを入れます。Viewer として共有する場合はチェックを入れません。
  5. ユーザーを選択します。ユーザー欄は検索ボックスで、名前、メールアドレス、または電話番号を入力し始めると、その下のリストが入力に合わせて絞り込まれます。Settings → Defaults で Show the address when choosing a user がオンの場合（23.5 を参照）、各人の住所が名前の上に表示され、住所でも検索できます。
  6. ユーザーを追加してアクセスを共有します。
  7. すでにアクセス権を持つ人のロールを変更するには、名前の横で Viewer または Manager を選択します。
  8. アクセスを削除するには、ユーザーの隣で取り消します。

ある住所に住む全員と一度にカメラを共有するには、Grant by address をオンにします。住所を選び、あらかじめ選択された居住者を確認して（その住所の全員が最初からチェックされています。除外したい人はチェックを外します）、まとめて追加します。 Add a manager role のチェックは、これらの人にも適用されます。

サブスクリプションから Video archive オプションがなくなると、すべての Manager は自動的に Viewer に切り替わり、リストにはサブスクリプションにオプションが含まれると再びマネージャーになることが表示されます。オプションが戻ると、誰もカメラを共有し直すことなく Manager ロールに戻ります。

19.10 カメラの状態

すべての RTSP カメラのタイルには左下に状態チップがあり、カメラのウィンドウには同じ状態が報告時刻とともに表示されます。状態は、ビデオボックスがカメラについて今まさに報告している内容です:

  • Live — カメラは配信中です。
  • Ready — 誰も視聴していないため、ボックスが映像を一時停止しています。最初の Play Live で再開します。正常なカメラです。
  • Connecting / Restarting — ボックスが映像を起動しています。少しお待ちください。
  • Picture frozen / No picture — ボックスがカメラから利用できる映像を受け取れていません。カメラと接続設定を確認してください。
  • Setting up — 追加したばかりのカメラをビデオボックスに接続しています。通常は 1 分以内に終わります。Setup failed で終わった場合は、理由と Retry ボタンが表示されます。
  • Reconnecting — カメラを載せているビデオボックスが再起動したところです。カメラは数分以内に自動的に復帰します。
  • Not placed / Not running — カメラがどのビデオボックスにも割り当てられていないか、ボックスがカメラを実行していません。もう一度開始するには Retry を押します。
  • Video box silent — ビデオボックスからの報告が途絶えました。復旧するまで映像を表示できない場合があります。
  • Stopped — Stop stream でストリームが停止されています。再開するには Start stream を選びます(19.8 を参照)。

それ以外の値は、ボックスが報告したとおりに表示されます。状態の横の時刻(「5 分前」)は、ボックスが最後に報告した時刻を示します。カメラのウィンドウのプレビューは最後にキャプチャされたフレームで、その経過時間が表示されます。Cameras ページを開いている間、状態は自動的に更新されます。ビデオサービスが変化をその都度報告するため、ページを再読み込みする必要はありません。

19.11 RTSP カメラの映像を録画する

録画は、サブスクリプションパッケージの Video archive オプション(3、7、14 または 30 日)に含まれます。このオプションがない場合、カメラウィンドウの Recording ブロックはロックされ、Unlock でサブスクリプションページが開きます。

  1. Cameras を開き、RTSP カメラを開きます。
  2. Recording ブロックで録画映像の保存期間を選びます — Off、またはパッケージで許可された範囲の日数 — そして Save をクリックします。
  3. 録画には実行中のストリームが必要です。カメラが停止しているか、まだ設定中の場合は、先に Start stream で開始してください。

アーカイブに保持しようとする日数より多くの映像がすでにある場合、ポータルは保存前に警告し、2 つの方法を提示します。すべて保持する(保存期間をアーカイブ全体を含むように引き上げる)か、古い映像を削除して短い期間を保持するかです。録画をオフにしても何も削除されません。すでに録画された映像は期限が切れるまで残ります。録画中のカメラのタイルには、日数を示す赤いチップが表示されます。 パッケージからオプションがなくなった時点でカメラがすでに録画していた場合、ロックされたブロックは保持している日数を示し、Turn recording off を用意します。

19.12 録画映像を見る（アーカイブ）

アーカイブは録画と同じ Video archive オプションに含まれます。パッケージにこのオプションが含まれていると、RTSP カメラのウィンドウの Recording の下に Archive ブロックが表示されます。

  1. Cameras を開き、RTSP カメラを開きます。
  2. Archive ブロックで日付を選びます。その下のバーはその日の 24 時間です。緑の区間は録画された映像、空白は何も録画されなかった時間です（ストリームが停止していた、カメラがスタンバイだった、または映像の期限が切れた場合）。
  3. バー上の時点をクリックします。プレーヤーはその時点から再生を始めます。空白をクリックすると、次の録画区間から始まります。

再生は最長 1 時間の区切りで進み、その日の次の区間へ自動的に続きます。バー上の赤いカーソルが現在位置を示します。Stop で再生を終了します。 録画はウィンドウのプレーヤーで再生され、その間タイトルは Archive になります。視聴した区切りはそれぞれ Logs に記録されます。日付と時刻はお使いのコンピューターの時計に従い、アーカイブはパッケージが保持する日数だけさかのぼれます。

セクション 20

カメラロールを管理する

カメラロールは、どのユーザーが選択したカメラにアクセスでき、何ができるかを定義します。

20.1 カメラロールを作成する

  1. Cameras を開きます。
  2. Camera Roles タブを開きます。
  3. Create Role をクリックします。
  4. ロール名を入力します。
  5. 説明を入力します。
  6. 物件を選択します。
  7. Create Role をクリックします。

20.2 ロールにカメラを追加する

  1. 目的のカメラロールを開きます。
  2. Add Camera をクリックします。
  3. 同じ物件内のカメラを選択します。
  4. 少なくとも 1 つの権限を選択します。
  5. Add をクリックします。

20.3 ロールからカメラを削除する

  1. カメラロールを開きます。
  2. カメラを見つけます。
  3. Remove を選択します。
  4. 操作を確定します。

20.4 ユーザーをカメラロールに割り当てる

  1. 目的のカメラロールを開きます。
  2. Add User をクリックします。
  3. 同じ物件内のユーザーを選択します。
  4. 割り当てを確定します。

20.5 カメラロールからユーザーを削除する

  1. カメラロールを開きます。
  2. ユーザーを見つけます。
  3. Remove を選択します。
  4. 操作を確定します。

20.6 カメラロールを削除する

  1. Camera Roles タブを開きます。
  2. ロールを見つけます。
  3. Delete を選択します。
  4. 操作を確定します。
セクション 21

アクティビティログを確認する

Logs → Activity を開いて、アクセスイベントを確認します。

21.1 日常的な監視

デフォルトでは、アクティビティ一覧は次のような最も関連性の高いアクセスイベントに絞られています。

  • キーが受け入れられた
  • ロックが解錠された
  • 解錠未確認
  • キーがロックに追加された
  • キーがロックから削除された

リモート解錠は、ロック自体が解錠したと報告して初めて Lock Unlocked として表示されます。それまでの間、またロックが最後まで確認しなかった場合、リクエストは送信した人とともに Open Not Confirmed として表示されます。

21.2 詳細情報

より詳しいイベント情報が必要な場合は、フィルターバーの Advanced トグルを有効にします。

21.3 アクティビティログを絞り込む

利用できるフィルターには次のものがあります。

  • ロック
  • イベントの種類
  • 日付範囲（開始／終了）
  • キー UUID
  • ユーザーのメールアドレス
  • 場所
  • 詳細設定トグル

フィルターを適用すると一覧が更新されます。

フィルターの上にある Search ボックスでは、1 つの検索語でイベントを探せます。ユーザーの名前、メールアドレス、電話番号、住所、UUID（デバイス、ユーザー、キーのいずれか）、デバイスの名前またはシリアル番号が対象です。電話番号と住所は数字だけでも一致します。Enter キー、検索ボタン、または Apply Filters で検索を実行し、× で消去します。検索は他のフィルターと組み合わされ、各ドロップダウンの候補を絞り込み、Export CSV にも適用されます。

21.4 アクティビティログをエクスポートする

  1. Logs → Activity を開きます。
  2. 必要なフィルターを適用します。
  3. Export CSV をクリックします。
  4. ファイルを保存します。
セクション 22

監査ログを確認する

Logs → Audit を開いて、ポータルで実行された管理操作を確認します。

各行には、操作を実行した人（Performed by）と、その対象となった人（Target user。その人のメールアドレスまたは電話番号付き）が表示されます。対象ユーザーで絞り込むと、1 人の履歴を追うことができます。いつ作成されたか、いつ Wallet Key や物理キーが発行されたか、または別のロックに追加されたか、いつモバイルアプリや QR インターホンのアクセスが付与または削除されたかがわかります。拒否または失敗したキーの追加は、複数ロックへの追加の各ロック分を含め、失敗ステータスと理由付きの行として表示されます。その人が後で削除されても、その人に関する行は残り、削除済みとマークされた状態で名前と連絡先を引き続き表示するため、履歴は完全なまま保たれます。

Matter デバイスもここに記録されます。ハブにデバイスを追加しようとするたびに Matter Device Commissioning の行が記録されます。ハブがデバイスをペアリングしている間は保留中で、その後デバイス名とともに完了になるか、ハブが報告した理由とともに失敗になります。ハブが応答しなかった場合や、ハブがビジー状態またはオフラインだったため、あるいは Hub API がコマンドを受け付けなかったために試行が拒否された場合も同様です。ハブから取り外されたデバイスごとに Matter Device Removed の行が記録され（ゲートウェイとともに削除される Zigbee デバイスを含む）、ゲートウェイ経由で現れた Zigbee デバイスには Matter Device Joined の行が記録されます。

22.1 監査ログを絞り込む

利用できるフィルターには次のものがあります。

  • 検索（操作を実行した人、対象ユーザーの名前・メールアドレス・電話番号、または説明で）
  • 操作の種類
  • ステータス（状態）
  • ロック
  • 実行者
  • 対象ユーザー
  • 日付範囲（開始／終了）

22.2 結果の並べ替えとページ送り

  1. 並べ替え可能な列見出し（タイムスタンプ、操作、ステータス）をクリックして並べ替えます。
  2. 必要に応じて、1 ページあたりの行数を選択します。
  3. ページ送りのコントロールでページを移動します。

22.3 詳細を表示する

  1. 目的の操作を見つけます。
  2. 行をクリックして詳細を開きます。
  3. 対象ユーザーや、失敗した操作の場合はその理由など、利用可能な情報を確認します。

22.4 監査ログをエクスポートする

  1. 必要なフィルターを適用します。
  2. Export CSV をクリックします。
  3. ファイルを保存します。エクスポートには Performed By、Target User、Target Contact の列が含まれます。
セクション 23

設定（Settings）

Settings を開いて、プロフィール、サブスクリプション、通知、アクセスリクエスト、請求、および SmartphoneKey チームへのフィードバック（34 を参照）を管理します。各領域はページ上部のタブになっています。

23.1 プロフィールを更新する

  1. Settings → Profile を開きます。
  2. 氏名、電話番号、または携帯電話番号を更新します。
  3. Save をクリックします。

メールアドレスは表示されますが、このページから変更することはできません。

23.2 サブスクリプションとパッケージ

  1. Settings → Subscription を開きます。
  2. 現在のプランとステータスを確認します。
  3. Available Packages で、アカウントに提供されているサブスクリプションパッケージを確認します。表示されるパッケージはロールによって異なります。各カードには、価格、請求期間、パッケージに含まれるすべての内容が表示されます。
  4. パッケージの Buy をクリックしてチェックアウトを開きます。標準の注文ページが開き、運営者が設定した支払い方法で支払います。支払い後、パッケージの機能と上限がアカウントに適用されます。

Base Access。 すべてのロック所有者には Base Access サブスクリプションがあります。ログと監査付きのアクセス履歴、ゲストキー、最大 10 ユーザー、Matter デバイスページが含まれます。最初のロックを登録すると、最初の 1 年間は無料です。ポータルのウェルカムメッセージが、有効化するよう案内します。有効化するには、Subscription タブの Add payment method をクリックし、開いた支払いページでカードを保存します。決済システムが標準のカード確認を行い、その直後にサブスクリプションが有効になります。カードを追加した後も有効化バナーが表示されたままの場合は、Check activation をクリックしてください。

期間固定のサブスクリプションが終了する 1 週間前に、ポータルは 1 回限りのリマインダーを表示します。アクセスを中断させないためには、Available Packages でパッケージを更新してください。

アカウントが Managed Access Control Service（パートナー）プランを使用している場合、このタブには Resident Digital Access Package を含む Add-ons セクションも表示されます。このアドオンは、部屋ごとに 2 つの Apple／Google Wallet キー、モバイルアプリへのインターホン呼び出し、ゲストキーを追加します。購入するには購入ボタンをクリックします。アドオンが入った状態でショップが開くので、部屋数を設定してチェックアウトを完了します。このアドオンには、有効な Managed Access Control Service サブスクリプションが必要です。

23.3 使用量を確認する

Subscription タブには、物件、ロック、ユーザーの使用量メーターも表示されます。

上限に近づいたときは、警告インジケーターに注意してください。

23.4 通知を設定する

  1. Settings → Notifications を開きます。
  2. 利用可能なトグルを有効または無効にします。
    • Key Pool Alerts
    • Lock Activity
    • Subscription Reminders

変更は、各オプションを切り替えた時点で反映されます。

23.5 デフォルトの動作を設定する

  1. Settings → Defaults を開きます。
  2. 各項目について、Use default（会社全体の設定を維持）、On、または Off を選択します。選択内容は自分自身の操作にのみ適用されます。
  3. Grant access defaults では、キーと一緒に何を渡すかを決めます。
    • Grant Mobile App access と Grant Intercom access — Wallet Key を割り当てるときに適用されます。どちらもデフォルトでオンです。
    • Give a physical key with Mobile App access と Give a physical key with Intercom access — 物理キーを発行するときに適用されます。どちらもデフォルトでオフです。物理カードは単独でロックを開けるものであり、指定しない限りどちらの種類のアクセスも伴わないためです。
  4. Display では、ポータルに何を表示するかを決めます。
    • Show the Physical Keys column on the Users page — デフォルトではオフです。オンにすると、各ユーザーが保有する物理カードの数を示す列が追加されます（9.3 を参照）。
    • Show the address when choosing a user — デフォルトではオフです。オンにすると、Assign Key ウィザード（ここでは Show address の初期状態も決まります。11.2 を参照）とカメラの Manage access ウィンドウ（19.9 を参照）でユーザーを選ぶときに、各人の住所が名前の上に表示され、住所でも検索できるようになります。
  5. メールのセクションでは、各イベントはここで有効にした場合にのみメッセージを送信します（デフォルトではすべてオフ）。新しく作成したユーザーが受け取るウェルカムメールもこれに含まれます（9.1 を参照）。
  6. Save をクリックします。

23.6 請求を確認する

  1. Settings → Billing を開きます。
  2. 請求書を確認します。
  3. 一覧から請求書の PDF を開きます。

請求書を開けない場合は、再度サインインするか、管理者に連絡してください。

セクション 24

アクセスリクエストを確認・承認する

ロールに応じて、設置業者や Community Manager からリクエストを受け取ることがあります。

24.1 リクエストを承認する

  1. Settings → Access Requests を開きます。
  2. 受信リクエストで、リクエストを見つけます。
  3. リクエストの種類、物件またはロックの一覧、要求された期間、理由を確認します。
  4. このオプションが表示されている場合は、承認する期間を調整します。
  5. Approve をクリックします。

24.2 リクエストを却下する

  1. Settings → Access Requests を開きます。
  2. 受信リクエストで、リクエストを見つけます。
  3. Reject をクリックします。
  4. 操作を確定します。

24.3 送信したリクエストを確認する

Settings → Access Requests で送信済みのリクエスト一覧を確認し、自分のリクエストが保留中、承認済み、却下済みのいずれかを確認します。

セクション 25

一時的な設置業者アクセスをリクエストする

他のユーザーが所有する特定のロックへの一時的なアクセスが必要な場合に、このページを使用します。

  1. 設置業者アクセスリクエストページを開きます。
  2. 所有者のメールアドレスを入力します。
  3. 1 つ以上のロックのシリアル番号を入力します。
  4. 希望する期間を入力します。
  5. 理由を入力します。
  6. リクエストを送信します。
  7. 所有者が承認または却下するのを待ちます。
  8. 送信済みのリクエスト一覧でステータスを確認します。
セクション 26

物件管理アクセスをリクエストする

対象となる Community Manager は、別の物件へのアクセスをリクエストできます。

  1. 物件管理アクセスリクエストページを開きます。
  2. 所有者のメールアドレスを入力します。
  3. 物件コードを入力します。
  4. リクエストを送信します。
  5. 承認を待ちます。
  6. 送信済みのリクエスト一覧でステータスを確認します。
セクション 27

トラブルシューティング

メニューのセクションが表示されない

そのセクションがロールに含まれていない可能性があります。アクセスが必要だと思われる場合は、管理者に連絡してください。

別の物件のデータが表示される

物件セレクターで正しい物件を選択します。ページが更新されるまで待ちます。

ボタンが無効になっている

ポータルに表示されるメッセージを読んでください。操作には次のものが必要な場合があります。

  • 別のロール
  • 有効なユーザー
  • 有効なロック
  • 利用可能な Wallet Keys
  • 有効なデバイスステータス
  • 選択された物件
  • 前提となる手順の完了（たとえば、アクセスボタンが表示されるには、ロックにキーが必要です）

ロックのリモート操作が失敗する

ロックのステータスと最後のアクティビティ時刻を確認してください。ポータルが繰り返しのコマンドを一時的にブロックしている場合は、カウントダウンが終わってから再試行してください。

物理カードが正しくプログラムされない

次の点を確認してください。

  • 正しいロックとユーザーが選択されている。
  • 正しいプログラマーデバイスが選択されている。
  • 正しいカードの種類（MIFARE Classic または DESFire EV3）が選択されている。
  • カードがプログラマーにかざされた。
  • デバイスの合図の後に Done をクリックした。

請求書が開かない

再度サインインして再試行してください。問題が解決しない場合は、管理者に連絡してください。

セクション 28

新任管理者向けクイックチェックリスト

  1. アカウントを作成し、最初のロックを登録します。
  2. SPK Portal にサインインします。
  3. 現在の物件を確認します。
  4. ダッシュボードを確認します。
  5. 必要に応じて追加の物件を作成します。
  6. Local Admin を追加します。
  7. ユーザーを作成します。
  8. ロック（Devices → Locks）とハブ（Devices → Hubs）を追加します。
  9. Wallet Keys、QR インターホンのアクセス、または物理キーを割り当てます。
  10. 必要に応じてロックのスケジュールを設定します。
  11. 使用する場合は、Matter デバイスとカメラを追加します。
  12. アクティビティログと監査ログを確認します。
  13. 通知を設定します。
  14. 使用量と Wallet Key の残高を定期的に確認します。
セクション 29

重要な注意事項

  • 利用できるセクションは、ロールと権限によって異なります。
  • 変更を行う前に、必ず選択中の物件を確認してください。
  • リソースを削除する前に、確認メッセージをよく読んでください。
  • Local Admin は Wallet Keys を受け取ることはできますが、購入することはできません。
  • ポータルから Matter デバイスを削除しても、物理デバイスはリセットされない場合があります。
  • 訪問者のアクセスには、恒久的なユーザーキーではなく一時的なゲストキーを使用してください。
セクション 30

AI アシスタント（チャットボット）

オプションの AI Assistant は、ポータルに関する質問に答え、代わりにデバイスを操作することもできます。システム管理者が全体で有効にすると、SPK Portal の右下に、SmartphoneKey リーダーの形をした「AI」の文字入りのボタンが表示されます。スマートフォンでは、チャットは全画面で開きます。

アシスタントとチャットする：

  1. チャットボタンをクリックしてアシスタントパネルを開きます。
  2. 質問やリクエストを入力し、Enter キーを押します（または送信ボタンをクリックします）。
  3. アシスタントは、このユーザーガイドと実際のデバイスデータに基づいて回答します。

デバイスの操作。 利用できるデバイスに対する操作をアシスタントに依頼できます。例：

  • 「正面玄関のロックを開けて。」
  • 「廊下の照明をつけて。」
  • 「リビングの照明を 50% にして。」

コマンドは直ちに実行されます。アシスタントはデバイスを検索し、要求された操作を実行して、結果をチャットで報告します。

デバイス操作以外にもできること。 アシスタントは次のこともできます。

  • ロックの一時的なゲストキーを作成し、指定したアドレスにアクセスリンクを送信する — 例：「オフィスのドアの一時キーを3日間発行して john@example.com に送って」。メールが送信されたかどうかはアシスタントが知らせ、返信の下にキーの QR コードが保存ボタン付きで表示されます。
  • ロックのゲスト用 Wallet Key を発行する — 例：「オフィスのドアのゲスト用 Wallet Key を anna@example.com に 24 時間発行して」。アシスタントはゲストキー画面の Wallet Key モード（第 12 章）と同じキーを発行し、宛先にメールで送信し、返信の下に Wallet Key の QR コードを表示します。宛先がまだロックの物件のユーザーでない場合、アシスタントはその人の名前を尋ね、画面の + フォームと同じように先にユーザーを作成します。
  • Matter デバイスのシナリオを作成する — 例：「廊下の人感センサーが動きを検知したら廊下の照明をつけて」や「平日の 18:30 に玄関の照明をつけて」。アシスタントは Simple エディター（第31章）と同じ方法でシナリオを作り、ハブに送信してハブの応答を報告します。シナリオの一覧表示やオン／オフの切り替えもできます。
  • デバイスからセンサーの値を読み取る — 例：「キッチンの温度は？」
  • アクセス履歴を検索する — 例：「今日の 15 時から 17 時の間に誰がドアを開けた？」
  • 新しいカメラを登録する — 例：rtsp:// リンクを貼り付けると、アシスタントが不足している情報（カメラの種類など）を尋ねて作成します。
  • ユーザーを管理する — 例：「ユーザー Anna Petrenko、anna@example.com を作成して」、電話番号ベースの制限ユーザーの作成、ユーザーの無効化や再有効化。
  • アクセスを付与・取り消す — 例：メールアドレスでユーザーにデジタルキーを発行する、モバイルアプリやインターホンのアクセスを付与または取り消す、RTSP カメラをユーザーと共有する。
  • デバイスを登録する — 例：シリアル番号とペアリングコードで新しいロックを追加する、ロックの名前を変更する、数字のペアリングコードでハブ経由の Matter デバイスを追加する。
  • 名前と短いコードを指定して新しい物件（組織）を作成する。
  • アクセス履歴のダウンロード可能な CSV レポートを用意する — 例：「昨日誰がドアを開けた？」— チャット内にダウンロードボタンが表示されます。

音声入力。 音声入力が設定されている場合、メッセージボックスの隣にマイクボタンが表示されます。話している間はボタンを長押しし、離すと停止します。認識されたコマンドは自動的にアシスタントに送信されます。短くタップしても録音はされず、話す間はボタンを押し続けるよう促すメッセージが表示されます。

注意：

  • アシスタントは、アカウントがアクセスできるロックとデバイスしか認識せず、自分でポータルから行える以上のことは決して実行できません。
  • 管理者が設定した月間使用量の上限に達した場合、アシスタントは一時的に利用できなくなることがあります。
セクション 31

シナリオ

Scenarios ページでは、あるデバイスを別のデバイスに反応させることができます。ここで作成したシナリオは、Matter ハブが実行します。シナリオは、トリガー（デバイスが報告する何か、または特定の時刻）と、それが発生したときにハブがデバイスに対して実行するアクションで構成されます。

開き方。 シナリオビルダーはメインメニューにはありません。Devices → Matter Devices を開き、ページヘッダーの Scenarios ボタンを使います。このページはサブスクリプションの一部で、いずれかのパッケージに Scenario editor 機能が含まれていると利用できるようになります。

2 つのエディター。 新しいシナリオは Simple エディターで開きます。これはモバイルアプリのシナリオコンストラクターとまったく同じように動作します。Advanced エディターは、複数のトリガー、条件、遅延、デバイスグループを持つシナリオのためのブロックキャンバスです。エディターヘッダーの Simple / Advanced コントロールで切り替えます。Simple のシナリオはいつでも Advanced エディターで開けますが、Advanced のシナリオが Simple に戻れるのは、トリガーが 1 つとアクションが 1 つだけの間に限られます。

Simple エディター。 シナリオに名前を付け、2 つのカードを入力します。When — デバイス、デバイスが報告するイベント（接触、水漏れ、動き、煙、ロックの状態、電源、ボタン、温度、湿度、照度、空気質、バッテリーなど）、条件（*である*、*でない*、*に変わる*。計測値では *より大きい*、*より小さい*、*等しい*）、値を選びます。Then — デバイスと、その動作（オン、オフ、切り替え、施錠、解錠、バルブやブラインドの開閉、25 / 50 / 75 / 100 % のプリセットでの明るさ設定）を選びます。More settings には、説明、ハブ、タイムゾーン、実行設定があります。デバイス一覧と、デバイスを選んだ後の When / Then カードでは、各デバイスに Matter Devices ページのカードと同じアイコンと色が表示されます。

Advanced エディター。 左パネルからブロックをキャンバスにドラッグし、ブロックの右端から別のブロックの左端へドラッグして接続します。ブロックを選択すると右パネルで設定できます。

  • Triggers はシナリオを開始します。Device event（Simple エディターと同じデバイス属性、条件、値に加え、デバイスが報告する任意の属性用の *その他の属性…*）または Schedule（時刻と曜日）です。
  • Condition は任意のガードで、すべて（またはいずれか）が成立する必要があるルールを持ちます。デバイス属性、時間帯、曜日、または毎年繰り返す日付範囲です。各ルールは Not で否定できます。
  • Actions はハブが行うことです。デバイスコマンド（デバイスが受け付ける任意のコマンドとそのパラメーター用の *その他のコマンド…* も含む）、任意のトランジション付きの明るさ、段階的な変化、または遅延です。コマンドは 1 つのデバイス、またはグループ（すべての照明、すべてのプラグとスイッチ）を対象にできます。ハブはアクションを順番に実行するため、複数の分岐がある場合、遅延を置けるのは最後の分岐だけです。
  • Keep until は、その条件が真になったときに終了アクションを実行します。たとえば、部屋が冷えるまでエアコンのプラグをオンにしておく、といった使い方です。ハブはこれを 2 つ目のシナリオとして受け取ります。

シナリオ設定（ブロックが選択されていないときに表示）には、説明、ハブ、すべての時間帯・曜日・日付範囲が従うタイムゾーン、実行中に再度トリガーされたときの動作（無視、アクションを再開、実行をキューに入れる、並行して実行）、実行前に条件を再確認するデバウンス、2 回の実行の間のクールダウン、およびアクション一覧全体のタイムアウトがあります。

公開とハブからの応答。 Validate はシナリオを検証し、問題のあるブロックを強調表示します。Save はハブに触れずに下書きを保存します。Publish はシナリオをハブに送信し、ハブがそれを確認します。名前の隣のバッジには *ハブに送信中…*、続いて *ハブで実行中*、または *ハブに拒否されました* とハブの理由が表示されます。ハブが応答しない場合はバッジにその旨が表示され、Resend でシナリオを再送信できます。公開済みのシナリオを編集すると Modified と表示されます。再度公開するまで、ハブは以前のバージョンを保持します。シナリオのスイッチは、何も削除せずにハブ上で有効／無効を切り替えます。Unpublish はハブからシナリオを削除し、下書きは残します。

注意：

  • シナリオで使用できるのは、同じハブでコミッショニングされたデバイスだけです。削除中のデバイスはエディターから消えます。
  • 計測値は日常的な単位（°C、%、lux）で入力します。ポータルはシナリオを送信する際に、それらをハブ独自の単位に変換します。
  • ブロック、ルール、アクションの数には上限があります。上限に達すると検証で通知されます。
セクション 32

サポート設定（Support Configurator）

モバイルアプリの Support ボタンは、Admin Panel が提供するサポートページを開きます。会社のロックを使う人にそのページが何を表示するかは、バックオフィスの Configuration → Support Configurator で設定します。設定は会社ごとに 1 つで、メニューから自社のレコードが直接開きます。

モード。 *シンプル* モードでは、連絡先チャネル、営業時間、およびサポートアドレスにメールを送る Leave a message フォームが表示されます。*詳細* モードでは、自社のサポート担当者向けのリクエストデスクと、オプションの AI アシスタントが追加されます。

言語。 Support page language は、デフォルトでは *ユーザーの言語に従う* です。ページは、アプリの実行言語（またはアカウントの言語）で開きます。*固定言語* を選んでポータル言語のいずれかを指定すると、アプリの設定にかかわらず、すべてのユーザーにその言語でページが表示されます。

連絡先タブ。 使用するチャネルだけを入力します。それぞれがスマートフォン上でタップして開けるカードになります。

  • Emergency phone (24/7) — 最初に表示され、24 時間対応としてマークされます。
  • Phone と Email。
  • WhatsApp、Viber、Signal — 国際形式の番号。ページはその番号とのチャットを開きます。
  • Telegram — ユーザー名（たとえば `@acme_support`）または `t.me` リンク。
  • Facebook Messenger — ページ名または `m.me` リンク。
  • Website / help center — 詳しいヘルプページへのリンク。
  • Office address — スマートフォンの地図アプリで開きます。

リンクにできない値（スペースを含むユーザー名、`http`/`https` でないアドレス）は保存時に拒否され、メッセージにそのチャネル名が表示されます。

営業時間タブ。 Show working hours をオンのままにすると、週間スケジュールが、選択したタイムゾーンで計算された Open now / Closed now の表示とともに表示されます。曜日を休業にするか、開始・終了時刻を設定します。

メッセージフォームタブ。 フォームがオンの場合、ページに残されたすべてのメッセージは、送信者の名前、メールアドレス、電話番号とともに Send messages to（このフィールドが空の場合はサポートのメールアドレス）にメールで送られるため、直接返信できます。シンプルモードでは、フォームには送信先のアドレスが必要です。そのため、連絡先カードにメールアドレスのない会社ではフォームは最初オフになっており、アドレスを入力するか、リクエストがデスクに送られる詳細モードを選ぶと、再びオンになります。

プレビュー。 フォームヘッダーの Preview Support Page は、ユーザーがアプリで見るのとまったく同じページを開きます。

Support Desk タブ（詳細モード）。 詳細モードでは、ページに残されたメッセージはメールを送る代わりにリクエストを開きます。このタブでは、Support Desk（セクション 33）でリクエストに回答する担当者を選びます。担当者は、User ロールより上のロール（Portal Tier 2、Customer、Installer、Community Manager、Local Admin、またはカスタムの Customer ロール）を持つ自社のポータルユーザーです。また、新しいリクエストについて担当者に、回答について依頼者にメールを送るかどうか、未回答のリクエストを何時間後に再提示するか、解決済みのリクエストを何日後に自動的にクローズするか、1 人が同時に開けるリクエストの数（1〜10）、依頼者に評価を求めるかどうか、そして担当者が挿入できる定型返信も設定します。フォームの隅にある Requests ボタンは、会社のリクエストを一覧表示します。Chat グループには Offer a chat with the support team があります。これをオンにすると、サポートページにアシスタントと同じスタイルのチャットウィンドウが表示され、そこからサポートチームにメッセージを書けます。最初のメッセージがリクエストを開き（ソースは *サポートチャット*）、以降のメッセージはそれに続き、Support Desk で行われた回答がウィンドウに表示されます。It is solved でリクエストは解決済みになります。アシスタントが有効な場合は、そのウィンドウがチャットの代わりになります。

アシスタントタブ（詳細モード）。 AI assistant をオンにすると、サポートページの上部にチャットが追加されます。アシスタントは、SmartphoneKey モバイルアプリのナレッジベース（アプリのすべての画面、メッセージ、上限の詳細な説明と、トラブルシューティング表）、上記の連絡先と営業時間、およびこのタブで入力する Company FAQ（質問と回答のペア。そのまま引用されます）から回答します。すべての質問をまずモバイルアプリに関する質問として扱い、回答する前にナレッジベースで内容を調べ、その人のキー、ロックの状態、最近のドアイベントを確認します。ナレッジベースに情報がない場合にのみ一般的なアドバイスを行い、SmartphoneKey に関係のない質問には、回答の代わりに、リクエストを残すことを率直に提案します（または以下で選んだとおり連絡先を示します）。アシスタントはその人自身のキーとイベントしか見えず、ドアを開けたりアクセスを変更したりすることはできません。自由記述のプロンプトはなく、動作はオプションから構成されます。口調と回答の長さ、言語（ユーザーの言語に従うか固定するか）、使用してよいナレッジベースのトピック（読み方、アプリとは何か、アプリができないことは常に含まれます）、その人のために実行できること（キーとステータスの表示、最近のドアイベント、ロックがオンラインかどうか、Wallet Key メールの再送信、リクエストの作成）、引き継ぎのタイミング（リクエストを提案する、連絡先を表示する、またはその両方。一定回数回答できなかった後に人間の対応を提案する。緊急を示す言葉があれば緊急電話を最初に表示する。営業時間外は回答を続けるか、連絡先とフォームだけを残す）、そして上限です。上限は、1 人 1 日あたりのメッセージ数（20、50、100）と 1 会話あたりのメッセージ数（10〜30）で、チャットが何時間も続くことなく、技術的な質問を解決してメッセージを残せるようにします。会社は、Settings のグローバル設定の代わりに、独自の LLM API キー、URL、モデルでアシスタントを実行でき、任意で月間トークン予算を設定できます。今月使用したトークン数はタブに表示されます。その人がリクエストを残すと、チャットはそのリクエストに添付されるため、デスクはすでに話された内容を確認でき、デスクの統計にはアシスタントが単独で解決した案件の割合が表示されます。

ユーザーに表示される内容。 ユーザーはアプリの Profile タブからページを開き、所属する物件を運営する会社の連絡先を見ます。メールアドレスなしで電話番号だけでアプリを使う人は、アプリがその人のために要求する署名付きリンクから同じページに到達します。リンクは自動的に期限切れになり、サポートメール内のリンクも同じ方法で発行されます。会社が設定を入力するまで、ページには、システム管理者が Settings → Support で入力した SmartphoneKey のサポート連絡先が表示されるため、空のページが表示されることはありません。ページはアプリの言語に従います。ただし、Support Configurator の上部にある Support page language で全員に対して 1 つの固定言語が指定されている場合は除きます。

セクション 33

サポートデスク（Support Desk）

Support Desk は、Support Configurator で選ばれた担当者が、モバイルのサポートページに残されたリクエストに回答する場所です。担当者は、ポータルホームの SmartphoneKey Portal カードの下にある Support Desk カードからアクセスします。カードには、新しいリクエストの待ち件数が表示されます。管理者はポータルの Dashboard でも同じ数字を確認できます。Support Requests タイルには、ステータス別の未解決リクエスト数と、初回回答までの平均時間が表示されます。

一覧。 リクエストはタブ（Open、Unread、Mine、New、In progress、Waiting for user、Resolved、Closed、All）でグループ分けされ、検索ボックス（件名、名前、メールアドレス、電話番号、またはリクエスト番号）、並び順、現在の一覧の CSV エクスポートがあります。複数の会社を担当する担当者は、ヘッダーで会社を選びます。ヘッダーにはインターフェース言語セレクターとテーマ切り替えもあります。ヘッダーには過去 30 日間の情報も表示されます。未解決および新規のリクエスト数、初回回答と解決までの平均時間、平均評価、AI アシスタントが解決したリクエストの割合です。

リクエスト。 リクエストを開くと、会話（依頼者のメッセージ、担当者の回答、内部メモ、およびアシスタントの会話記録がある場合はその記録）と、依頼者パネル（名前、物件、住所、電話番号、メールアドレス、アカウントの種類、その人が保有するキーとロック）が表示されます。その下の Open the SmartphoneKey Portal は、ポータルをその人のユーザー情報ウィンドウで直接開きます。ヘッダーからは、リクエストを Take（担当）したり、Resolve（解決）したり、Status、Priority、Category、Agent を変更したりできます。

回答。 返信ボックスに入力して Send answer をクリックします。依頼者はリクエストページで回答を確認でき、メールアドレスがある場合はメールも受け取ります。Internal note にチェックを入れると、他の担当者だけが見られるメモを残せます。Insert a canned reply は設定にある定型文のいずれかを追加し、Attach は最大 3 つの写真または PDF ファイルを追加します。チャットウィンドウから開かれたリクエスト（ソースは *サポートチャット*）への回答は、サポートページのそのウィンドウにも表示されます。

ライフサイクル。 新しいリクエストは、最初の回答で In progress になります。Waiting for user は、依頼者の返答待ちであることを示します。Resolved のリクエストは、設定された日数が経過すると自動的にクローズされます。ただし、依頼者が再度書き込むと再オープンされます。解決後、依頼者は対応を 1〜5 で評価するよう求められ、評価はリクエストと統計に表示されます。

セクション 34

フィードバックと提案（Feedback & Suggestions）

Settings → Feedback & Suggestions では、SmartphoneKey チームに追加または改善してほしい点を伝え、各アイデアがその後どうなったかを確認できます。このタブには送信したすべての項目が一覧表示され、チームの回答は各項目の中に表示されます。

34.1 フィードバックを残す

  1. Settings → Feedback & Suggestions を開き、New feedback をクリックします。
  2. フィードバックの種類を選びます。Idea（新しく欲しいもの）、Improvement（既にあるが、もっと良くできるもの）、Problem（期待どおりに動作しないもの）、または Other です。
  3. 対象の分野を選びます。デバイスとロック、物理キー、ユーザーとアクセス、Wallet Keys、カメラと映像、インターホン、ハブと Matter、Admin Portal、モバイルアプリ、請求とサブスクリプション、サポート、またはその他です。
  4. 短い Title（1 行）を付け、追加または改善してほしい内容、それが解決する問題、そして必要であれば理想的な動作（期待する結果、他の製品の例、リンクなど）を記述します。
  5. ご自身にとっての重要度を選びます。Nice to have、Important、または Critical です。
  6. 役に立つ場合はスクリーンショットまたは PDF を添付し（最大 5 ファイル、各 5 MB）、Send feedback をクリックします。

氏名、メールアドレス、会社、およびポータルで選択している物件は自動的に追加されるため、ご自身について入力する必要はありません。

34.2 フィードバックの経過を確認する

このタブには、送信したすべての項目が新しい順に、ステータス（New、Under review、Planned、In progress、Done、または Declined）とともに表示されます。カードを開くと、全文、添付ファイル、および会話を読むことができます。

チームが回答したりステータスを変更したりすると、次にポータルを開いたときに 1 回限りの通知が表示されます。View をクリックするとそのフィードバックが開き、Later をクリックすると通知が閉じます。項目を開くまで、そのカードには *新着* マーカーが付き、Feedback & Suggestions タブには未読の返信がある項目の数が表示されます。

34.3 チームに返信する

フィードバックを開き、会話の下にある Your reply に入力して、Send reply をクリックします。チームはバックオフィスで返信を確認し、同じ会話の中で再度回答できます。

34.4 フィードバックを求める招待

運営者からフィードバックを求める招待が届くことがあります。その場合、ポータルを開いたときに 1 回限りのメッセージが表示されます。Leave feedback をクリックすると新しいフィードバックのフォームに直接移動し、Later をクリックするとメッセージが閉じます。このメッセージは招待ごとに 1 回だけ表示されます。

セクション 35

パートナーポータル（Partner Portal）

Partner Portal は、API を通じて自社プラットフォームを SmartphoneKey に接続する統合パートナー企業向けのセルフサービス領域です。Admin Portal とは別のものです。Partner ロール（SmartphoneKey チームがバックオフィスから付与）を持つアカウントには、ポータルホームの SmartphoneKey Portal カードと Support Desk カードの下に Partner Portal カードが表示され、それ以外は何も変わりません。同じ組織でこのロールを持つすべてのアカウントが、同じ登録情報を扱います。

35.1 統合を設定する

ページは、上部に進行状況バーとして表示される 3 つのステップで案内します。

  1. Register organization. Organization name と Organization ID（小文字、数字、ハイフンで 3〜64 文字）を入力します。ポータルは会社名から ID を提案し、空いているかを確認します。この ID はすべての API 呼び出しでプラットフォームを識別し、後から変更できません。アカウントのメールアドレスが所有者として記録されます。
  2. Create API key. プラットフォームがすべてのリクエストの X-API-Key ヘッダーで送るキーです。保存したことを確認するまで閉じられないダイアログに一度だけ表示され、その後ページにはキーの先頭と末尾だけが表示されます。
  3. Register webhook. SmartphoneKey がイベントを配信するプラットフォーム上の HTTPS アドレスと、受け取りたいイベント（All events またはイベント種別の一覧）です。Webhook の secret も一度だけ表示されます。すべての配信は X-Webhook-Secret ヘッダーにこの値を含めるため、サーバーはこの値のない呼び出しを拒否できます。

admin API がステップを確認しない場合、ページはそのステップを繰り返す代わりに Finish、Check、Discard ボタン付きの未確認状態として保持し、SmartphoneKey はバックオフィスで同じ内容を確認できます。

35.2 統合を管理する

設定後、ページには Organization カード、API key カード、Webhook カード、アクティビティログが表示され、Webhook が登録されている間は Webhook health と Delivery stats も表示されます。

  • Rotate API key は admin API に、一度だけ表示される新しいキーを要求します。現在のキーがまだ有効な間は admin API が拒否するため、まず SmartphoneKey に失効を依頼し、その後すぐにプラットフォームを更新してください。
  • Update webhook URL は配信先を新しい HTTPS アドレスに移し、サブスクリプションは新しいアドレスで再検証されます。Replace webhook はまず新しい secret で新しいサブスクリプションを作成し、それが存在してから現在のものを削除します。secret を紛失した場合やイベントの構成を変えたい場合に使います。削除に失敗した場合は、SmartphoneKey が古いものを削除するまで両方が有効のままです。
  • Webhook health は直近 15 分と 24 時間の配信失敗数を、配信済み数と一致数とともに表示し、最後の配信エラーと最近のエラーも表示します。
  • Delivery stats は基準時点以降の合計（合計、配信済み、失敗、再試行）、配信率、日別グラフを表示します。Reset stats は SmartphoneKey 側で何も削除せずに、今この瞬間から新しい基準時点を始めます。
  • Activity は、誰がいつ何を登録、作成、ローテーション、変更したかを一覧にします。SmartphoneKey チームはバックオフィスの Configuration → Partner Integrations で同じ一覧を確認でき、キーと secret はそこには決して表示されません。

ヘッダーには My account へ戻るリンク、インターフェース言語の選択、テーマの切り替え、Sign out があります。SmartphoneKey がポータルをパートナー API に接続するまで、ページはその旨を表示し、操作は無効のままです。