Webhook

Webhook

誰かがアンケートに回答したときに、Webhookの仕組みを通じて、他のアプリケーションやサービスと連携することが可能です。できます。アンケートの回答データを他のアプリケーションやサービスに送信することができます。アプリケーションやサービス側では、受け取ったデータをもとに処理を進めることが可能です。

Webhookを設定するには:

  1. アンケートの編集画面で[連携]タブをクリックします。
    連携
  2. 画面左側のメニューから[自動処理]をクリックします。
    自動処理
  3. [Webhook]の欄で、[作成する]をクリックします。
    Webhookの作成
  4. [名前]欄にWebhook名を入力します。
    新しいWebhook
  5. 通知するURLを[POST URL]欄に入力します。
    1. アンケートの回答データをリクエストの本文(ボディ)に挿入するには、[リクエストの本文]セクションで、リクエストの形式を選択します。
      1. フォームのデータ:回答をフォームデータとして送信します
      2. JSON:回答をJSON形式で送信します
        1. [名前]欄にパラメーターのキーまたは名前を入力します。
        2. [値]の選択肢をクリックすると、指定したパラメーター名に対応する値として、回答データを関連付けることができます。値を直接指定するには、[値]の選択肢で、[指定した値]を選択し、対応する値を入力します。

    2. [クエリーパラメーター]に回答データを挿入するには、[クエリーパラメーター]セクションで、[クエリーパラメーターを追加する]をクリックします。また、[ヘッダー]に回答データを挿入するには、[ヘッダー]のセクションで[ヘッダーのデータを追加する]をクリックします。
      クエリーパラメーターとヘッダー
      1. [名前]欄にパラメーターのキーまたは名前を入力します。
      2. [値]の選択肢をクリックすると、指定したパラメーター名に対応する値として、回答データを関連付けることができます。値を直接指定するには、[値]の選択肢で、[指定した値]を選択し、対応する値を入力します。[ヘッダー]セクションは、APIキー、OAuthトークン、認証トークンなど、認証目的でよく使用されます。質問を関連付けることができるのは、[リクエストの本文][クエリーパラメーター]セクションでのみです。
      3. 名前とキーを追加するには、[+]をクリックします。
      4. 追加したデータを削除するには、[X]をクリックします。

  6. [保存する]をクリックします。

JSONデータの例(名前付き)

jsonName={ "singleChoice":"Agree", "directValue":"Zoho Survey", "multiChoice":[ "Sunday", "Thursday", "Saturday" ], "numeric":"1996", "email":"  xyz@zoho.com ", "responseId":"xxxxxxxx155013" } 

JSONデータの例(名前なし)

{ "singleChoice":"Agree", "directValue":"Zoho Survey", "multiChoice":[ "Sunday", "Thursday", "Saturday" ], "numeric":"1996", "email":"  xyz@zoho.com ", "responseId":"xxxxxxxx155013" } 


Notesメモ
  1. 現在、POSTメソッドのみサポートされています。
  2. データ連携において、回答内容に応じた分岐が設定されている項目はサポートされていません。

作成したWebhookを編集するには:

  1. アンケートの編集画面で[連携]タブをクリックします。 
  2. 画面左側のメニューから[自動処理]をクリックします。 
    自動処理
  3. [Webhook]の欄で、[管理する]をクリックします。 
    Webhookの管理
  4. Webhookを編集するには、Webhooksの編集アイコンをクリックします。 
  5. 作成したWebhookを削除するには、削除アイコンをクリックします。 
  6. 確認ポップアップで[削除する]をクリックします。 
    Webhookの削除の確定
  7. 連携先のサーバーやアプリとのアンケートの同期状況を確認するには、Webhookの同期の状況のアイコンをクリックします。 

Webhookの同期の状況を確認するには:

  1. アンケートの編集画面で[連携]タブをクリックします。
  2. 左メニューで[自動処理]をクリックし、Webhook欄の[管理する]をクリックします。
  3. 作成したWebhookの[同期の状況]アイコンをクリックします。
  4. 各回答の状況を確認するには、回答にカーソルを合わせて、Webhookの同期の状況アイコンをクリックします。