Custom Actions

Custom Actions

This guide will help you with the following:
  1. Create Custom Actions 
  2. Associate with Workflow Rules 
  3. 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.

  1. 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).
  2. Custom actions help you build customizations that include provisions for the end users to apply personalizations.
  3. 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:
  1. Log in to Zoho Developer Console and click Extensions for Zoho CRM.
  2. Select the extension to modify and click Edit.
  3. Click Automate in the left pane and select Custom Actions.
  4. In the Custom Actions page, click Create an Action.
    Create a Connected App  if it has not already been created.
  5. 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). 
  1. ZOHO.embeddedApp.init ( )
  2.           .then (function ( ) {
  3.                    ZOHO.CRM.ACTION.setConfig (
  4.                    {
  5.                               To : "${!Leads.Email}",
  6.                               Subject : document.getElementById("subject").value,
  7.                               Message : document.getElementById("msg").value
  8.                    })
  9.            });

      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:
  1. Access your CRM application.
  2. Go to Setup > Automation > Workflow Rules.
  3. 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
  1. You can create up to 5 custom actions per extension. 
  2. You can associate up to 3 custom actions per workflow rule. 

Manage Custom Actions

Edit Custom Actions

  1. Click Automate in the left pane and select Custom Actions.
  2. In the Custom Actions page, click the edit icon [] next to the name of the custom action.
  3. 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.
  1. Click Automate in the left pane and select Custom Actions
  2. In the Custom Actions page, click the delete icon [] next to the name of the custom action.
  3. Click OK to confirm deletion.

    Access your files securely from anywhere

      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 CRM Training
        Redefine the way you work
        with Zoho Workplace

          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 CRM Training

            Create, share, and deliver

            beautiful slides from anywhere.

            Get Started Now


              Zoho Sign now offers specialized one-on-one training for both administrators and developers.

              BOOK A SESSION









                                            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.




                                                Manage your brands on social media

                                                  Zoho Desk Resources

                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                    Zoho Marketing Automation

                                                      Zoho Sheet Resources

                                                       

                                                          Zoho Forms Resources


                                                            Secure your business
                                                            communication with Zoho Mail


                                                            Mail on the move with
                                                            Zoho Mail mobile application

                                                              Stay on top of your schedule
                                                              at all times


                                                              Carry your calendar with you
                                                              Anytime, anywhere




                                                                    Zoho Sign Resources

                                                                      Sign, Paperless!

                                                                      Sign and send business documents on the go!

                                                                      Get Started Now




                                                                              Zoho TeamInbox Resources



                                                                                      Zoho DataPrep Resources



                                                                                        Zoho DataPrep Demo

                                                                                        Get a personalized demo or POC

                                                                                        REGISTER NOW


                                                                                          Design. Discuss. Deliver.

                                                                                          Create visually engaging stories with Zoho Show.

                                                                                          Get Started Now









                                                                                                              • 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 ...
                                                                                                                Wherever you are is as good as
                                                                                                                your workplace

                                                                                                                  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.



                                                                                                                    Zoho Show Resources