営業時間の外や休日に扉が開いたときだけ、担当者のチャットに知らせられます。
24時間使える会員制の施設や、夜は無人になる事務所・倉庫で、RemoteLOCKのWebhookを使う例です。
こんなとき
時間外の入室だけを拾って知らせられます
解錠のたびにメールで知らせる設定もありますが（お知らせ機能）、昼間の入室まで届くと、夜中や休日の入室を見落としがちです。Webhookで解錠の知らせを受け、時刻と曜日で振り分けるようにすると、営業時間の外に開いたときだけ、担当者のチャットに届きます。
しくみ
受け口が時刻を見て、知らせるかを決めます
扉が開くと、RemoteLOCKから、登録した受け口（Webhook）に解錠の知らせが届きます。知らせには、開いた扉、時刻、使われたカギ（アクセスユーザーやゲスト）のIDが入っています。貴社で作る受け口のプログラムが、時刻を日本時間に直して営業時間・曜日・休日の一覧と比べ、時間外のときだけ、例えばSlackの決めたチャンネルに投稿します。夜間の清掃など、時間外に入ることが決まっている人のカギのIDは、知らせない一覧に入れておきます。
アクセスユーザーやゲストが開けたときは、解錠の知らせと、カギが使われた知らせの2つが届きます。同じ入室を二重に投稿しないよう、お知らせ機能では「解錠」だけを選んでください。時間外に入れないようにしたいときは、アクセススケジュールで番号を使える曜日と時間を決めます（アクセススケジュールとアクセス不可日）。
※ Slackは、Webhookを受けて自作するときの例です。RemoteLOCKと連携済みのサービスではありません。連携済みのサービスは 予約エンドポイントに対応した連携サービス と 連携システム一覧（公式サイト）でご覧いただけます。
必要なもの
始める前に3つがそろっているかお確かめください
| 必要なもの | 中身 |
| アカウントとデバイス | 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること |
| Webhookの登録 | クラウド管理画面の「高度な機能」→「お知らせ機能」で、通知先と受け取るイベントを登録します（お知らせ機能）。Webhookを受けるだけなら、APIのご利用の手続き（NDA）は要りません |
| 受け口のプログラム | 知らせを受けて処理するプログラムは、貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません |
気をつける点
作る前にお確かめいただきたいこと
- 受け口は、HTTPSで受け、3秒以内に200番台を返す作りにしてください。失敗が続くとWebhookは無効になり、メールでお知らせします（Webhookの受け口の条件）
- 解錠の知らせには、使われた暗証番号やカード番号の値がそのまま入ります。チャットや表に流すときは、受け取った直後にその項目を落としてください
- 解錠の知らせには、人の名前ではなく、アクセスユーザーやゲストのIDが入ります。名前で知らせたいときは、IDと名前の対応を貴社の側で持っておきます
- 機種によって受け取れるイベントが違います。すべての扉を対象にするときは、お知らせ機能の情報元を「アカウント」にしてください（お知らせ機能）
始め方
まずはお知らせ機能で通知先をご登録ください
Webhookの通知先は、クラウド管理画面の「高度な機能」→「お知らせ機能」→「通知先」で登録し、受け取るイベントを選びます（お知らせ機能）。届く内容の例は Webhookでのイベント情報の取得 にあります。カギの発行などをAPIで自動にしたいときは、API資料のお申し込み からご請求ください。
関連する記事