予約ブリッジ for kintone

セットアップガイド

15分で公開予約ページを作る

kintone のシステム管理者権限と、予約を溜めるアプリの管理権限が必要です。

00

予約を溜めるアプリを用意する

既存のアプリでも新規でも構いません。次のフィールドがあれば動きます。

  • 日時(予約開始)— 必須
  • 文字列(1行)(氏名)— 必須
  • 文字列(1行): メール・電話・予約ID / 文字列(複数行): 備考 / 日時: 予約終了 / ドロップダウン: ステータス — 任意
「予約ID」用の1行テキストを用意しておくと、レコードIDが手元にない場合でも予約IDで照合してキャンセルを反映できます。空き枠の判定でも、自分が作ったレコードを二重に数えずに済みます。
01

APIトークンを発行する

アプリの設定 → 「カスタマイズ/サービス連携」→「APIトークン」→「生成する」。権限は レコード閲覧・レコード追加・レコード編集 にチェックを入れ、「保存」→「アプリを更新」してください。

「アプリを更新」をしないとトークンは有効になりません。接続に失敗する原因の大半はこれです。
02

プラグインを読み込む

お試し開始時にダウンロードした plugin.zip を、kintone の「システム管理 → プラグイン → 読み込む」で追加します。

03

アプリにプラグインを追加して接続する

アプリの設定 → 「プラグイン」→「追加する」で「予約ブリッジ for kintone」を選び、歯車アイコンから設定画面を開きます。ライセンスキーと手順1のAPIトークンを入力して「接続して設定に進む」を押すと、アプリのフィールド一覧が読み込まれます。

ライセンスキーとAPIトークンはプラグインの設定に保存しません(プラグイン設定はアプリを見られる人なら読めるためです)。設定を変更するときは、その都度もう一度入力してください。

ゲストスペース内のアプリにも対応しています。そのままゲストスペースのアプリ設定画面から開いてください。

04

受付時間と書き込み先を設定する

  • 受付時間: 曜日ごとの開始・終了、枠の長さ、枠の間隔、定員、受付締切(何分前まで)、受付期間(何日先まで)、休業日。
  • 書き込み先: 予約開始日時と氏名は必須。ほかは任意で、選ばなかった項目は書き込みません。保存時に実際のアプリのフィールド構成と照合し、型が合わない設定や、値を入れられない必須フィールドが残っている場合は保存できません。
  • 予約フォーム: 電話・備考の有無、備考欄のラベル、個人情報の取扱いに関する表示文。
  • 埋まっている予定の判定: チェックすると、このアプリの既存レコード(開始・終了日時)と重なる枠を空きから外します。キャンセル済みを除外するには除外条件に ステータス not in ("キャンセル") のように書きます。

「保存して公開」を押すと公開URLが表示され、アプリの設定にも保存されます。最後にアプリの 「設定を保存」→「アプリを更新」

05

公開URLを配る

レコード一覧の上部に「予約ページを開く」ボタンが出ます。URLをメールやWebサイトに貼ってください。予約が入るとレコードが作られ、予約者には確認メール(.ics・キャンセルURL付き)が届き、前日の朝にリマインドが届きます。

予約の一覧・ライセンス・請求は 契約者ページ で確認できます。

うまくいかないとき

  • 「接続」で失敗する: APIトークンの権限と「アプリを更新」を確認。ライセンスはお試し開始時に入力したドメインでのみ使えます。
  • 予約がレコードにならない: 5分ごとに自動で再試行します。フィールドの型(日時・文字列)が設定と合っているか確認してください。契約者ページで「登録待ち/失敗」を確認できます。
  • メールが届かない: 迷惑メールフォルダをご確認ください。
  • 解決しない場合は contact@fermion.company まで、ライセンスキーと発生時刻を添えてご連絡ください。