APIとWebhookの活用例

生徒の入室の保護者への通知|塾や自習室の扉を生徒が開けたら、保護者のLINEに知らせるしくみ

生徒が暗証番号で扉を開けたら、そのことを保護者のLINEに知らせられます。
学習塾や自習室で、APIで生徒ごとに発行したカギと、Webhookで届く解錠の知らせを組み合わせる例です。
こんなとき

生徒の入室を保護者に自動で知らせられます

講師が生徒の到着を確かめて保護者に連絡するのは手間で、無人の自習室では確かめる人もいません。解錠の知らせをWebhookで受けて保護者に送るようにすると、入室が自動で届きます。
しくみ

解錠の知らせに入るIDで、生徒と保護者を探します

カギの発行から保護者への通知までの流れの図。1 貴社が作る連携:生徒のカギをAPIで発行する。入塾のときにアクセスユーザーを作ります。2 貴社が作る連携:生徒のIDと保護者を結び付ける。返ってきたIDを生徒の台帳に控えます。3 生徒:暗証番号で扉を開ける。生徒ごとの番号で入室します。4 RemoteLOCK:解錠の知らせを送る。扉・時刻・カギの人のIDが入ります。5 貴社が作る受け口:IDで生徒と保護者を探す。番号の値はここで落とします。6 貴社が作る受け口:保護者にLINEで知らせる。例:19:02 ○○さんが入室しました。7 保護者:入室を知る。塾に電話で確かめずに済みます。「貴社が作る連携」は、貴社か開発会社で作っていただく部分です「貴社が作る受け口」は、貴社か開発会社で作っていただく部分です
生徒が入塾したら、貴社で作る連携のプログラムが、APIで生徒ごとのアクセスユーザーを作って暗証番号を発行し、返ってくるIDを保護者のLINEのIDと並べて台帳に控えます。生徒が扉を開けると、受け口(Webhook)に同じIDの入った解錠の知らせが届きます。受け口は、IDから生徒と保護者を探し、LINEで入室を知らせます。
アクセスユーザーの解錠では、解錠の知らせとカギが使われた知らせの2つが届くので、一方だけを選ぶと二重に送らずに済みます。兄弟で同じ番号を使うとどちらが入ったかを見分けられないため、番号は生徒ごとに分けます。通う曜日や時間帯に限るときは、アクセススケジュールを組み合わせます(アクセススケジュールとアクセス不可日)。
保護者のLINEのIDは、LINEミニアプリ(LIFF)で登録してもらうと台帳に結び付きます。LINEでのカギの受け渡しを、ノーコードの自動化ツールで自作した例もあります(Empty Dressy様の事例、運営者による解説)。
※ LINEへの送信は、Webhookを受けて自作するときの例です。生徒に番号をLINEで届けるだけなら、連携済みのサービスの「Lメンバーズカード」(LINEの会員証)でもできます(予約エンドポイントに対応した連携サービス)。
必要なもの

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

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

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

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

まずはAPI資料をお申し込みください

API資料のお申し込み からご請求いただくと、概要資料と、機密保持契約(NDA)の手続きのご案内をお送りします。NDAの締結後に、API仕様書と、動作を確かめるためのサンプルのアカウントとデバイスの情報をお送りします。手続きの流れは RemoteLOCK APIのご利用までの手続き に、そのほかの使い方は RemoteLOCK APIでできること にまとめています。
関連する記事

最終更新

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

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

記事で解決しないときは

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