発行した暗証番号などが扉に届かなかったときに、担当者のチャットや対応の台帳に知らせられます。
メールで受け取るだけなら、お知らせ機能の設定だけで足ります。チャットや台帳に流したいときにWebhookを使います。番号の発行が多い宿泊施設やレンタルスペース向けの例です。
こんなとき
届かなかった番号を、利用の前に見つけられます
番号が扉に届かないまま利用の時間になると、お客様は扉の前で入れず、現地からの電話で初めて気づくことになります。お知らせ機能で「アクセスユーザー/アクセスゲストの同期失敗」「アクセスゲストの同期遅延」のイベントを選ぶと、番号が届かなかったときや届くのが遅れているときに、メールで知らせが届きます（お知らせ機能）。担当者が何人もいて、誰が対応したかを残したいときは、Webhookで受けてチャットや台帳に流します。
しくみ
同期の失敗が、受け口に届きます
同期失敗と同期遅延のイベントの通知先にWebhookを登録すると、番号が扉に届かなかったときに、RemoteLOCKから受け口に知らせが届きます。貴社で作る受け口のプログラムが、IDを扉の名前に置き換えて、担当者のチャットと対応の台帳に流します。
届かない理由には、扉のWi-Fiが切れている場合や、ほかの番号と重なっている場合（PIN競合）があります。PIN競合のときは、前もって設定しておけば、管理画面からバックアップPINを割り当てられます（バックアップPIN）。Wi-Fiがつながっていて次の通信を待っているだけなら、現地の人に本体のキーを一度押してもらうと通信が起き、番号が同期されます（ハートビート通信のしくみ）。
必要なもの
始める前に3つがそろっているかお確かめください
| 必要なもの | 中身 |
| アカウントとデバイス | 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること |
| Webhookの登録 | クラウド管理画面の「高度な機能」→「お知らせ機能」で、通知先と受け取るイベントを登録します（お知らせ機能）。Webhookを受けるだけなら、APIのご利用の手続き（NDA）は要りません |
| 受け口のプログラム | 知らせを受けて処理するプログラムは、貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません |
気をつける点
作る前にお確かめいただきたいこと
- 受け口は、HTTPSで受け、3秒以内に200番台を返す作りにしてください。失敗が続くとWebhookは無効になり、メールでお知らせします（Webhookの受け口の条件）
- 暗証番号やカギのURLは、見られる人が多い表やチャットに残さないでください。表に書き戻すのは、予約のIDまでにするのがおすすめです
- 機種によって受け取れるイベントが違います。すべての扉を対象にするときは、お知らせ機能の情報元を「アカウント」にしてください（お知らせ機能）
始め方
まずはお知らせ機能で通知先をご登録ください
Webhookの通知先は、クラウド管理画面の「高度な機能」→「お知らせ機能」→「通知先」で登録し、受け取るイベントを選びます（お知らせ機能）。届く内容の例は Webhookでのイベント情報の取得 にあります。カギの発行などをAPIで自動にしたいときは、API資料のお申し込み からご請求ください。
関連する記事