APIとWebhookの活用例

MakeでのWebhookの受け取り|解錠などの知らせをMakeのシナリオで受けて、表やチャットに流す組み立て

解錠などの知らせ(Webhook)をMakeのシナリオで受けて、表やチャットに流せます。
自社でサーバーを用意せずに、Webhookの受け口を組み立てるときの例です。Makeの画面の操作は、Makeの案内をご覧ください。
こんなとき

受け口を自動化のサービスで組み立てられます

Webhookを受けるには、知らせを受け取るURL(受け口)が要ります。自社でサーバーを用意する代わりに、Makeのような自動化のサービスで受けて、表やチャットへの書き込みにつなぐこともできます。Webhookを受けるだけなら、NDAは要りません。
しくみ

Makeの受け口のURLを、お知らせ機能の通知先に登録します

解錠から表やチャットまでの流れの図。1 来訪者:暗証番号で扉を開ける。発行された番号やQRコードを使います。2 RemoteLOCK:解錠の知らせを送る。通知先に登録したURLに届きます。3 Makeのシナリオ:知らせを受け取る。Makeで用意した受け口のURLで受けます。4 Makeのシナリオ:送り主と中身を確かめる。シークレットを見て、番号の値を落とします。5 Makeのシナリオ:IDを名前に置き換える。IDと名前の対応表を引きます。6 Makeのシナリオ:表やチャットに送る。例:表に1行足し、チャットに投稿します。7 担当者:表やチャットで入室を見る。管理画面を開かずに済みます。「Makeのシナリオ」は、貴社で組み立てていただく部分です
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資料のお申し込み からご請求ください。
関連する記事

最終更新

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

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

記事で解決しないときは

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