「Webhookの設定」

「Webhookの設定」

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

簡単に言うと、Webhookはイベントが発生したときに宛先(URL)に送信される通知のことです。Zoho Formsを使用すると、フォームエントリが受信されたときに、URLまたは選択したサードパーティーWebアプリケーションにフォーム送信をすぐに送信することができます。

Zoho Formsを介して収集したデータをWebアプリケーションで処理したり、ビジネスワークフローで使用したい場合、Webhooksを使用できます。APIを使用することなく、収集されたデータをすぐに受信できます。
例えば、収集したデータをデータベースに直接保存したり、ウェブサイトに表示したり、その他多くのことを行うことができます。

ウェブフックを設定するには、 
  1. フォームビルダーからインテグレーションタブをクリックし、左メニューからWebhooksを選択してください。

  2. クリックして Webhook の構成 を行い、以下の詳細を入力してください:

    Webhook Integration Setup

    • Webhook URL:フォーム送信先のURLです。

    • コンテンツタイプ:  Webhook URLへの通知は、HTTP POSTリクエストを介して送信します。フォームデータを含むリクエストボディは、次のいずれかのコンテンツ形式で送信されます:
      コンテンツタイプ
      データ転送
      application/json
      ファイル添付以外すべて
      application/x-www-form-urlencoded
      フォーム添付とサブフォームデータ以外すべて
      multipart/form-data
      サブフォームデータ以外すべて

      各コンテンツタイプのレスポンス形式をご覧ください こちら

    • ペイロードパラメータ: このセクションでは、Webhooksを使用してデータを転送するフィールドを選択します。

      1. 「ペイロードパラメータ」の下で、パラメータ名を定義し、「パラメータ値」の下で関連するフォームフィールドを選択します。
      2. application/jsonコンテンツタイプを使用する場合、Webhooksを使用してサブフォームからデータを転送することもできます。
      3. フォーム内に支払いフィールドを使用する場合、支払いの詳細をWebhooksを介して転送することができます。サポートされているフィールドは次のとおりです: 支払い金額、支払いステータス、支払い通貨 および 支払い取引ID。 Zoho Formsは、フォームの提出と支払いステータスが同時に行われないため、フォームの提出と支払いステータスを非同期で渡します。

        非同期支払い取引はどのように機能しますか? 
        フォームの提出後、回答者は支払いサイトにリダイレクトされます。最初に、数秒以内に支払い取引のための保留ステータスがWebhooksを介して送信されます。最終的な応答は、マーチャントが取引を開始したときにのみ判明します。
注意:Paymentフィールドの設定時にはワークフローオプションを有効にすることをお勧めします。これにより、ペンディングステータスではなく、リアルタイムのPayment StatusとTransaction IDがWebhooks経由で送信されるようになります。
  1. URLパラメータ: 収集されたデータと共に追加情報を送信したい場合は、このセクションで指定できます。 例えば、各リクエストに秘密鍵を含めることができます。これは認証リクエストをフィルタリングするのに役立ちます。これらのパラメータは、URLにクエリ文字列として追加されます。 パラメータを追加 をクリックして、テキストボックスにパラメータ名、値を入力します。 

  2. カスタムヘッダー: 収集されたデータと共に渡されるカスタムヘッダーの名前と値を設定できます。 


    Webhook URLに基本認証を設定した場合、次のようにカスタムヘッダーを設定することで、対応するヘッダーを受け取ることができます。

    カスタムヘッダー


    カスタムヘッダー「Authorization」は次のようになります:

    Authorization: Basic dXNicm5hbWU6cGFzc3dvcmQ= 

注意:設定カスタムヘッダーの際に以下をご留意ください:

  1. 標準(システム)ヘッダーは再定義できません。 
  2. カスタムヘッダー名にはアルファベットと数字のみを含めることができます。許可される特殊文字はアンダースコア(_)、ピリオド(.)、ハイフン(-)のみです。
  3. 重複する名前は許可されません。
クリックして 保存 を押して設定を保存します。そうすると、このフォームに対してWebhooksが有効になります。​​

    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho Desk Resources

              • Desk Community Learning Series


              • Digest


              • Functions


              • Meetups


              • Kbase


              • Resources


              • Glossary


              • Desk Marketplace


              • MVP Corner


              • Word of the Day









                                • Related Articles

                                • 「Razorpay」で支払いを安全に行う方法

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 もしRazorpayをマーチャントとして選択した場合、Zoho FormsアカウントをOAuth認証を使用してRazorpayリソースへのアクセスを認可する必要があります。 OAuth認証を使用すると、Key IDおよびKey ...

                                Resources

                                Videos

                                Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                eBooks

                                Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                Webinars

                                Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                CRM Tips

                                Make the most of Zoho CRM with these useful tips.