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.

      Create. Review. Publish.

      Write, edit, collaborate on, and publish documents to different content management platforms.

      Get Started Now


        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







                              Quick LinksWorkflow AutomationData Collection
                              Web FormsRetailOnline Data Collection Tool
                              Embeddable FormsBankingBegin Data Collection
                              Interactive FormsWorkplaceData Collection App
                              CRM FormsCustomer ServiceForms for Solopreneurs
                              Digital FormsMarketingForms for Small Business
                              HTML FormsEducationForms for Enterprise
                              Contact FormsE-commerceForms for any business
                              Lead Generation FormsHealthcareForms for Startups
                              Wordpress FormsCustomer onboardingForms for Small Business
                              No Code FormsConstructionRSVP tool for holidays
                              Free FormsTravelFeatures for Order Forms
                              Prefill FormsNon-Profit
                              Forms for Government
                              Intake FormsLegal
                              Mobile App
                              Form DesignerHR
                              Mobile Forms
                              Card FormsFoodOffline Forms
                              Assign FormsPhotographyMobile Forms Features
                              Translate FormsReal EstateKiosk in Mobile Forms
                              Electronic FormsInsurance
                              Drag & drop form builder

                              Notification Emails for FormsAlternativesSecurity & Compliance
                              Holiday FormsGoogle Forms alternative GDPR
                              Form to PDFJotform alternativeHIPAA Forms
                              Email FormsWufoo alternativeEncrypted Forms
                              Accessible FormsTypeform alternativeSecure Forms

                              WCAG

                                          Create. Review. Publish.

                                          Write, edit, collaborate on, and publish documents to different content management platforms.

                                          Get Started Now






                                                            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

                                                                  Use cases

                                                                  Make the most of Zoho Desk with the use cases.

                                                                   
                                                                    

                                                                  eBooks

                                                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho Desk.

                                                                   
                                                                    

                                                                  Videos

                                                                  Watch comprehensive videos on features and other important topics that will help you master Zoho Desk.

                                                                   
                                                                    

                                                                  Webinar

                                                                  Sign up for our webinars and learn the Zoho Desk basics, from customization to automation and more

                                                                   
                                                                    
                                                                  • Desk Community Learning Series


                                                                  • Meetups


                                                                  • Ask the Experts


                                                                  • Kbase


                                                                  • Resources


                                                                  • Glossary


                                                                  • Desk Marketplace


                                                                  • MVP Corner



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