Zoho CRMでの取引のためのドキュメント共有をカスタム関数で効率化する

Zoho CRMでの取引のためのドキュメント共有をカスタム関数で効率化する

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

Requirement 概要

Zoho CRM ユーザーが、各添付ファイルを手動で選択して送信するのではなく、カスタム関数を利用して商談関連のドキュメント(提案書、請求書、契約書など)を顧客へ自動的かつ簡単に共有したいと考えています。

使用する Case

Zoho CRM を利用して電子商品を顧客に販売している企業では、営業プロセスの中で営業チームが複数のドキュメントを商談データにアップロードします:

  1. 提案書
  2. 価格資料
  3. ケーススタディ
  4. 発注書
  5. 契約書

これらのドキュメントは、Zoho CRM の添付ファイルセクションに、商談ごとに保存されています。

商談が「完了済み Won」とマークされた際、企業はすべての商談関連ドキュメントを関連付けられた連絡先に送信する必要があります。


ドキュメントを手動で送信する際の課題:営業担当者は、商談が「完了済み Won」とマークされるたびに「メールを送信する」ボタンをクリックし、関連ドキュメントを一つずつ添付してメールを作成する必要があり、これにより多くの時間がかかってしまいます。


なぜ重要なのか:

  1. 時間の節約
  2. エラーゼロ
  3. 拡張性
  4. リスクの軽減
  5. ファイルを即時共有することで顧客体験が向上

Info

権限と利用可能範囲

Info
-> 管理 Extensibility権限を持つユーザーは、外部連携の作成やカスタム関数の作成が可能です。
-> 管理 自動化権限を持つユーザーは、ワークフローのルール設定が可能です。
-> 管理 テスト環境権限を持つユーザーは、テスト環境の管理およびこの利用ケースのテストが可能です。

設定

営業担当者がすべてのドキュメントを商談が「完了済み Won」とマークされた際に送信済みにしたい場合、ワークフロールール自動化機能を利用して、商談ステージが「完了済み Won」に更新されるたびにトリガーし、カスタム関数を実行して商談のすべての添付ファイルを取得し、関連付けられた連絡先へメール送信することができます。
  1. ワークフロールール設定:

ナビゲート:Zoho CRM の 設定 (⚙️) >> 自動化 >> ワークフロー ルール >> ルールの作成

商談」タブを選択し、ルールに名前説明を入力します。

-> 実行タイミング: データ操作 >> 編集 >> 特定のステージ項目が「完了済み Won」に更新されたとき >> 「繰り返し」有効
-> 条件: すべての商談
-> 即時処理: 関数を選択 >> 独自の関数を作成


  1. 接続の作成:

ナビゲート:Zoho CRM の 設定 (⚙️) >> Developer Hub >> 外部連携 >> My Connection >> 接続の作成

「Zoho OAuth」をサービスとして選択し、「Connection」に名前を入力します。その後、下記のスコープを選択してください。
  1. ZohoCRM.タブ.すべて
  2. ZohoCRM.設定.すべて
  3. ZohoCRM.タブ.添付ファイル.すべて

The コード

  1. 無効 自動化.toSendDealDocuments(Int dealRecordID,String associatedContactEmail)
  2. {
  3. //商談に関連付けられた連絡先名を取得し、メールメッセージで使用します
  4. dealData = Zoho.crm.getRecordById('商談',dealRecordID);
  5. // info dealData;
  6. dealContact = ifNull(dealData.取得する('Contact_Name'),'');
  7. dealContactName = ifNull(dealContact.取得する('名前'),'');
  8. //引数で直接名前を取得することも可能です(連絡先メールと同様)
  9. // info dealContactName;
  10. // info associatedContactEmail;
  11. //商談からすべての添付ファイルを取得
  12. relatedrcords = Zoho.crm.getRelatedRecords('添付ファイル','商談',dealRecordID);
  13. info relatedrcords;
  14. if(relatedrcords.size() > 0)
  15. {
  16. attachementIdList = List();
  17. for each ele in relatedrcords
  18. {
  19. attachementId = ele.取得する('id');
  20. //すべての添付ファイルIDを取得
  21. attachementIdList.追加する(attachementId);
  22. }
  23. info 添付ファイルIDリスト.size();
  24. fileList = List();
  25. //添付ファイルIDを使って商談から各添付ファイルを取得し、リストに追加する
  26. for each index i in 添付ファイルIDリスト
  27. {
  28. downloadFile = invokeurl
  29. [
  30. url :'https://www.zohoapis.com/crm/v2/商談/'+ dealRecordID + '/添付ファイル/' + 添付ファイルIDリスト.取得する(i)
  31. 種類 :取得する
  32. connection:'send_email_with_attachment'
  33. ];
  34. // info downloadFile;
  35. fileList.追加する(downloadFile);
  36. }
  37. //すべての商談関連ドキュメントをメールの宛先連絡先に送信する
  38. toAddress = 関連連絡先メールアドレス;
  39. sendmail
  40. [
  41. 開始:Zoho.adminuserid
  42. to :toAddress
  43. 件名 :'商談 ドキュメント'
  44. メッセージ :'Hi ' + dealContactName + '、商談に関連するすべての添付ファイルをお送りいたします。'
  45. 添付ファイル :file:fileList
  46. ]
  47. }
  48. else
  49. {
  50. info 'この商談には添付ファイルがありません。';
  51. }
  52. }
  1. 項目 Argument Mapping in Deluge 設定


  1. コード 説明

