Zoho Webhookを使用してZohoフォームにZoho CRMからフィールド値を自動入力する

Zoho Webhookを使用してZohoフォームにZoho CRMからフィールド値を自動入力する

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

Requirement 詳細:

Zoho FormsはZoho CRMと連携することができ、必須項目を追加して顧客に送信し、データの収集を効率化します。Zoho CRMとZoho Formsの連携により、フォームの入力内容を直接Zoho CRMのタブにプッシュしたり、名前・メールアドレスなどのCRMデータをフォームに自動入力することが可能です。ただし、このカスタムソリューションでは、Dynamic Prefill - Webhook 手法を利用し、連携項目を使用せずにZoho CRMデータでフォーム項目を自動入力できます。

法人 使用する-Case:

たとえば、Zoho Formsを利用して顧客が購入希望する商品の情報を収集したい場合を考えます。顧客が商品を選択すると、Zoho CRM組織の商品タブデータから価格や在庫状況などの商品の詳細を動的に表示したい場合があります。このようなケースでは、CRM-Forms連携を使わずにZoho CRMの関数とREST APIを利用し、Zoho FormsのDynamic Prefill - Webhookで事前入力を実現できます。

Zoho Forms 設定: 

顧客情報(名前・メール・連絡先番号など)の必須項目を設定する必要があります。さらに、Zoho CRMの商品データで自動入力するためにフォームに表示する商品用の項目を追加してください。Zoho Formsのレイアウト内に商品用の主要項目を設けることで、クライアントが必須の商品を選択できるようにします。主要項目は、単一の折れ線グラフ項目またはドロップダウン項目として事前定義された商品選択肢を表示できます。主要項目を利用してZoho CRM内のデータを検索し、項目値を取得します。

主要項目でCRMからデータを検索するタスクが発生するため、Zoho Formで選択する主要項目の項目種類を把握しておく必要があります。また、自動入力が必要な項目については、Zoho CRMの検索データDelugeタスクから返される項目種類に基づいてのみマッピング可能です。

例えば、Zoho Formsで事前定義された商品を顧客が選択できるようドロップダウン項目を選び、自動入力される項目として商品単価・商品在庫ステータス・商品の種類を選択しています。



Zoho CRM 設定:

Zoho CRMでスタンドアロン関数を作成し、API通話として利用できるようにする必要があります。これらの方法を使わず、または外部から関数を実行したい場合にも、スタンドアロン関数を作成しAPI通話として利用可能にすることができます。REST APIを使って関数をトリガーすることで、Zoho CRM内や他のアプリケーションからも柔軟に実行できます。

  1. Zoho CRM > 設定 > Developer Hub > Functions に移動します。
  2. My Functions ページで、+ 新しく作成する Function をクリックします。
  3. Function のカテゴリーとして Standalone を選択します。
  4. 作成 をクリックします。

以下のスクリプトを使用してください:

  1. grec = Zoho.crm.searchRecords('商品','(Product_Name:equals:' + Product_Name + ')');
  2. if(ifnull(grec,List()).size() > 0)
  3. {
  4. rec = grec.取得する(0);
  5. Unitprice = rec.getJSON('Unit_Price');
  6. Producttype = rec.getJSON('Product_Type');
  7. Productstatus = rec.getJSON('Product_Status');
  8. }
  9. mp = Map();
  10. //Formsのプレフィルマッピングで同じ変数を使用します
  11. mp.put('Unitprice',Unitprice);
  12. mp.put('Producttype',Producttype);
  13. mp.put('Productstatus',Productstatus);
  14. response = Map();
  15. response.put('status_code',200);
  16. response.put('コンテンツの種類','application/json');
  17. response.put('本文',mp);
  18. 返品する {'crmAPIResponse':response};
  19. //関数の引数Product_Nameには文字列を指定してください。

引数マッピングでは、項目「Product_Name」を文字列としてデータ検索にマッピングする必要があります。


Zoho CRMでREST APIを使用したFunctionの呼び出し:

上記のスタンドアロンFunctionを保存した後、REST APIを作成する必要があります:
  1. 設定 > Developer Hub > Functions へ移動します。
  2. API化したい該当するFunctionの設定アイコンをクリックします。
  3. REST APIをクリックします。
  4. API名前項目には、そのFunctionを呼び出す際に使用するAPI名前が表示されます。このAPI名前はシステムによって作成され、変更できません。
  5. OAuth2.0およびAPIキーのスライダーを有効にします。
  6. 保存をクリックします。


REST APIキーを生成した後は、必ずFunctionを保存してください。

Dynamic Prefill - Zoho FormsでのWebhook設定s:

