あなたも興味があるかもしれません...
ウェブ開発におけるWebhookとは、カスタムコールバックを使用してウェブアプリケーションの動作を拡張または変更する手法のことです。これらのコールバックは、必ずしも元のアプリケーションと提携していないサードパーティのユーザーや開発者によって維持、修正、管理される場合があります。
QuestionProは、インカミング(受信)とアウトゴーイング(送信)の両方のWebhookをサポートしています。Webhookは、アンケートの開始前、アンケートの途中(質問の前または後)、またはアンケートの完了後に実行させることができます。インカミングWebhookは、外部ソースからアンケート内にデータを取得するためのシンプルな方法です。
アウトゴーイングWebhookは、アンケートデータを外部ソースに送信するために使用されます。JSONペイロードを伴う通常のHTTPリクエストを利用します。
Webhookを作成する手順は以下の通りです:
外部リソースから取得したデータは、カスタム変数にマッピングして保存できます。マッピング用のダイアログボックスを開くには、カスタムマッピングの追加 ボタンをクリックします:
個々のJSONキーを特定のカスタム変数に割り当てることで、データをマッピングできます。また、カスタム変数に任意の表示名を割り当てることも可能です:
マッピングが設定されると、収集したデータをアンケート内に次のコードを使って表示できます: ${DisplayName}
アウトゴーイングWebhookの場合、リクエストJSONにカスタム変数を追加することで、カスタム変数内に収集されたデータを外部のウェブサービスに送信できます。
リクエストJSON内で対応するカスタム変数のデータを取得するには、以下のタグを使用できます:
カスタム変数 1: ${custom1}
カスタム変数 2: ${custom2}
カスタム変数 3: ${custom3}
カスタム変数 4: ${custom4}
カスタム変数 5: ${custom5}
カスタム変数 N: ${customN}
QuestionProは各Webhookのログ機能を提供しており、そのWebhookによって呼び出されたAPIの詳細、ペイロード、およびエンドポイントからのレスポンスを確認できます。ログにアクセスするには、特定のWebhookの設定画面を開いてページ最下部までスクロールします。そのWebhookによって行われたリクエストの一覧が表示され、IDをクリックすると、特定の呼び出しの詳細を確認できます。
また、データ送信に失敗したアウトゴーイングコールがある場合は、そのAPI呼び出しの前に「手動再試行(Manual Retry)」ボタンが表示され、いつでもクリックしてデータをAPIエンドポイントに再送信できます。
この機能は、次のライセンスで使用できます。