URLパラメータによるフォーム初期値の設定

空き時間リンク（日程調整用リンク）のURL末尾に特定のパラメータを付与することで、日程選択後に表示される「お客様情報の入力フォーム」に初期値をあらかじめ設定することができます。

Webサイトのフォームや外部システムからSpirへ遷移させる際に、既に入力済みの顧客情報を引き継ぐ場合などに便利です。

利用可能なパラメータ

以下のパラメータをクエリパラメータとして空き時間リンクのURL末尾に追加してください。
※ 値に日本語や特殊文字が含まれる場合は、必ずURLエンコードを行う必要があります。

カスタム質問(form_answer)の番号指定について

パラメータ form_answer_{n}_answer の {n} には、フォーム設定画面において上から数えたカスタム質問の順番(1から始まる番号)が入ります。

番号指定のルール 

• 並び順にカウントします: フォーム項目の並び順通りに番号が割り当てられます。

• システム項目は飛ばします： デフォルトで存在する「名前」「メールアドレス」フィールドはカウントに含まれません。これらが間に入っていても、カスタム質問の連番は詰められます。

例) フォームの設定順序とパラメータの対応

1. 会社名(カスタム質問 1つ目) → form_answer_1_answer
2. 名前(システム項目) → invitee_name
3. メールアドレス(システム項目) → invitee_email

4. 電話番号(カスタム質問 2つ目) → form_answer_2_answer

データ形式の仕様

テキスト / 複数行テキスト / メールアドレス / 電話番号

値をそのまま文字列として渡します。

例) ...&form_answer_2_answer=090-1234-5678

チェックボックス

選択肢をカンマ（,）区切りの文字列として渡します。

例) 「会社員」と「無職」を選択状態にする場合
...&form_answer_3_answer=会社員,無職

※ URL内ではエンコードが必要です(例: %E4%BC%9A%E7%A4%BE%E5%93%A1,%E7%84%A1%E8%81%B7)

URL作成例

以下は名前を「Spir太郎」、会社名(カスタム質問1)を「株式会社Spir」として初期値を設定する場合の例です。

元の空き時間URL

https://app.spirinc.com/t/{team}/as/{id}/confirm

パラメータ付きURL

https://app.spirinc.com/t/{team}/as/{id}/confirm?invitee_name=Spir%E5%A4%AA%E9%83%8E&form_answer_1_answer=%E6%A0%AA%E5%BC%8F%E4%BC%9A%E7%A4%BESpir

注意事項

• 確定者の名前の優先順位

  URLパラメータで指定された値は、Spirにログインしているユーザーが既に持っている登録情報よりも優先して表示されます。

• 文字コード

  日本語を含む値はURLエンコードされている必要があります。

• チェックボックスの制限

  選択肢の文言自体にカンマ(,)が含まれている場合、区切り文字と判別がつかず正しく反映されない可能性があります。