APIとWebhookの活用例

電池交換の作業の自動起票|電池残量が少なくなった扉を、交換の作業の一覧に載せるしくみ

扉の電池残量が少なくなったら、電池交換の作業を、貴社の作業の一覧に自動で載せられます。
メールで受け取るだけなら、お知らせ機能の設定だけで足ります。チャットや台帳に流したいときにWebhookを使います。扉の数が多い施設や、いくつもの拠点を受け持つ担当者向けの例です。
こんなとき

電池の交換を作業の一覧で管理できます

電池残量の低下は、お知らせ機能でメールに知らせられます(お知らせ機能)。扉が多いと、メールを見た人が手で作業を書き起こすことになり、書き漏らしや、二人が同じ扉に向かうことが起きます。Webhookで電池残量の低下の知らせを受けて作業の一覧に載せるようにすると、交換の担当と期限を一つの場所で管理できます。
しくみ

電池残量の低下の知らせから、作業を作ります

電池残量の低下から交換までの流れの図。1 RemoteLOCK:電池残量の低下を知らせる。扉のIDと電池残量の値が入ります。2 貴社が作る受け口:扉のIDを名前に置き換える。設置場所と扉の名前の対応表を使います。3 貴社が作る受け口:交換の作業を一覧に載せる。同じ扉の作業が残っていれば足しません。4 交換の担当者:現地で電池を替える。作業の一覧で担当と期限を確かめます。5 交換の担当者:作業を完了にする。完了は担当者が作業の一覧で付けます。「貴社が作る受け口」は、貴社か開発会社で作っていただく部分です
お知らせ機能で「電池残量の低下」のイベントを選び、通知先にWebhookを登録すると、電池が少なくなった扉の知らせが受け口に届きます。知らせには、扉のIDと電池残量の値が入っています。貴社で作る受け口のプログラムが、扉のIDを設置場所と扉の名前に置き換え、交換の作業として、タスク管理のしくみや台帳に載せます。扉のIDは、クラウド管理画面のURLで確かめられます(デバイスID(UUID)の確認)。
作業を閉じるのは、交換した担当者が作業の一覧で行う形にします。電池交換のイベントはKLシリーズの一覧にないため、交換が済んだことをWebhookで受け取る作りには頼らないでください。同じ扉の作業がまだ残っているときは、新しく作らずに残っている作業に書き足すと、二重に向かうことを防げます。
必要なもの

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

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

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

  • 受け口は、HTTPSで受け、3秒以内に200番台を返す作りにしてください。失敗が続くとWebhookは無効になり、メールでお知らせします(Webhookの受け口の条件)
  • 機種によって受け取れるイベントが違います。すべての扉を対象にするときは、お知らせ機能の情報元を「アカウント」にしてください(お知らせ機能)
始め方

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

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

最終更新

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

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

記事で解決しないときは

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