Barberlyに公開の予約APIが登場しました。これを使えば、自社のウェブサイト、アプリ、WhatsAppボット、音声エージェント、AIアシスタントから理容室の予約を受け付けられます。適用されるのは、お客様がすでにBarberlyアプリで目にしているのと同じメニュー、スタッフ、空き状況、予約ルールです。
理容室向け予約APIでつくれるもの
- WhatsApp： お客様が普段使っているチャットの中で予約
- AIアシスタント： 実際の空き状況にもとづく予約
- 音声エージェント： 電話予約を自動化
- ウェブサイト： 自社ブランドの、自社独自の予約フロー
- チャットボット： どのチャットウィジェットにも予約ステップを
- 独自連携： 予約を作成するそのほかのあらゆる仕組み
お客様と同じルールで予約します
予約APIは、モバイルアプリ、ウェブサイト、予約ウィジェット、キオスク、Google予約と並ぶ、お客様向けツールのひとつです。バックオフィス用のAPIではありません。レポート、スタッフ管理、設定にはアクセスしません。
自店の予約ページ向けに設定した内容は、すべてそのまま適用されます。
- お客様に非公開の枠は、APIでも非公開です。空き状況はカレンダーのお客様向け表示を反映し、スタッフ向け表示を返すことはありません。
- 予約を手動で承認している場合、API経由の予約も未確定の状態で届きます。
- 会員登録を必須にしている場合、APIでも同様に必須になります。
- 営業時間、受付締切、施術時間、どの理容師が何を担当するかは、設定からリアルタイムで読み込まれます。
APIが独自のルールを作ることはなく、どのルールも回避できません。
予約APIでできること
- カタログ： 店舗、スタッフ、オプション付きメニュー
- 空き状況： 店舗、理容師、メニューごとの空いている日と時間枠
- 予約： 作成、参照、変更、キャンセル
- 顧客アカウント： 会員登録、ログイン、パスワードのリセット
APIキーとスコープ
まず、店舗、スタッフ、メニュー、営業時間をBarberlyで設定してください。APIはその設定を読み取るだけで、作成はしません。そのうえで、Barberlyポータルの Apps → Booking API → Create key からキーを発行し、必要なスコープだけを付与します。
| スコープ | 許可される操作 |
|---|---|
catalog:read | 店舗、スタッフ、メニュー、空き状況 |
bookings:read | 予約の参照 |
bookings:write | 予約の作成、変更、キャンセル |
accounts:write | 顧客アカウントの登録、ログイン、復旧 |
キーは X-Api-Key ヘッダーで送信します。キーは同じ画面で無効化や削除ができます。
ライブデモを試す
公開デモ店舗上で、実際に動作するゲスト予約フローを2種類ご用意しています。すぐに実データが表示されます。どちらも、店舗、理容師、オプション付きメニュー、日時、お客様情報、確認までをログインなしで進めます。
- Appointment hub：4つの項目を、お客様が好きな順番で入力できる1枚のカード
- Guided wizard：進捗バー付きの5ステップ
ソースコードは GitHub で公開しています。読んだり、コピーしたり、自分のプロジェクトに取り込んだりできるReactのサンプルです。
ドキュメント
- APIリファレンス：すべてのエンドポイントと項目
- OpenAPIドキュメント：お使いの言語でクライアントを生成できます
よくある質問
予約APIに追加料金はかかりますか？
いいえ。予約APIはBarberlyのサブスクリプションに含まれています。追加料金はかかりません。
開発者ではありません。連携をつくるにはどうすればよいですか？
ChatGPT、Claude、またはほかのAIエージェントに APIリファレンス のリンクを渡し、やりたいことを説明してください。数分で、たたき台となる動作する実装ができあがります。
n8n、Make、Zapierと連携できますか？
はい。ヘッダー付きのHTTPリクエストを送れるツールであれば、どれでもAPIを呼び出せます。n8nのHTTP Requestノード、MakeのHTTPモジュール、Zapierのカスタムリクエストなどです。これらのツールで予約の作成、変更、キャンセルができます。ただし、APIにはまだWebhookがないため、Barberly内で行われた変更に反応することはできません。
音声エージェントやChatGPTから予約できますか？
はい。VapiやRetellなどの音声プラットフォームは外部APIをツールとして呼び出せます。また、ChatGPTのカスタムGPTは OpenAPIドキュメント を読み込み、キーをヘッダーで送信できます。どちらも現在のAPIで対応できます。
お客様にはいつもの予約確認が届きますか？
はい。API経由の予約でも、モバイルアプリやウェブサイト向けに設定したのと同じ通知が送信されます。
保証金や前払いはどうなりますか？
予約APIは支払いを受け付けません。保証金や前払いが必要な場合は、まず自社のフローで受け取り、その後APIで予約を作成してください。
どの予約がAPI経由かを確認できますか？
はい。予約の履歴で、API経由の予約には予約APIで作成されたことが表示されます。ほかの予約にモバイルアプリやウェブサイトが表示されるのと同じです。
API経由で予約したお客様は顧客リストに追加されますか？
はい。ほかのお客様と同じように顧客リストに追加され、予約が完了済みになるとロイヤリティポイントが貯まります。
テストモードはありますか？
いいえ。開発中は、作成したテスト予約をキャンセルしてください。
Barberlyで予約が変更されたとき、自社のシステムに通知されますか？
自動では通知されません。Webhookはまだありません。予約を確認するには、IDで予約を再度取得してください。
複数の店舗があります。店舗ごとにキーが必要ですか？
いいえ。1つのキーですべての店舗に対応できます。アプリやウェブサイトと同じく、店舗はお客様が予約時に選びます。
予約APIはウォークインやウェイトリストに対応していますか？
いいえ。予約APIは予約専用で、予約の作成、参照、変更、キャンセルを扱います。ウォークインのキューとウェイトリストは、キオスクとBarberly Businessアプリが担当します。
