お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

概要

1. フォーム項目が自動入力されることで、回答者の時間と労力を削減できます。
   
2. 手入力ミスが減り、データの正確性が向上します。
   
3. 回答者に合わせたパーソナライズされた体験を提供できます。

1. フォームの作成が完了したら、フォームビルダーで設定タブ >Prefill>Dynamic Prefill - Webhookに進みます。
   
   
   
   
2. 設定するをクリックします。
   

1. Webhook 設定

検索する設定

検索する項目:検索する項目は、外部サービスから関連情報を取得するために使用されるフォーム項目です。ドロップダウンからフォーム項目を選択し、検索する項目として設定してください。
検索する項目として選択できるフォーム項目は以下の通りです：
シングル折れ線グラフ、メール、電話番号、ドロップダウン、ラジオ、番号

メモ:

1. ユーザーが有効なフォーム上の検索する項目の横にある検索するアイコンをクリックすると、Webhookが実行され、レスポンスがフォームに自動入力されます。
   
2. 検索する項目に（項目エイリアス経由で）事前に値が入力されている状態でフォームが読み込まれると、自動的に検索処理が実行されます。

Webhook 詳細

1. Webhook URL:Webhook URL は、フォームが外部サービスにリクエストを送信する際のエンドポイントです。外部サービスからデータを取得するための完全なURLを入力してください。
   
2. Authorization 種類:希望するAuthorization 種類として一般またはコントロールパネルで設定された接続のいずれかを選択してください。Authorization 種類に外部連携を選択した場合、Connection 名前の一覧から適切な接続を選択できます。
   
   新しい外部連携を追加した場合は、Connection 名前のドロップダウンリストの横にある更新アイコンをクリックして、新しく追加した接続を選択してください。外部連携の作成についての詳細。
   
   

   メモ: Connection 名前には、既存の有効な外部連携のみが表示されます。外部連携の詳細についてはヘルプをご参照ください。
3. データ 識別子 キー: データ 識別子 キーは、検索項目の値を外部サービスに送信するクエリパラメーターとして使用されます。
   データ検索時、Webhookはデータ 識別子 キーをクエリパラメーターとして含めます。検索項目の値がクエリパラメーターの値として送信されます。
   データ 識別子 キーの値に基づき、外部サービスがフォームに自動入力するためのデータを提供します。
   例:
   例えば、検索する 項目が「入力 your メール」、データ 識別子 キーがメールの場合、ユーザーが検索項目にrichard@zylker.comと入力して検索すると、Webhookは次のようなリクエストを送信します：https://api.zylker.com/getEmpInfo?メール=richard@zylker.com
   
4. URL パラメーター: Webhookリクエストと一緒に追加情報を送信したい場合、このセクションで指定できます。例えば、シークレットキーをリクエストとともに含めることが可能です。これにより認証済みリクエストのフィルタリングに役立ちます。これらのパラメーターはURLのクエリ文字列として追加されます。「パラメーターを追加する」をクリックし、テキストボックスにパラメーター名と値を入力してください。
   
5. カスタム ヘッダー: Webhookリクエストに含めるカスタムヘッダー名と値を設定できます。 ヘッダーの名前とこのヘッダーに関連付ける値を入力してください。

メモ: URLパラメーターおよびカスタムヘッダーは、それぞれ最大5つまで追加できます。

2. Webhook テスト

この手順では、Webhook が検索する項目に入力された値に基づいて正しいデータを取得できるかテストできます。

1. 「<検索する 項目の値>」の部分にサンプル値を入力し、テストを実行してリクエストを外部サービスに送信します。
   例えば、データ識別子キーがメールの場合は、テスト用メールアドレス（richard@zylker.com）を入力します。
2. 「テストを実行」をクリックします。これにより、指定したテスト値（richard@zylker.com）を使用して、外部サービスにテストリクエストが送信されます。
   https://api.zylker.com/getEmpInfo?メール=richard@zylker.com
   
3. 受信したレスポンスの形式が有効かどうかが確認されます。レスポンスが有効な場合のみ、次の手順に進むことができます。
   
   
   
   

3. プレフィルマッピング

次の手順では、取得したデータからどのフォーム項目に情報を自動入力するかを決定します。

外部サービスから取得したデータで自動入力したいフォーム項目をマッピングします。

1. 追加したいフォーム項目を選択し、それに対応する項目をクリックします。
   
   
   JSONレスポンスのポップアップが開きます。必要なデータを含むJSONレスポンス内のキーを特定し、マッピングのために選択します。
   
   
   
   日付および 日付-時間項目の場合、期待する 形式を選択することができます。Webhookから受信した日付値は選択された形式で、フォームの設定（設定 > 一般 > 日付 & 時間 > 日付の形式）で構成された日付の形式に変換され、有効なフォームに自動入力されます。
   
   
   
   
   
   これを自動入力したいすべてのフォーム項目に対して繰り返します。
   
   
   
   
2. フォーム内にサブフォーム項目があり、それらも自動入力したい場合は、サブフォーム項目と対応する外部サービスのデータ項目を同様にマッピングしてください。

メモ: 最大で50項目までマッピングできます（サブフォーム内でマッピングされた項目も含みます）。

項目タイプごとのResponse形式

フォーム項目に対応するResponse形式を確認してください。

項目種類	例	Response形式
Single 折れ線グラフ, Multi 折れ線グラフ, 住所, 名前, ドロップダウン, Radio	Richard
番号, 評価, Slider	100
通貨, 小数	100。5
メール	richard@zylker。com
Webサイト	www。zylker。com
電話番号	2436673893
日付	2024-08-23	yyyy-MM-dd
時間	14:30	HH:mm
日付-時間	2024-12-30T10:05:59。564600+08:00	yyyy-MM-dd'T'HH:mm:ss。SSSXXX
チェックボックス、複数選択、画像選択	[100。50, 101。50]	JSON配列
Decision 箱	真
サブフォーム	[ { <SUBFORM_ROW_1> }, { <SUBFORM_ROW_2> } ]	JSON配列

メモ:

1. これは、すべてのユーザーとフォームを含む、組織のアカウントにおける合計上限です。
   
2. 使用状況の詳細は、アカウント Usageから確認できます。
   
3. 上限に達すると、フォームへのアクセスが制限されます。
4. Dynamic Prefill - Webhook機能は、無料プランでは利用できません。
   
5. 上限は、請求間隔に基づき毎月自動的にリセットされます。
   

IPアドレスのホワイトリスト化について参照する場合は、こちらをクリックしてください。