-> スクリプトは、渡された引数(dealRecordID)を利用して、現在実行中のデータを取得します。
-> 取得したデータから、項目(Contact_Name)の値を取得し、その名前を変数に保存します。
-> 次に、該当する商談データからアップロードされたすべての添付ファイルを取得し、変数に保存します。後で、添付ファイルが存在するかどうかを確認します。存在する場合はリスト(attachementIdList)を作成し、ループを使って添付ファイルのIDを取得し、そのリストに保存します。
-> さらにループを利用して、添付されたIDをもとにすべての添付ファイルを取得し、ファイルとして保存します。これを後でメール送信タスクに渡します。 

Working デモ - スクリーンキャスト


  1. 最終結果 - Zoho CRMから受信したメール:


Alertスムーズな導入を実現するため、設定はテスト環境で事前に構成・検証を行ってから、本番環境へ移行することを推奨します。

TIPS: よくあるエラーを回避するコツ

-> スクリプト内では、正しい API Namesをタブおよび項目に対して必ず使用してください。


-> 意図した出力を取得するために、Zoho CRM Function IDEのコンソールセクションで各変数の出力を確認できるよう、info() ログの利用を推奨します。これにより、機能がスムーズに動作しているか確認できます。


-> 関数スクリプト内で外部連携を使用している場合は、目的のAPI操作を実行するために必須スコープを接続に追加してください。また、Deluge Invoke URLまたはIntegrationタスクに渡す際は、外部連携のリンク名(例:crm_connection)を使用することを確認してください。

-> 一般的な運用として、US DCのAPIエンドポイントを使用しています。別のDC(例:IN、EU、CA、AU等)のCRMアカウントをご利用の場合は、ご利用のDCに対応したAPIエンドポイントURLを使用することを推奨します。

例:
US DC - 'https://www.zohoapis.com/crm/v2/商談/'+ dealRecordID + '/添付ファイル/' + attachementIdList.取得する(i)
IN DC - 'https://www.zohoapis.in/crm/v2/商談/'+ dealRecordID + '/添付ファイル/' + attachementIdList.取得する(i)
EU DC - 'https://www.zohoapis.eu/crm/v2/商談/'+ dealRecordID + '/添付ファイル/' + attachementIdList.取得する(i)

-> 自動化機能(例:ワークフールール)が関係する使用ケースで、意図した機能が動作しない場合は、ユーザーは関連付け済みの関数失敗理由を「設定 >> Developer Hub >> Functions >> 失敗」で確認できます。さらに、ユーザーは特定の作成関数の全実行の完了ログも確認でき、実行履歴を追跡できます( My Functions >> 3点リーダー >> ログ内)。この方法は、ワークフールール経由でCRMデータ内の関数が実行された(タイムラインに表示される)が、データに意図した処理・更新が行われなかった場合にも役立ちます。こうした場合は、Zoho CRM内の関数ログから出力(infoログ)や実行時のエラーを確認してください。

Notesメモ: 次のガイド - 記事を参照し、コード最適化のベストプラクティスおよびZoho CRM全体でカスタム関数を展開するさまざまな方法をご覧ください。



ご不明な点がございましたら、どうぞご遠慮なく パートナー-サポート@zohocorp.com までご連絡ください。
また、ヨーロッパおよびイギリスのパートナーは、パートナー-サポート@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 Webhookを使用してZohoフォームにZoho CRMからフィールド値を自動入力する

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

                                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.