外部予約サイトを KAGURA に統合
各サービスから KAGURA に予約を流し込むことで、予約一覧・売上見込・カレンダーがすべての経路を横断して一元的に確認できます。 重複の予約は externalRef.{source, id} で自動的に弾かれます。
cal.com
Webhookcal.com の予約が作成・変更・キャンセルされたタイミングで、自動的に KAGURA の予約一覧に同期されます。
読み込み中…設定手順
- cal.com にログインし、Settings → Developer → Webhooks を開く
- 「+ New Webhook」を押す
- 右の Webhook URL をコピーして「Subscriber URL」に貼り付け
- Triggers で BOOKING_CREATED / BOOKING_RESCHEDULED / BOOKING_CANCELLED にチェック
- Active を ON にして保存
LINE 公式アカウント
BotLINE Bot 上で「予約」のキーワードや専用フローを通って入った予約を、自動で KAGURA に取り込み、お客様への確認メッセージも自動送信します。
読み込み中…設定手順
- LINE Harness の Webhook 連携で、予約フローの最終ノードに「KAGURA 予約として送信」を追加
- POST 先 URL に右の URL を指定
- JSON 本文(externalId / lineUserId / customerName / menuName / startAt 必須)を組み立てて送る
- 受信した予約は /reservations に表示され、確認メッセージが自動で push されます
lineUserId が含まれていれば、予約確認メッセージが LINE で自動配信されます。
ホットペッパービューティー
メール経由ホットペッパービューティーには公開 API がないため、新規予約通知メールを Gmail / Make / n8n / Zapier などで解析して JSON を POST する形で取り込みます。
読み込み中…設定手順
- ホットペッパー予約通知メールが届く Gmail / Outlook を用意
- Make / n8n / Zapier / Gmail App Script のいずれかで「メール → JSON 抽出 → HTTP POST」シナリオを作成
- POST 先 URL に右の URL を指定
- JSON 本文に externalId(HPB 予約 ID)/ customerName / menuName / startAt / priceJpy を入れる
- メール解析テンプレートが必要な場合は管理者にお問い合わせください
管理画面から手動で予約を貼り付けたい場合は /reservations 右上の「JSON 取り込み」もご利用いただけます。
PeakManager(書き戻し)
双方向KAGURA の /book /book/new から入った予約を、自動で PeakManager 側のマスタースケジュールにも登録します。 KAGURA メニュー ⇔ PM コース、KAGURA スタッフ ⇔ PM スタッフ の対応付けがここで必要です。
Worker の
PEAK_MANAGER_RUN_TOKEN と同じ値を入力してください。 ブラウザの localStorage にのみ保存され、サーバーには送信時のみ付与されます。予約フォーム
/book から予約が入ると、バックグラウンドで自動的に PM に登録されます。 失敗時は上の「書き戻しログ」から詳細と再送が可能です。参考:JSON ペイロード仕様
LINE → KAGURA
{
"externalId": "line_msg_xxx",
"lineUserId": "U1234abcd...",
"customerName": "山田 花子",
"menuName": "整体 60分",
"startAt": "2026-05-01T10:00:00+09:00",
"slotMin": 60,
"treatmentMin": 50,
"priceJpy": 6600
}ホットペッパー → KAGURA
{
"externalId": "HPB-12345678",
"customerName": "鈴木 一郎",
"customerPhone": "090-0000-0000",
"menuName": "カット + カラー",
"startAt": "2026-05-02T15:30:00+09:00",
"slotMin": 90,
"priceJpy": 9800,
"sourceUrl": "https://beauty.hotpepper.jp/...",
"customerType": "new"
}