Custom Actions
This guide will help you with the following:
- Create Custom Actions
- Associate with Workflow Rules
- Manage Custom Actions
Zoho Developer provides various options to automate repetitive tasks and implement customizations that meet your business needs. These automations and customizations, however, have some constraints in their ability to personalize results for the end user. Consider the example of a CRM for a garage where SMS notifications need to be sent to the customers on three different occasions: the first one welcoming them, the second one to inform them about the estimated cost of service after their vehicle has been inspected, and the final one informing them of their vehicle's service completion date. If a
Custom Function is used in this scenario, then three different custom functions need to be written and associated with three different workflows. But if Custom Actions are used, then the same custom function can be used to trigger the SMS messages for all three cases, with the content of the messages decided by the CRM's end user.
- Custom Actions are a combination of custom pages and custom scripts that are used to include tailored actions in workflow rules. Custom actions let you add workflow actions to your application in addition to those available by default (alerts, tasks, field updates, webhooks, and custom functions).
- Custom actions help you build customizations that include provisions for the end users to apply personalizations.
- When the same functionality is to be implemented using workflow rules but with different personalised end results, custom actions are required.
Create Custom Actions
We will use the following example to illustrate the use of custom actions: Enable the app user to send emails to leads with personalized messages.
To create a custom action:
- Log in to Zoho Developer Console and click Extensions for Zoho CRM.
- Select the extension to modify and click Edit.
- Click Automate in the left pane and select Custom Actions.
- In the Custom Actions page, click Create an Action.
Create a Connected App if it has not already been created. - Provide a name for the custom action in the Custom Action Name field, a Description, and click Next.
6. Provide the resource path for the Custom Page (Main.html) in the SandBox URL field. This is the relative path to the Custom Page.
7. Click
Next.
8. Click
Create Function.
9. The Deluge Script Editor will be displayed. Write a custom function (See also
Deluge Script - Reference Guide ) to send an email. This custom function will be executed when associated with a workflow rule. The values from the custom page (Main.html) will be passed as a JSON object to this custom function.
10. Click
Save & Close.
The values 'To', 'Subject', and 'Message' are set in the config map in the custom page (Main.html).
- ZOHO.embeddedApp.init ( )
- .then (function ( ) {
- ZOHO.CRM.ACTION.setConfig (
- {
- To : "${!Leads.Email}",
- Subject : document.getElementById("subject").value,
- Message : document.getElementById("msg").value
- })
- });
11. Click
Save.
Associate with Workflow Rules
To use the custom action in your application, publish the extension and install it in your CRM application. Create a workflow rule to send email to leads from the 'State' Texas and invoke the script created through custom action.
To associate a custom action to a workflow rule:
- Access your CRM application.
- Go to Setup > Automation > Workflow Rules.
- In the Workflow Rules page, click Create Rule.
The custom action you created will be listed along with the list of default actions.
4. When you select the custom action, the created custom page will be displayed to the users so they can input and submit the values required to execute the action.
5. Provide a name for this instance of the custom action 'Email Template' and click
Save and Associate.
6. Click Save in the New Rule page.
Similarly, you can create a different workflow rule and use the same custom action (Email Template) to email a different personalised message to leads.
Note
- You can create up to 5 custom actions per extension.
- You can associate up to 3 custom actions per workflow rule.
Manage Custom Actions
Edit Custom Actions
- Click Automate in the left pane and select Custom Actions.
- In the Custom Actions page, click the edit icon [
] next to the name of the custom action. - Make the necessary changes and click Save. You can also modify the custom function.
Delete Custom Actions
Until the extension is published, you can delete the custom actions that you have created.
- Click Automate in the left pane and select Custom Actions
- In the Custom Actions page, click the delete icon [
] next to the name of the custom action. - Click OK to confirm deletion.
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Custom Buttons and Links
The guide will help you with the following: Create a custom button Define button action Invoke a URL Writing a custom function Edit a custom button Delete a custom button Add a link Delete a link Based on the specifics of your industry and ...Install Actions
This guide helps you with the following: Create a post install script InstallParamMap variable Example Create a post uninstall script Create an on authorization script for connectors Example Create an on revoke script for connectors Example ...Custom Functions
The guide will help you with the following: Create Custom Functions Program Custom Functions Test Custom Functions Associate with Workflow Rules Manage Custom Functions Custom functions help in automation where procedural logic is required, which ...Custom Schedules
This guide will help you with the following: Create Schedules Write Custom Function Edit Schedules Delete schedules Schedules are automated user-defined actions, which can be performed through custom functions either at a particular time or on a ...Custom SalesSignal
The SalesSignals feature in Zoho CRM provides real-time notifications of all touch points from your leads, contacts, or potential customers. You can keep track of all the customer interactions across various channels and follow-up with them from one ...
New to Zoho LandingPage?
Zoho LandingPage Resources