Zoho Delugeを使用したZoho CRMのメールテンプレート送信

Zoho Delugeを使用したZoho CRMのメールテンプレート送信

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

概要:

Zoho CRMでは、ユーザーが複数の受信者に標準化されたメッセージを送信するためのメールテンプレートを作成できます。場合によっては、ユーザーがDelugeを使用してカスタム関数経由でこれらのテンプレートを送信したいことがあります。本ガイドでは、Delugeを利用してZoho CRMメールテンプレートを送信する手順を説明します。

シナリオ:

たとえば、Zoho CRMで新規リードが作成された際に、自動的にWelcomeメールテンプレートを送信したい場合があります。これは、メールテンプレートをトリガーするカスタム関数を含むワークフールールを作成することで実現可能です。

 

設定:

ワークフールール設定 :

  1. 設定 > 自動化 > ワークフールール > ルールの作成 に移動します。
  2. 見込み客タブを選択し、名前と説明を入力します。
    1. When: データ操作 >> 作成 を選択
    2. 条件: 全ての見込み客
    3. 即時処理: Function を選択 >> 独自関数の作成



Connectionの作成:

  1. 設定 >> Developer Hub >> 外部連携 >> My Connection >> Connectionの作成 に移動します。
  2. 'Zoho OAuth' をサービスとして選択し、'Connection' に名前を付けます。その後、下記の
    scope:ZohoCRM.テンプレート.メール.READ を選択します。

 

 

 

 

カスタム関数 Script: 

  1. 無効 自動化.Welcomeemail(int leadRecordId)
  2. {
  3. //API URL用のテンプレートIDを関連付ける
  4. templateurl = 'https://www.zohoapis.com/crm/v2.1/設定/email_templates/'+'6700402000001190011';
  5. templatedata = invokeUrl [
  6. url : templateurl
  7. 種類 : 取得する
  8. connection : 'emailtemplates'
  9. ];
  10. //info templatedata;
  11. //該当するテンプレートの内容を取得
  12. templatecontent = templatedata.取得する('email_templates').取得する('0').取得する('content');
  13. //info templatecontent;
  14. //テンプレートにはLead名・姓・Companyなどのマージタグがあるため、見込み客タブから該当情報を取得
  15. Leaddata = Zoho.crm.getRecordById('見込み客',leadRecordId);
  16. LeadName = ifNull(Leaddata.取得する('First_Name'),'') + ' ' + ifNull(Leaddata.取得する('Last_Name'),'');
  17. Company = ifNull(Leaddata.取得する('Company'),'');
  18. LeadEmail = ifNull(Leaddata.取得する('メール'),'');
  19. // メールテンプレート内のマージタグをそれぞれの情報で置き換えます
  20. revisedcontent = templatecontent.replaceAll('\$\{!見込み客.Full_Name\}',LeadName).replaceAll('\$\{!見込み客.Company\}',Company);
  21. //info revisedcontent;
  22. // メールテンプレートとともに、リードのメールアドレス宛にメールを送信します
  23. sendmail
  24. [
  25. from: Zoho.adminuserid
  26. to: LeadEmail
  27. 件名: 'Welcome メールテンプレート'
  28. メッセージ: revisedcontent
  29. ]
  30. }

 


Notesメモ: API URL内のドメインは、ご利用のデータセンターに合わせて変更してください。 

Deluge実行時エディターでの引数マッピング：

スクリーンキャスト動画：





最終結果：

 

 

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)

-> この自動化機能（例：ワークフロー ルール）が使用されているケースでは、意図した機能が動作しない場合、ユーザーは関連付け済みのfunction failure 理由を『設定 >> Developer Hub >> Functions >> 失敗』で確認できます。また、特定の作成関数のすべての関数実行の完了ログを確認し、実行状況を追跡できます（つまり、 My Functions >> 3点リーダー >> ログで確認可能）。この方法は、CRMデータ内のワークフールール経由で関数が実行されたものの、データ内で意図した処理や更新が行われなかった場合のシナリオにも役立ちます。このような場合、ユーザーはZoho CRM内の関数ログから出力（情報ログ）や実行時のエラーを確認できます。

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

  
Quote
カスタム Solution 作成者 Sakthi Priyadharshini | Zoho パートナーサポート.
ご不明な点がございましたら、どうぞご遠慮なくご連絡ください パートナー-サポート@zohocorp.comまでご連絡ください。
Notes
また、「Europe およびイギリスのパートナー」の方は、パートナー-サポート@eu.zohocorp.comまでご連絡いただきますようお願いいたします。