プログラマブルアラートの上限数
ライトプランをご利用の場合、プログラマブルアラートの作成は最大3件までに制限されます。プレミアムプランおよびジネスプロプランをご利用の場合は、無制限にプログラマブルアラートを作成いただけます。
プログラマブルアラートとは？
プログラマブルアラートとは、組織の管理者が特定の鍵や鍵グループごとにカスタマイズして設定できる通知機能です。多様な業務フローの自動化・効率化に役立ちます。代表的な活用例は以下の通りです：
シフト終了時に従業員へ鍵の返却を促し、次のシフトでの鍵の紛失や受け渡し遅れを防止
チェックアウト予定時刻を過ぎてもゲストから部屋の鍵が返却されない場合に管理者に通知
予約が入った際に、ゲストへチェックイン手順を自動送信
鍵の利用状況を管理者がリアルタイムで把握
プログラマブルアラートには3つの種類があります：返却遅延アラート、鍵の受け渡しアラート、予約作成アラート。
1. 返却遅延アラート
以下の3つのいずれかのタイミングで、鍵の管理者、利用者、または組織内の任意のユーザーにSMS、メール、またはwebhookで通知が送信されます：
鍵が取り出されてから指定の分数／時間／日数が経過したとき
予約またはシフトの終了時刻から指定の分数／時間／日数が経過したとき
予約またはシフトの終了時刻の指定の分数／時間／日数前になったとき
2. 鍵の受け渡しアラート
以下の2つのいずれかのタイミングで、鍵の管理者、利用者、または組織内の任意のユーザーにメールで通知が送信されます：
鍵が返却（格納）されたとき
鍵が取り出されたとき
3. 予約作成アラート
以下の2つのいずれかのタイミングで、鍵の管理者、利用者、または組織内の任意のユーザーにメールまたはwebhookで通知が送信されます：
鍵の単発予約が作成されたとき
鍵の事前予約が作成されたとき
4. ロケーションステータスアラート
以下の2つのいずれかのタイミングで、組織のオーナー、管理者、またはロケーション管理者にSMS、メール、またはwebhookで通知が送信されます：
ロケーションの電源供給が途絶えたとき
ロケーションのインターネット接続が切断されたとき
新しいアラートの設定方法
モバイルでのプログラマブルアラート管理
プログラマブルアラートの作成および編集は、デスクトップアプリでのみ可能ですのでご注意ください。
Keycafe デスクトップにログインします。
「+ 追加」→「プログラマブルアラート」→ 作成したいアラートの種類を選択します。
アラートの名前を入力します。
アラートの説明を入力します。これは社内・管理者用のメモであり、利用者には表示されません。
アラートを設定したい鍵または鍵グループの名前を入力します。
返却遅延アラートの場合、アラートの対象となる鍵を取り出すユーザーを選択し、アラートがトリガーされる時間と条件を選択します。
鍵の受け渡しアラートの場合、アラートがトリガーされる条件を選択します。
予約作成アラートの場合、アラートがトリガーされる予約タイプを選択します。
通知方法としてSMS（返却遅延アラートのみ）、メール、webhookのいずれかを選択します。webhookを選択した場合は、webhook URLを入力します。
アラートで送信するメッセージを入力します。「変数」をクリックすると、メッセージ内に挿入できる便利な変数一覧が表示されます。
通知の受信者を選択し、「アラートを作成」をクリックします。
お役立ちヒント
複数の受信者を設定
1つのアラートにつき、1名から最大10名まで受信者を設定できます。鍵の管理者や鍵の利用者以外のユーザーに通知を送りたい場合は、「ユーザーを追加」フィールドに名前を入力してください。
変数について
アラートメッセージに変数を追加するには、「変数」をクリックし、追加したい変数の横にある+をクリックします。選択できる変数はアラートの種類によって異なります：
返却遅延アラートの変数
変数 | 出力内容 |
[KEY] | 鍵の名前 |
[USER] | 鍵の受け渡しを行ったユーザーの名前 |
[ALERT NAME] | アラートの名前 |
[KEY URL] | Keycafeアプリ内の該当する鍵へのリンク |
[BOOKING URL] | Keycafeアプリ内の該当する予約へのリンク |
鍵の受け渡しアラートの変数
変数 | 出力内容 |
[KEY] | 鍵の名前 |
[USER] | 鍵の受け渡しを行ったユーザーの名前 |
[ALERT NAME] | アラートの名前 |
[EXCHANGE TYPE] | 受け渡しタイプ（「取り出し」または「返却」） |
[KEY URL] | Keycafeアプリ内の該当する鍵へのリンク |
[BOOKING URL] | Keycafeアプリ内の該当する予約へのリンク |
[LOCATION NAME] | 鍵の取り出しまたは返却が行われたロケーション名 |
予約作成アラートの変数
変数 | 出力内容 |
[KEY] | 鍵の名前 |
[ALERT NAME] | アラートの名前 |
[GUEST NAME] | ゲストの名前 |
[GUEST CONTACT] | 予約に使用された連絡先（メールアドレスまたは電話番号） |
[START DATE] | 予約開始日時 |
[END DATE] | 予約終了日時 |
[BOOKING CODE] | 予約コード |
[BOOKING TYPE] | 予約タイプ（「予約済み」または「確保済み」） |
[QR CODE] | 予約QRコードの画像 |
[KEY URL] | Keycafeアプリ内の該当する鍵へのリンク |
[BOOKING URL] | Keycafeアプリ内の該当する予約へのリンク |
ロケーションステータスアラートの変数
変数 | 出力内容 |
[LOCATION NAME] | 問題が発生しているロケーション名 |
[LOCATION ISSUES] | ロケーションのステータスに関する問題一覧 |
[ALERT NAME] | アラートの名前 |
[LOCATION URL] | 問題が発生しているロケーションへのリンク |
管理者と利用者で異なるメッセージを設定
鍵の管理者と利用者の双方にアラートを送信しつつ、それぞれに異なるメッセージを設定したい場合は、「+ 通知を追加」を選択して個別にメッセージを入力し、各通知の受信者を指定してください。これにより、管理者向けと利用者向けにそれぞれ1通ずつの通知が作成されます。
既存のアラートの編集
Keycafe デスクトップにログインします。
「設定」→ 「プログラマブルアラート」を選択します。
アラートのカテゴリーを選択し、編集したいアラートの編集アイコンを選択します。
アラートを一時停止したい場合は、「アラートを有効化」のトグルをオフに切り替えるだけです。