APIとWebhookの活用例

暗証番号の入力の間違いの通知|扉の前で番号が通らなかったときに、担当者のチャットに知らせるしくみ

扉の前で暗証番号が通らなかったとき、そのことを担当者のチャットに知らせられます。
無人の施設や夜間の受付がない施設で、RemoteLOCKのWebhookを使う例です。カギの発行は、今までどおりクラウド管理画面でも行えます。
こんなとき

「開かない」の電話が来る前に気づけます

利用者が番号を打ち間違えたり、利用期間の外に来たりして開けられないと、担当者は現地から電話が来るまで気づけません。番号が違うときと、利用期間の外で押されたときは「アクセス拒否」として記録されます(暗証番号で開かないとき)。お知らせ機能のメールでも受け取れますが(お知らせ機能)、Webhookで受けてチャットに流すようにすると、同じ扉で続けて起きたときだけ知らせる、といった絞り込みができます。
しくみ

アクセス拒否の知らせを受けて、続いたときに知らせます

入力の失敗からチャットの投稿までの流れの図。1 利用者:暗証番号を押す。番号の間違いや、利用期間の外で押したとき。2 RemoteLOCK:アクセス拒否の知らせを送る。扉と時刻が入ります。3 貴社が作る受け口:同じ扉で続いたかを数える。番号の値はここで落とします。4 貴社が作る受け口:担当者のチャットに投稿する。例:正面入口 22:10 入力の失敗が3回。5 担当者:電話の前に気づく。カギの期間や届き具合を確かめます。「貴社が作る受け口」は、貴社か開発会社で作っていただく部分です
お知らせ機能で、扉の「アクセス拒否」を受け取るイベントに選び、受け口(Webhook)を登録します。番号が通らないたびに、RemoteLOCKから受け口に、扉と時刻の入った知らせが届きます。貴社で作る受け口のプログラムは、同じ扉で短い時間に続いたときに、例えばSlackの決めたチャンネルに投稿します。
利用期間の外で押されたときは、どの人のカギだったかが分かることがあります(イベント履歴の見方)。知らせを受けた担当者は、クラウド管理画面でカギの期間や、番号が本体に届いているかを確かめ、必要なら番号を案内し直します。
※ Slackは、Webhookを受けて自作するときの例です。RemoteLOCKと連携済みのサービスではありません。連携済みのサービスは 予約エンドポイントに対応した連携サービス と 連携システム一覧(公式サイト)でご覧いただけます。
必要なもの

始める前に3つがそろっているかお確かめください

必要なもの 中身
アカウントとデバイス 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること
Webhookの登録 クラウド管理画面の「高度な機能」→「お知らせ機能」で、通知先と受け取るイベントを登録します(お知らせ機能)。Webhookを受けるだけなら、APIのご利用の手続き(NDA)は要りません
受け口のプログラム 知らせを受けて処理するプログラムは、貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません
気をつける点

作る前にお確かめいただきたいこと

  • 受け口は、HTTPSで受け、3秒以内に200番台を返す作りにしてください。失敗が続くとWebhookは無効になり、メールでお知らせします(Webhookの受け口の条件)
  • 解錠の知らせには、使われた暗証番号やカード番号の値がそのまま入ります。チャットや表に流すときは、受け取った直後にその項目を落としてください
  • 機種によって受け取れるイベントが違います。すべての扉を対象にするときは、お知らせ機能の情報元を「アカウント」にしてください(お知らせ機能)
  • 通りがかりの人やいたずらで番号が押されることもあります。1回ごとに知らせず、回数と時間の幅を決めて、知らせすぎないようにしてください
始め方

まずはお知らせ機能で通知先をご登録ください

Webhookの通知先は、クラウド管理画面の「高度な機能」→「お知らせ機能」→「通知先」で登録し、受け取るイベントを選びます(お知らせ機能)。届く内容の例は Webhookでのイベント情報の取得 にあります。カギの発行などをAPIで自動にしたいときは、API資料のお申し込み からご請求ください。
関連する記事

最終更新

この記事は役に立ちましたか?

0人中0人がこの記事が役に立ったと言っています

記事で解決しないときは

問い合わせフォーム(24時間受付)か、お電話でご相談ください。