扉の本体がクラウドと通信できなくなったときと、つながり直したときに、担当者のチャットに知らせられます。
メールで受け取るだけなら、お知らせ機能の設定だけで足ります。チャットや台帳に流したいときにWebhookを使います。拠点が多く、扉の通信の状態をまとめて見たい担当者向けの例です。
こんなとき
通信が切れた扉に、早めに気づけます
扉の通信が切れているあいだは、新しく発行した番号や設定の変更が本体に届きません（ハートビート通信のしくみ）。お知らせ機能で「ネットワークの接続状況」のイベントを選ぶと、切断とつながり直しをメールで受け取れます（お知らせ機能）。拠点ごとに担当が分かれているときや、切れていた時間を記録したいときは、Webhookで受けてチャットや台帳に流します。
しくみ
切断とつながり直しの知らせが、受け口に届きます
本体がしばらくクラウドと通信できず「切断」と判定されると、RemoteLOCKから受け口に、ネットワークの接続状況の知らせが届きます。つながり直したときにも、同じイベントで届きます。ルーターの混雑などで一時的に通信できないだけでは届きません。知らせには、扉のIDと、切断かつながり直しかの別が入っています。貴社で作る受け口のプログラムが、扉のIDを拠点と扉の名前に置き換えて、その拠点の担当者のチャットに投稿します。
つながり直しの知らせを受けたら、同じ扉の切断の知らせと組にして、切れていた時間を台帳に残します。切れているあいだに入る予定のお客様がいるときは、あらかじめ発行して本体に届けておいた緊急用の番号を伝えると、通信を待たずに入っていただけます（ハートビート通信のしくみ）。
必要なもの
始める前に3つがそろっているかお確かめください
| 必要なもの | 中身 |
| アカウントとデバイス | 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること |
| Webhookの登録 | クラウド管理画面の「高度な機能」→「お知らせ機能」で、通知先と受け取るイベントを登録します（お知らせ機能）。Webhookを受けるだけなら、APIのご利用の手続き（NDA）は要りません |
| 受け口のプログラム | 知らせを受けて処理するプログラムは、貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません |
気をつける点
作る前にお確かめいただきたいこと
- 受け口は、HTTPSで受け、3秒以内に200番台を返す作りにしてください。失敗が続くとWebhookは無効になり、メールでお知らせします（Webhookの受け口の条件）
- 機種によって受け取れるイベントが違います。すべての扉を対象にするときは、お知らせ機能の情報元を「アカウント」にしてください（お知らせ機能）
- 扉のIDは、クラウド管理画面のURLで確かめられます。拠点と扉の名前との対応表は、扉を増やしたり替えたりしたときに直してください（デバイスID（UUID）の確認）
始め方
まずはお知らせ機能で通知先をご登録ください
Webhookの通知先は、クラウド管理画面の「高度な機能」→「お知らせ機能」→「通知先」で登録し、受け取るイベントを選びます（お知らせ機能）。届く内容の例は Webhookでのイベント情報の取得 にあります。カギの発行などをAPIで自動にしたいときは、API資料のお申し込み からご請求ください。
関連する記事