📘 Zoho CRM – キオスクとクエリの実装によるZoho BooksおよびDeskの連絡先情報の表示

📘 Zoho CRM – キオスクとクエリの実装によるZoho BooksおよびDeskの連絡先情報の表示

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

法人利用ケース:

ある法人が、複数のZohoアプリケーション(Zoho BooksやZoho Deskなど)にまたがる連絡先の統合情報を、Zoho CRMの連絡先データから直接、素早く表示したいと考えています。


具体的には、以下の内容が含まれます:
  1. 連絡先がZoho Booksのポータルユーザーであるかどうかの確認
  2. 連絡先がZoho Desk ヘルプセンターのエンドユーザーであるかの検証
  3. 連絡先がZoho Deskでスパムとしてマークされているかの識別

Solution 概要:

この要件は、Zoho CRM内のKioskおよびQuery設定を利用することで実現できます。本ソリューションでは、主要な連絡先識別子(メールアドレスや電話番号など)を用いてZoho BooksおよびZoho DeskへREST API通話を実行し、取得した詳細情報をCRM連絡先データ内で表形式などの構造化された形式で表示します。

上記ソリューションを実装する手順:

手順 1: 下記のように、Zoho Books用とZoho Desk用の2つのソースを作成します。

Zoho Books用およびZoho Desk用に、個別のデータソースを設定します。それぞれのアプリケーション用に専用のソースを2つ作成し、適切なデータ統合と管理を実現します。両方のソースの設定手順は下図の通りです:

Zoho Books:







Zoho Desk:





Zoho CRM 内での接続作成を通じて、両方のソースの認証が完了しました。

手順 2: 下記のように、Zoho Books 用と Zoho Desk 用の 2 つのクエリを作成します。


ソースを設定した後、それぞれに必要なデータを取得するためのクエリを作成します。正確なデータ抽出のため、Zoho Books 用と Zoho Desk 用の 2 つのクエリを個別に作成してください。クエリ作成の手順は以下の通りです。

     Zoho Books:

      

上記のように、「メール」項目をダイナミック変数として、REST API クエリのパラメーターに渡しています。

Serializer:


serializer の役割は、受注データを[パッケージ]データに変換し、クエリから返された生データレスポンスから必要なキーのみを抽出して、整形されたレスポンスにすることです。

  1. const data1 = result.連絡先;
  2. const contactsarr = Array.isArray(data1)
  3. ? data1
  4. : (data1 ? Object.values(data1) : []);
  5. const filteredResults = [];
  6. // フィルター処理を行い、`名前` と `メール` を手動で抽出します
  7. for (const 連絡先 of contactsarr) {
  8. if (連絡先.id =! null) {
  9. filteredResults.push({ 名前: 連絡先.contact_name
  10. , メール : 連絡先.メール , contact_type : 連絡先.contact_type , portal_status : 連絡先.portal_status, Contact_URL : 'https://Books.Zoho.com/app/777534184#/連絡先/'+連絡先.contact_id+'?filter_by=ステータス.すべて&per_page=200&sort_column=customer_name&sort_order=A'});
  11. }
  12. }
  13. filteredResults を返します;

シリアライザーを追加した後、Zoho Books から取得した 連絡先 詳細 を含む以下のようなレスポンスが得られます。



スキーマ:

上記のシリアライズされたレスポンス内の受領済みキーの名前を定義し、テーブルとして保存します。

 

Zoho Desk:

     

上記のように、「メール」項目を動的変数として、上記REST APIクエリのパラメーターに渡しています。

Serializer:

serializerの目的は、受注データを[パッケージ]データに変換することであり、クエリから取得した生データレスポンスから必要なキーのみを抽出し、フォーマット済みのレスポンスに変換します。

  1. const data1 = result.data;
  2. const contactsarr = Array.isArray(data1)
  3. ? data1
  4. : (data1 ? Object.values(data1) : []);
  5. const filteredResults = [];
  6. // フィルターし、「名前」と「メール」を手動で抽出
  7. for (const 連絡先 of contactsarr) {
  8. if (連絡先.id =! null) {
  9. filteredResults.push({ 名前: 連絡先.lastName , メール : 連絡先.メール , Spam_Contact : 連絡先.isSpam , help_center_user : 連絡先.isEndUser , リンク : 連絡先.webUrl });
  10. }
  11. }
  12. 返品する filteredResults;

serializerを追加した後、Zoho Booksから取得した連絡先の詳細を含む、下記のようなレスポンスが得られます。
      

スキーマ:

上記のシリアライズされたレスポンス内の受領済みキーに対して名前を定義し、それらをテーブルとして保存するには:


手順 3: Kioskでクエリを関連付け、以下の手順に従います:


1. 下図のようにKioskで連絡先タブ用の画面を作成し、「Queries経由でデータを取得する」を選択してください。

      

2) 次に、ここで手順2で作成したクエリを関連付けることができます。下図を参照してください。

      

上図のように、手順2でクエリを作成した際に宣言した動的変数「メール」には「#」を入力し、検索に使用する連絡先の項目を選択してください。

3) 同様に、Zoho Books用の他のクエリでもできることを使用し、Kiosk画面が上記のように表示されます。

      

4) 下記のように、連絡先の詳細表示ページにもKioskを実装できます。


      

5) これで使用するケースの実装が完了し、Zoho CRMの連絡先詳細表示ページから連絡先の詳細を確認できます。

      

      



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

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

また、'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 Delugeを使用したZoho CRMのメールテンプレート送信

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

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Requirement 詳細: Zoho FormsはZoho CRMと連携することができ、必須項目を追加して顧客に送信し、データの収集を効率化します。Zoho CRMとZoho Formsの連携により、フォームの入力内容を直接Zoho ...
                                • Zoho CRMでのレコード画像の一括インポート

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 概要 Zoho CRM ...
                                • Zoho Flowを使用して2つのZoho CRM組織間でデータを同期する方法を探る

                                  お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Requirement 概要 ユーザーは、2つのZoho CRM組織間でデータを同期し、Org Aで作成または更新されたデータが自動的にOrg Bにも反映されるようにしたいと考えています。つまり、Zoho CRM Org Aにデータが追加または更新されるたびに、同じ内容がOrg ...
                                • ZohoパートナーのためのZoho CRMの遅延とパフォーマンス問題のトラブルシューティングガイド

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