フォームの作成、Zoho CRMでのFunctionの設定、REST APIの作成が完了したら、Zoho Forms > 該当フォームのフォームビルダー > 設定タブ > Prefill > Dynamic Prefill - Webhook > 設定する をクリックします。

検索する設定:

検索する項目は、外部サービスから関連情報を取得するために使用するフォーム項目です。検索する項目としてドロップダウンからフォーム項目を選択してください。Webhookを用いてCRM内のデータを検索するため、「商品を選択する」項目を選びます。

Webhook詳細:
 

Webhook URLは、検索時にフォームから外部サービスへリクエストを送信するエンドポイントです。データ取得のため外部サービスの完全なURLを入力してください。前の手順で記載したZoho CRMのREST APIキーURLを渡す必要があります。

FunctionName : Zoho CRMでREST APIキーを作成したスタンドアロンFunctionの名前です。

Authorization 種類 : 一般

データ識別子キーは、検索する項目の値をZoho CRMに送信するためのクエリパラメーターとして使用されます。データ検索時、Webhookはデータ識別子キーをクエリパラメーターとして含めます。検索する項目の値がクエリパラメーターの値として送信されます。そのため、Zoho CRMのスタンドアロン関数で文字列として指定した検索する値をこちらで設定してください。Product_Nameは、上記のスタンドアロンスクリプトで使用している引数マッピングで利用可能な文字列です。

URL パラメーターは、Webhookリクエストで追加情報を送信するために、URLへクエリストリングとして追加されます。
下記の情報を渡す必要があります。
  1. auth_type : apikey
  2. zapikey : [Zoho CRM - Rest API で利用可能] 上記のスクリーンショットを参照してください。


テスト Webhook:

Webhookの設定が完了したら、この手順でWebhookをテストし、検索する項目に入力した値に基づいて正しいデータが取得できるか確認します。<検索する項目の値>の部分にサンプル値を入力し、テストを実行してZoho CRMにリクエストを送信してください。受信したレスポンスの形式が有効かどうか確認されます。有効なレスポンスが受信できた場合のみ、次の手順へ進むことができます。

Dynamic Webhookを利用して、Zoho Form内の項目値をZoho CRMから自動入力できます。


次の手順は、取得したデータからどのフォーム項目に情報を自動入力するかを決定することです。Zoho CRMから取得したデータで自動入力したいフォーム項目をマッピングします。
  1. フォーム項目を追加し、該当する項目をクリックします。
  2. JSONレスポンスが表示されたポップアップが開きます。必要なデータを含むJSONレスポンス内のキーを確認し、マッピングのために選択してください。
  3. 自動入力したいすべてのフォーム項目について、これを繰り返します。
  4. 保存をクリック


結果:





カスタム Solution 作成者 Raghu | Zoho パートナー サポート.

ご不明な点がございましたら、どうぞご遠慮なく パートナー-サポート@zohocorp.com までお問い合わせください。

Notesまた、『Europe および イギリス』のパートナーの方は パートナー-サポート@eu.zohocorp.com までご連絡いただきますようお願いいたします。

    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

                                • Zoho Analyticsにおける複数のZoho Books組織からの多通貨財務報告書

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Requirement 概要: ユーザーはZoho Booksの複数のインスタンス(組織)を、異なる基準通貨(EUR、GBP、INR、SEK)で運用しています。ユーザーは4つすべての組織のデータを統合したレポート(P&L、貸借対照表、キャッシュフロー)を作成し、統合されたZoho ...
                                • Zoho Delugeを使用したZoho CRMのメールテンプレート送信

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要: Zoho CRMでは、ユーザーが複数の受信者に標準化されたメッセージを送信するためのメールテンプレートを作成できます。場合によっては、ユーザーがDelugeを使用してカスタム関数経由でこれらのテンプレートを送信したいことがあります。本ガイドでは、Delugeを利用してZoho ...
                                • 📘 Zoho CRM – キオスクとクエリの実装によるZoho BooksおよびDeskの連絡先情報の表示

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 法人利用ケース: ある法人が、複数のZohoアプリケーション(Zoho BooksやZoho Deskなど)にまたがる連絡先の統合情報を、Zoho CRMの連絡先データから直接、素早く表示したいと考えています。 具体的には、以下の内容が含まれます: 連絡先がZoho ...
                                • ZohoパートナーのためのZoho CRMの遅延とパフォーマンス問題のトラブルシューティングガイド

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

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zohoのサービス群は2種類に分類できます。 組織単位アプリ(すべてのアプリアカウントサービスは1つの親組織にまとめられます)。 非組織単位アプリ(各サービスの組織は個別の子組織となります)。 次のZohoサービスは組織単位アプリに該当します。 Zoho One 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.