解錠などの知らせ(Webhook)をMakeのシナリオで受けて、表やチャットに流せます。
自社でサーバーを用意せずに、Webhookの受け口を組み立てるときの例です。Makeの画面の操作は、Makeの案内をご覧ください。
こんなとき
受け口を自動化のサービスで組み立てられます
Webhookを受けるには、知らせを受け取るURL(受け口)が要ります。自社でサーバーを用意する代わりに、Makeのような自動化のサービスで受けて、表やチャットへの書き込みにつなぐこともできます。Webhookを受けるだけなら、NDAは要りません。
しくみ
Makeの受け口のURLを、お知らせ機能の通知先に登録します
Makeで受け口のURLを用意し、クラウド管理画面の「高度な機能」→「お知らせ機能」で通知先として登録して、受け取るイベントを選びます。扉が開くと、RemoteLOCKからそのURLに解錠の知らせが届き、シナリオが動きます。知らせには、開いた扉、時刻、使われたカギのIDが入っています(Webhookでのイベント情報の取得)。
シナリオでは、まず届いた知らせのシークレット(通知先の登録で決めた秘密の値)を確かめ、違うものは先に進めません。次に、使われた番号の値を落とし、IDを名前に置き換えてから、表に1行足したりチャットに投稿したりします。受け口の条件はMakeで受けるときも同じです。Makeの側の応答のしかたは、Makeの案内でお確かめください。
※ Makeは、Webhookを受けて自作するときの例です。RemoteLOCKと連携済みのサービスではありません。連携済みのサービスは 予約エンドポイントに対応した連携サービス と 連携システム一覧(公式サイト)でご覧いただけます。
必要なもの
始める前に3つがそろっているかお確かめください
| 必要なもの | 中身 |
| アカウントとデバイス | 有効なRemoteLOCKのアカウントに、扉のデバイスが登録されていること |
| Webhookの登録 | クラウド管理画面の「高度な機能」→「お知らせ機能」で、通知先と受け取るイベントを登録します(お知らせ機能)。Webhookを受けるだけなら、APIのご利用の手続き(NDA)は要りません |
| 受け口のプログラム | 知らせを受けて処理するプログラムは、貴社か、ご依頼先の開発会社で作っていただきます。弊社は開発の受託や技術支援を行っておりません |
気をつける点
作る前にお確かめいただきたいこと
- 受け口は、HTTPSで受け、3秒以内に200番台を返す作りにしてください。失敗が続くとWebhookは無効になり、メールでお知らせします(Webhookの受け口の条件)
- 解錠の知らせには、使われた暗証番号やカード番号の値がそのまま入ります。チャットや表に流すときは、受け取った直後にその項目を落としてください
- 機種によって受け取れるイベントが違います。すべての扉を対象にするときは、お知らせ機能の情報元を「アカウント」にしてください(お知らせ機能)
- シナリオは知らせが届くたびに動きます。Makeの料金や使える量はMakeの案内でお確かめのうえ、受け取るイベントは必要なものに絞ってください
始め方
まずはお知らせ機能で通知先をご登録ください
Webhookの通知先は、クラウド管理画面の「高度な機能」→「お知らせ機能」→「通知先」で登録し、受け取るイベントを選びます(お知らせ機能)。届く内容の例は Webhookでのイベント情報の取得 にあります。カギの発行などをAPIで自動にしたいときは、API資料のお申し込み からご請求ください。
関連する記事