Beds24 Webhookで新着メッセージを素早く反映する方法
最終更新日: 2026-10-20
結論
StayReplyは標準でBeds24のゲストメッセージを5分おきに取り込みます。Beds24の「予約Webhook」にStayReplyが発行するURLとヘッダーを設定すると、メッセージの受信・送信や予約の変更のたびにBeds24から通知が届き、通常1分以内に取り込み・AI分類・通知まで進みます。設定は任意で、スタンダードプラン（無料トライアル中を含む）で利用できます。
仕組み
- Beds24でゲストメッセージの受信・送信や予約の変更があると、Beds24がStayReplyへ通知（Webhook）を送ります
- StayReplyは通知を「変化があった」という合図としてだけ受け取り、メッセージ本体は自動同期と同じ方法でBeds24 APIから取得します
- 取り込んだメッセージはすぐにAI分類され、FAQに一致すればメール・Slackで通知されます。夜間返信や（待ち時間を過ぎた）自動送信も、5分おきの同期を待たずに進みます
- Webhookを設定しても5分おきの自動同期は止まりません。通知が届かなかった場合も、自動同期が取りこぼしを拾います
- 同じメッセージが二重に取り込まれたり、二重に自動送信されたりすることはありません
設定手順
- 1StayReplyの「設定」→「Beds24 Webhook（任意）」で「発行する」を押し、Beds24に貼り付けるURLとヘッダー行（x-stayreply-webhook-secret: …）を発行する
- 2Beds24管理画面の Settings > Properties > Access にある「予約Webhook」を開く
- 3Webhook Versionで「2 - no personal data」を選ぶ
- 4URL欄に発行したURL、カスタムヘッダー欄に発行したヘッダー行をそのまま貼り付けてセーブする（Additional Dataは「なし」のままで構いません）
- 5複数の施設がある場合は、すべての施設に同じURLとヘッダー行を設定する
- 6StayReplyの「設定」に表示される「最終受信日時」が更新されれば受信できています
反映までの時間
Beds24でメッセージが作成されてからStayReplyに取り込まれるまで、通常は数十秒〜1分程度です。Beds24から通知が届くまでの時間はBeds24側の状況によって変わり、1分を超えることもあります。Webhookを設定しない場合は、5分おきの自動同期で取り込まれます。
安全性
- URLはアカウントごとに推測できない文字列で発行され、さらにヘッダーに含まれる秘密の値が一致しない通知は受け付けません
- 通知に含まれる施設が、そのアカウントに登録された施設と一致しない場合も受け付けません
- 通知の中身は取り込みの合図としてだけ使い、ゲストの個人情報は保存しません
- URLやヘッダー行が第三者に知られた場合は「再発行」で無効にできます（再発行後はBeds24側も貼り直してください）
料金
Beds24 Webhookの利用に追加料金はかかりません。料金は1施設あたり月額¥1,500（税込）で、1ヶ月の無料トライアルがあります。2施設目以降も1施設につき¥1,500が自動で加算され、1施設内の部屋（ユニット）数による追加料金はありません。
よくある質問
- Q. Webhookの設定は必須ですか？
- A. 必須ではありません。設定しなくても、5分おきの自動同期でゲストメッセージは取り込まれます。返信までのスピードを重視する場合におすすめです。
- Q. Webhook Versionは「with personal data」でも動きますか？
- A. 動きますが、StayReplyは通知の中身を使わないため「2 - no personal data」をおすすめしています。
- Q. 通知が届いているか確認する方法はありますか？
- A. StayReplyの「設定」→「Beds24 Webhook（任意）」に最終受信日時が表示されます。予約の変更やメッセージがあったのに更新されない場合は、URLやヘッダー行の貼り間違い（前後の空白・改行など）を確認してください。