Webhook の受け口は、HTTPS で受け、3秒以内に 200番台の番号を返してください。返せないと RemoteLOCK は送り直し、6回送り直しても受け取れないときは、その Webhook を無効にしてメールでお知らせします。
対象:RemoteLOCK API やお知らせ機能の Webhook を受けるサーバーを作る方
HTTPS の受け口
Webhook を受ける URL は、HTTPS で受けられるようにしてください。
通知の送り元の確認
Webhook の通知先を登録するときに決めた秘密の値(シークレット)が、通知のヘッダー(
X-Secret)に入って届きます。受け口では、この値が登録した値と同じかを確認し、違うものは捨ててください。応答の期限(3秒以内に200番台)
- 通知を受けたら、3秒以内に 200番台の番号(200 OK、202 Accepted など)を返してください
- 3秒を超えたり、200番台以外を返したりすると、失敗とみなされ、あとで送り直されます
- データベースへの書き込みなど時間のかかる処理は、応答を返したあとに行ってください(いったん受け取ってから、別の処理に回す作りにします)
- 通知は、必要なイベントだけを選んで設定してください
失敗が続いたときの流れ
- 失敗した通知は、時間をおいて送り直されます
- 失敗が3回続くと、RemoteLOCK のアカウントのメールアドレスに、無効にする前の警告のメールが届きます(Webhookの失敗を知らせるメール)
- 6回送り直しても成功しないと、その Webhook は無効になり、通知が止まります(無効なwebhookの停止処理の追加)。無効にしたことを知らせるメールも届きます(Webhookの失敗を知らせるメール)
無効になったときの戻し方
受け口が上の条件を満たしているかを確認してから、クラウド管理画面の「高度な機能」→「お知らせ機能」→「通知先」を開きます。無効になった Webhook は「有効」の列が「無効」になっているので、編集の画面で「有効」にチェックを入れてください。
使い方の例 知らせを受けてチャットや表に流す組み立ては、活用例にまとめています(MakeでのWebhookの受け取り、入室のチャット通知)
関連記事
※ 3秒以内の応答は、リリースノート「無効なwebhookの停止処理の追加」によります。再送の回数は、2026年10月21日に確認した今の動きです。