概要
このページで整理していること
- Beds24 webhookは、支払い後に発行されるHinoki workspaceと受信用URL・secretが揃ってから設定する。
- 最初は対象物件を絞り、予約作成・変更・キャンセル相当のイベントがHinoki側で受信されるか確認する。
- Webhookは予約情報連携の入口であり、返金・補償・クレーム判断を自動化するものではない。
使用説明
購入後のBeds24 webhook導入手順
Hinoki Concierge の有料workspaceを有効化したあと、Beds24 webhookを設定して予約イベントをHinokiに連携するための使用説明ページです。準備物、設定順序、テスト、公開前チェックを整理します。
Public page
ポイント
1. 事前に準備するもの
Beds24 webhookは、有料workspaceの発行後に設定します。Hinoki側でworkspace ID、対象物件、Beds24 property ID、受信用URL、webhook secretを確認してからBeds24側へ登録します。
同時に、ゲストへ出してよいチェックイン案内、Wi-Fi、駐車場、ゴミ出し、ハウスルールなどの正本も確認します。予約情報だけが連携できても、案内文が未整理だと安全な自動対応にはなりません。
- Hinoki workspace ID
- 対象物件名とHinoki property ID
- Beds24 property ID または予約側の識別子
- Hinokiが発行するwebhook URLとsecret
- 公開済みまたは確認済みのQRガイド/FAQ正本
ポイント
2. Beds24側でwebhookを登録する
Beds24管理画面のWebhook/API関連設定で、Hinokiから案内された受信用URLを登録します。画面名や表示位置はBeds24側の仕様変更で変わる可能性があるため、実際の設定時はHinokiの導入担当またはBeds24の最新ドキュメントに合わせて確認します。
イベント種別は、まず予約作成、予約変更、キャンセル相当の通知から始めます。全イベントを一度に送るより、Hinoki側で使う予約連動範囲に絞る方が検証しやすくなります。
- Endpoint URL: Hinoki workspace発行後に提示されたURLを使用
- Secret/Header: Hinokiが発行したsecretを設定し、公開資料には載せない
- Events: booking created / modified / cancelled 相当から開始
- Scope: 初回は対象物件を限定してテスト
ポイント
3. Hinoki側で受信を確認する
Beds24からテスト送信またはテスト予約を作成したら、Hinoki側でイベント受信、署名/secret確認、物件マッピング、予約IDの保存、案内条件の判定を確認します。
この段階では、自動返信やゲスト向け公開を急ぎません。受信ログに問題がないか、対象外イベントが混ざっていないか、担当者へ止めるべきケースがDeskへ渡るかを確認します。
- Webhook受信ログが残っている
- Beds24 propertyとHinoki propertyが正しく対応している
- 予約日・人数・ステータス変更が反映される
- 未対応イベントは自動送信せず担当者確認に止まる
ポイント
4. 公開前テストで確認するシナリオ
少なくとも、予約作成、チェックイン日変更、人数変更、キャンセル相当、同一ゲストからの定型FAQ、返金や破損などの例外問い合わせを確認します。
Hinokiの価値は、すべてを無条件で自動化することではなく、確認済み情報で返せるものと担当者判断に止めるものを分けることです。テストでは、返してよい回答だけが出るかを見ます。
- 予約作成後に到着案内が使える状態になる
- 日付変更後に古い案内条件が残らない
- キャンセル/返金関連は自動回答で確定しない
- ゲスト向けQRガイドは予約情報がなくても基本FAQを表示できる
ポイント
5. 公開後の運用
公開後1週間程度は、受信ログ、失敗通知、ゲスト問い合わせ、担当者引き継ぎの量を確認します。Webhookが一時的に失敗しても、QRガイドと登録済みFAQだけで基本案内を継続できる状態にしておくと安全です。
Secretが漏えいした可能性がある場合、担当者が変わった場合、対象物件を増やす場合は、secret再発行や対象スコープの見直しを行います。
- 初週はログと問い合わせ内容を毎日確認
- 失敗時の担当者通知を確認
- 対象物件を増やす前に1物件で安定化
- secretは必要に応じて再発行
FAQ
よくある確認ポイント
支払い前にBeds24 webhookを設定できますか？
通常は支払い後にworkspace、受信用URL、webhook secretが揃ってから設定します。導入前の確認は公開ガイドや相談窓口で行い、実際のsecretは公開ページに載せません。
Beds24 webhookを入れると、すべての返信が自動になりますか？
いいえ。Webhookは予約情報をHinokiに知らせる入口です。返金、補償、破損、クレームなど判断が必要な内容は担当者対応に止める前提です。
Webhookが失敗した場合、ゲスト対応は止まりますか？
予約連動が必要な一部処理は確認が必要になりますが、QRガイドや登録済みFAQの基本案内は分けて運用できます。失敗通知と担当者確認の導線を用意しておくことが重要です。
Webhook secretをなくした、または漏えいした場合はどうしますか？
Hinoki側でsecretを再発行し、Beds24側の設定を差し替えます。古いsecretは使わない前提にし、公開ドキュメントやゲスト向け資料には記載しません。