Email the contact roles of a deal using Functions

Happy New Year everyone! We hope you had a wonderful holiday season and are ready to tackle all of the challenges and opportunities that the new year brings.

In the previous post, we discussed the Contact Roles APIs in Zoho CRM. Today, we will show you how you can send emails to all the contact roles associated with a Deal, using a custom function.

Function to email all contact roles of a Deal

The Contact Roles related list allows you to link multiple contacts to a single deal and specify their role in the deal. Often you may want to send emails to all the contacts associated with a deal in certain situations. For example, you may want to update all the contacts on the status of the deal, invite all the contacts to a webinar or event related to the deal, or send an important update about the deal. By using a custom function, you can easily send emails to all the contact roles associated with a deal.

Create and execute the Function

Step 1: Go to Setup > Automation > Actions > Functions.

Step 2: Click Configure Function.

Step 3: Click Write your own.

Step 4: Enter the following details :

Function Name

Display Name

Description

Choose the function category as Leads.

Step 5: Copy and paste the following code in the editor :

relatedcontroles = zoho.crm.getRelatedRecords("Contact_Roles","Deals",input.dealId.toLong());

salutation = "Hello!! ";

signature = " Best Regards, Patricia Boyle";

sub = input.emailSubject.toString();

str = input.emailContent.toString();

str = concat(salutation,str);

str = concat(str,signature);

for each role in relatedcontroles

{

emailAddress = role.get("Email");

info emailAddress;

sendmail

[

from :zoho.adminuserid

to :emailAddress

subject :sub

message :str

]

}

Step 6: Click on Edit Arguments and add the following and then click Save.

Step 7: Click on Save and Execute.

Enter the deal ID, email subject, and content, and click Save to send emails to all the contact roles associated with the corresponding deal.

Function to Email specific contact roles of a Deal with email template

There may be times when you want to send emails to only selected contact roles of a deal. For example, when you want to discuss or update the financial aspects of the deal, or if you are discussing the budget for the deal and want to discuss cost-saving benefits, you might want to send emails only to the finance team of the prospective organization. Or, when you are reviewing legal or compliance considerations, or negotiating the terms of the deal, you might want to send an email only to the legal team to discuss these considerations. You can use an email template defined in your account to send the emails instead of drafting the entire content again in the functions.. You can achieve this by using a custom function as well.

Create and execute the Function

Create the connector

Step 1: Go to Setup > Developer Space > Connections.

Step 2: Click Create Connection.

Step 3: Pick the Zoho OAuth service.

Step 4: Specify the Connection details : Connection Name and Connection Link Name.

Step 5: Choose the following scopes :

ZohoCRM.templates.email.READ

ZohoCRM.modules.All

Step 6: Click Create and Connect and authenticate your connection.

After creating and authenticating your connection, complete the following steps:

Step 1: Go to Setup > Automation > Actions > Functions.

Step 2: Click Configure Function.

Step 3: Click Write your own.

Step 4: Enter the following details :

Function Name

Display Name

Description

Choose the function category as Leads.

Step 5: Copy and paste the following code in the editor :

relatedcontroles = zoho.crm.getRelatedRecords("Contact_Roles","Deals",dealId);

contactroles = invokeurl

[

url :"https://www.zohoapis.com/crm/v4/Contacts/roles"

type :GET

connection: "connection_name"

];

roles = contactroles.getJson("contact_roles");

roles_id = List();

for each name in roles

{

role_name = name.getJson("name");

role_id = name.getJson("id");

if(wanted_roles.contains(role_name)){

roles_id.add(role_id);

}

info roles_id;

emails = List();

for each roleid in roles_id

{

for each record in relatedcontroles

{

if ( record.get("Contact_Role") == roleid )

{

emails.add(record.get("Email"));

}

info emails;

p = contactroles.getJSON("body");

template = invokeurl

[

url :"https://www.zohoapis.com/crm/v4/settings/email_templates/" + email_template_id

type :GET

connection: "connection_name"

];

econt = template.getJson("email_templates").toMap().get("content");

sub = template.getJson("email_templates").toMap().get("subject");

u = template.getJSON("body");

for each email in emails

{

sendmail

[

from :zoho.adminuserid

to :email

subject :sub

message : econt

content type :HTML

]

}

Step 7: Replace the connection_name with the name of your connector.

Step 6: Click on Edit Arguments and add the following and then click Save.

Step 7: Click on Save and Execute

Enter the deal ID, the email template ID, and the contact roles you want to send the email to, and click Save to send emails.

We hope you found this post useful. We will be back next week with more interesting topics.

Write to us at support@zohocrm.com if you have any questions, or let us know in the comment section.

Previous Kaizen Post : Contact Roles APIs

Access your files securely from anywhere

Zoho Developer Community

New to Zoho LandingPage?

Access Zoho LandingPage

Zoho LandingPage Resources

New to Zoho Survey?

Access Zoho Survey

Latest Feature Updates

Explore our Pricing & Plans

Zoho Survey Resources

Android Mobile Surveys

Insurvey Blogs

Insight Blogs

Tips & Tricks

New to Zoho CRM Plus?

Deliver unforgettable customer experiences

ACCESS ZOHO CRM PLUS

New to Zoho CRM Plus?

Deliver unforgettable customer experiences

ACCESS ZOHO CRM PLUS

New to Zoho Marketing Plus?

Everything you need to run your marketing

ACCESS ZOHO MARKETING PLUS

New to Zoho Marketing Plus?

Everything you need to run your marketing

ACCESS ZOHO MARKETING PLUS

New to Bigin?

Signup Now

Access Bigin

Latest Feature Updates

Zoho Desk Resources

Desk Community Learning Series
Digest
Functions
Meetups
Kbase
Resources
Glossary
Desk Marketplace
MVP Corner
Word of the Day

Tout forum

France ZUGs

Zoho SalesIQ Resources

Sticky Posts
Kaizen#162 : Add Tags and Open Pre-filled Email Drafts via Client Scripts
Hello everyone! Welcome to another informative Kaizen post. In this post, let us see how to accomplish the following using Client Script. 1. How to auto-tag a record based on field update? 2. How to Open a pre-filled email draft This post will provide
Client Script | Update - Introducing Commands in Client Script!
Have you ever wished you could trigger Client Script from contexts other than just the supported pages and events? Have you ever wanted to leverage the advantage of Client Script at your finger tip? Discover the power of Client Script - Commands! Commands
Extension Pointers - JS SDK series #4: Managing data from a widget using ZOHO.CRM.HTTP
Handling and managing the data between two applications is a major factor for an efficient business. There are a variety of ways to handle data between Zoho CRM and other third-party applications. You can use deluge CRM tasks, create connectors, use API
Kaizen #152 - Client Script Support for the new Canvas Record Forms
Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achieved
Extension pointers for integrating Zoho CRM with Zoho products #8: Upload and manage Zoho Workdrive folders and files from within Zoho CRM
Keeping records on your customers and business prospects is essential for tracking data, conducting follow-ups, and running a business smoothly. When you use two separate applications, and store relevant data in each, checking and tracking data becomes