APIとWebhookの活用例

未到着の宿泊客の一覧|夜の決まった時刻に、まだ入室していない宿泊客をまとめて担当者に送るしくみ

夜の決まった時刻に、まだ入室していない宿泊客の一覧を担当者に送れます。
無人や少人数で運営する宿泊施設で、APIで発行したカギと、Webhookで届く解錠の知らせを組み合わせる例です。
こんなとき

その日の宿泊客がそろったかを夜に確かめられます

フロントを置かない宿では、その日の宿泊客がそろったかを確かめる手段が限られます。遅い到着なのか、連絡のない取りやめなのかが分からないと、問い合わせや部屋の扱いの判断が遅れます。解錠の知らせをWebhookで受けて予約と突き合わせると、夜の決まった時刻に、まだ入室していない宿泊客だけを一覧にできます。
しくみ

到着の印を付けておき、夜に印のない予約を拾います

宿泊の予約から未到着の一覧までの流れの図。1 貴社が作る連携:宿泊の予約をAPIで作る。返ってきた人のIDを予約と並べて控えます。2 宿泊客:暗証番号で扉を開ける。予約のカギで入室します。3 RemoteLOCK:解錠の知らせを送る。扉・時刻・カギの人のIDが入ります。4 貴社が作る受け口:IDで予約と突き合わせる。到着した予約に印を付けます。5 貴社が作る連携:夜の決まった時刻に見回す。利用中の予約をAPIで取り出します。6 貴社が作る連携:未到着の一覧を送る。印のない予約だけを担当者に送ります。7 宿の担当者:到着の予定を問い合わせる。遅い到着か、取りやめかを確かめます。「貴社が作る連携」は、貴社か開発会社で作っていただく部分です「貴社が作る受け口」は、貴社か開発会社で作っていただく部分です
APIで予約を作ると、カギのURLと一緒に、その予約のカギを持つ人のIDが返ってきます。貴社で作る連携のプログラムは、このIDを予約と並べて控えます。宿泊客が扉を開けると、RemoteLOCKから受け口(Webhook)に解錠の知らせが届き、そこに同じIDが入っています(お知らせ機能)。受け口は、IDで予約を探して到着の印を付けます。
決めた時刻(例:21時)になったら、連携のプログラムがAPIで利用中の予約を取り出し、印のないものを一覧にして送ります。エントランスと客室の両方を開けられるようにしているときは、どちらの扉の解錠で到着とみなすかを決めておきます。一覧は解錠の知らせが届いていない予約なので、問い合わせの前にクラウド管理画面の履歴でもお確かめください。
必要なもの

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

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

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

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

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

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

最終更新

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

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

記事で解決しないときは

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