Webhookの設定

Webhookの設定

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

シンプル条件では、Webhookは、イベントが発生した際に、一方のシステムやアプリケーションからもう一方のシステムまたはアプリケーションへ即座にリアルタイムデータを送信する仕組みです。Webhookは基本的に、イベントが発生した際に指定した送信先(URL)へ通知を送る機能です。Zoho Formsを利用すると、フォームの送信内容が受領され次第、お好みのURLやサードパーティウェブアプリケーションに送信できます。

Zoho Formsで収集したデータをウェブアプリケーションで処理したり、法人ワークフローで利用したい場合は、Webhookを活用できます。APIを利用せず、収集されたフォーム送信内容を即座に受け取ることが可能です。
例えば、収集したデータを直接自社のデータベースに保存したり、ウェブサイト上に表示することもできます。他にもさまざまな用途があります。

Webhookを設定するには、
  1. Integrationsタブをフォームビルダーからクリックし、左側のメニューからWebhookを選択します。

  2. Webhook を設定する をクリックし、以下の詳細を入力します:

    Webhooks configuration

    • Webhook URL: フォーム送信内容を送信する先のURLです。

    • Content 種類: Webhook URL へ通知を HTTP POST リクエストで送信します。リクエスト本文(フォームデータを含む)は、以下のいずれかのコンテンツ形式で送信されます:
      コンテンツの種類
      データ送信内容
      application/json
      ファイル添付以外すべて
      application/x-www-form-urlencoded
      フォーム添付およびサブフォームデータ以外すべて
      multipart/form-data
      サブフォームデータ以外すべて

      各コンテンツタイプごとのレスポンス形式については、 こちらをご覧ください。

    • Authorization 種類希望するAuthorization種類を一般またはコントロールパネルで設定された連携から選択します。外部連携をAuthorization種類として選ぶ場合は、Connection 名前のリストから適切な連携を選択できます。
      新しい外部連携を追加した場合は、Connection 名前ドロップダウンリストの横にある更新アイコンをクリックし、追加された連携を選択してください。外部連携の作成方法について詳細はこちら
      Notes
      メモConnection 名前には、既存の有効な外部連携のみが表示されます。外部連携の詳細についてはこちらをご覧ください。

    • データの内容パラメーター:このセクションでは、Webhookを使ってデータを移動する項目を選択します。

      1. データの内容パラメーターで、パラメーター名を定義し、Parameter 値欄で該当するフォーム項目を選択してください。
      2. application/jsonのコンテンツ種類を使用する場合、Webhookを使ってサブフォームからのデータも転送できます。
      3. フォーム内で 支払い項目を利用する場合、Webhookで支払いの詳細を転送できます。対応している項目は、支払い額、支払いステータス、支払い通貨支払い取引IDです。Zoho Formsでは、取引ステータスおよびフォーム送信は非同期で処理されることが一般的で、フォーム送信と支払いステータスが同時に完了するとは限りません。

        非同期支払い取引はどのように機能しますか?
        フォーム送信後、回答者は支払いサイトにリダイレクトされます。最初は、Webhookを通じて支払い取引の保留中ステータスが数秒以内に送信されます。最終的なレスポンスは、購入者が取引を開始した時点でのみ確定します。
メモ:支払い項目の設定時には、ワークフローオプションの有効化を推奨します。これにより、Webhook経由でリアルタイムの支払いステータスと取引IDが送信され、保留中ステータスの送信が回避できます。
  1. URL パラメーター: 収集したデータと共に追加情報を送信したい場合は、このセクションで指定できます。例えば、リクエスト送信時にシークレットキーを含めることができ、認証済みリクエストの出力をフィルタリングするのに役立ちます。これらのパラメーターはURLのクエリストリングとして追加されます。パラメーターを追加する をクリックし、テキストボックスにパラメーター名と値を入力してください。

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


    Webhook URL に基本認証を設定している場合は、以下のようにカスタムヘッダーを設定することで、該当ヘッダーを受け取ることができます。

    Custom Headers


    カスタムヘッダー「Authorization」は以下のように表示されます:

    Authorization: 基本 dXNicm5hbWU6cGFzc3dvcmQ=

Notes

メモ: カスタムヘッダーを設定する際は、以下の点にご注意ください。

  1. スタンダード(システム)ヘッダーは再定義できません。
  2. カスタムヘッダー名は英数字のみ使用できます。使用可能な記号はアンダースコア(_)、ピリオド(.)、およびハイフン(-)のみです。
  3. 重複した名前は使用できません。
保存」をクリックして設定を保存すると、Webhook がこのフォームで有効になります。
InfoIP アドレスのホワイトリスト化について参照するには、こちらをクリック

統合失敗の原因を修正した後に統合サービスへ値を再送信する方法

  1. フォームのすべてEntriesセクションに移動します。
  2. 左上のすべてEntriesドロップダウンのフィルターをクリックします。
  3. リストから下にスクロールして、Webhook - 失敗Entriesオプションを選択します。

    Failed entries

  4. 失敗Entriesを選択し、Re-pushをクリックします。
Notes
メモ: 失敗Entriesの再送信は2回まで可能です。

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

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

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

    Zoho CRM Training



            Zoho Campaigns Resources

              Zoho WorkDrive Resources




                • Desk Community Learning Series


                • Digest


                • Functions


                • Meetups


                • Kbase


                • Resources


                • Glossary


                • Desk Marketplace


                • MVP Corner


                • Word of the Day


                • Ask the Experts









                                • Related Articles

                                • ペイスタック

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 前提条件: Paystack決済方法をフォームに設定するには、Zohoアカウントにメールを追加しておく必要があります。 Paystack決済方法は、US、IN、EU、AUのデータセンターでのみ利用可能です。 決済方法としてPaystack ...
                                • ミッドトランス

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 選択済み Midtrans を決済方法として利用する場合は、以下の手順に従い設定してください。 アカウント情報 アカウント情報 で、サーバーキーを入力します。Midtrans ダッシュボード > 設定 > Access Keys で確認できます。 IDR ...
                                • レイザーペイ

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

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 目次 外部連携とは Zoho Forms組織での外部連携の有効化 サービスの作成 外部連携の作成 カスタムサービスの編集 外部連携とは 外部連携は、外部サービスと認証および連携するための架け橋となります。外部連携は、Zoho ...

                                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.