Function-8: Assign leads based on users' shift timing.

Function-8: Assign leads based on users' shift timing.

Welcome back everyone!

Last week, we learnt how to add country codes to phone numbers. This week, let's look at a custom function that allows you to assign leads by matching the lead acquisition time and your sales reps' shift timing.

Did you know?

Research shows that

  • Vendors who respond first to a prospect win 35-50% of the deals.
  • The chances of converting is 9x more if you reach a prospect within the first 5 minutes.

Business scenario:

The stats above prove an important point - the quicker your lead assignment, the better the chances of winning the deal. While auto-assigning on round-robin basis helps balance the load, it does not help meet the need of having to quickly reach out to your prospects operating across geographies. Assigning leads based on the time at which they are created, solves this problem. This is done by matching the lead acquisition time with sales reps' shift timing. This week's custom function helps do just that.

Getting started with the custom function:

  • Go to Setup > Automations > Actions > Custom Functions > Configure Custom Function > Write your own.
  • Provide a name for the custom function. For example: “Add Country code-1”. Add a description(optional).
  • Select the module as Leads. Add a description(optional).
  • Click “Free flow scripting”.
  • Copy the code given below.
  • Click “Edit arguments”.
  • Enter the name as “leadId” and select the value as “Lead Id”.
  • Save the changes.

The script:

Code for Version 2.0 API:
 
leadDetails = zoho.crm.getRecordById("Leads", input.leadId.toLong());
//info leadDetails;
createdhour = ifnull(leadDetails.get("Created_Time"),"").toTime("yyyy-MM-dd'T'HH:mm:ss").getHour();
info createdhour;
if ((createdhour >= yy ) && (createdhour < zz ))
{
mp=map();
mp.put("Owner",xxxxxxxxxx);
update=zoho.crm.update("Leads", leadId.toLong(), mp);
info mp;
info update;
}

Code for Version 1.0 API:

leadIdStr = input.leadId.toString();
leadDetails = zoho.crm.getRecordById("Leads", input.leadId);
info leadDetails;
createdtime = ifnull(leadDetails.get("Created Time"),"");
createdhour=createdtime.toString("dd-MM-yyyy HH:mm:ss").toTime().getHour();
info createdhour;
if ((createdhour >= yy ) && (createdhour < zz ))
{
mp=map();
mp.put("SMOWNERID","xxxxxxxxxxxxxx");
update=zoho.crm.updateRecord("Leads", leadIdStr, mp);
info mp;
info update;
}

Note:
  • Change the 'xxxxxxxxxxxxxx', to the User ID of the specific user.
  • The 'yy' and 'zz' refer to the time at which a lead is created. Use 24 hour time to set up a custom time window..
  • Assigning to a user requires the User ID and not the user name. The user ID is found in the Setup page of your CRM. Take a look at the screenshot below for more details.


Found this useful? Try it out and let me know how it works! If you have questions, do not hesitate to ask! Share this with your team if you find it useful. Do check out other custom functions shared in this series here.

See you all next week with another interesting custom function. Ciao!

Update: As you must be aware, API V1.0 will be deprecated and support for version 1.0 API will be available only till Dec 31, 2018. Version 1.0 compatible Functions will continue to work until Dec 31, 2019. You're advised to migrated to API Version 2.0 at the earliest. Check this announcement for more. We've updated the post to include the Version 2.0 compatible Function.

    Access your files securely from anywhere

        All-in-one knowledge management and training platform for your employees and customers.






                              Zoho Developer Community




                                                    • Desk Community Learning Series


                                                    • Digest


                                                    • Functions


                                                    • Meetups


                                                    • Kbase


                                                    • Resources


                                                    • Glossary


                                                    • Desk Marketplace


                                                    • MVP Corner


                                                    • Word of the Day


                                                    • Ask the Experts



                                                              • Sticky Posts

                                                              • Function #46: Auto-Calculate Sales Margin on a Quote

                                                                Welcome back everyone! Last week's function was about displaying the discount amount in words. This week, it's going to be about automatically calculating the sales margin for a particular quote, sales order or an invoice. Business scenario Where there is sales, there's also evaluation and competition between sales reps. A healthy rivalry helps to better motivate your employees to do smart work and close deals faster and more efficiently. But how does a sales rep get evaluated? 90% of the time, it's
                                                              • Zoho CRM Functions 53: Automatically name your Deals during lead conversion.

                                                                Welcome back everyone! Last week's function was about automatically updating the recent Event date in the Accounts module. This week, it's going to be about automatically giving a custom Deal name whenever a lead is converted. Business scenario Deals are the most important records in CRM. After successful prospecting, the sales cycle is followed by deal creation, follow-up, and its subsequent closure. Being a critical function of your sales cycle, it's good to follow certain best practices. One such
                                                              • User Tips: Auto-Create Opportunity/Deal upon Quote Save (PART 1)

                                                                Problem: We use quotes which convert to sales orders but Users / Sales Reps do not create opportunities / deals and go straight to creating a quote. This leads to poor reporting. Implementing this solution improves reporting and makes it easier for users.
                                                              • Custom Function : Automatically send the Quote to the related contact

                                                                Scenario: Automatically send the Quote to the related contact.  We create Quotes for customers regularly and when we want to send the quote to the customer, we have to send it manually. We can automate this, using Custom Functions. Based on a criteria, you can trigger a workflow rule and the custom function associated to the rule and automatically send the quote to customer through an email. Please note that the quote will be sent as an inline email content and not as a PDF attachment. Please follow
                                                              • Function #50: Schedule Calls to records

                                                                Welcome back everyone! Last week's function was about changing ownership of multiple records concurrently. This week, it's going to be about scheduling calls for records in various modules. Business scenario Calls are an integral part of most sales routines.. Sales, Management, Support, all the branches of the business structure would work in cohesion only through calls. You could say they are akin to engine oil, which is required by the engine to make all of it's components function perfectly. CRM


                                                              Manage your brands on social media



                                                                    Zoho TeamInbox Resources



                                                                        Zoho CRM Plus Resources

                                                                          Zoho Books Resources


                                                                            Zoho Subscriptions Resources

                                                                              Zoho Projects Resources


                                                                                Zoho Sprints Resources


                                                                                  Qntrl Resources


                                                                                    Zoho Creator Resources



                                                                                        Zoho CRM Resources

                                                                                        • CRM Community Learning Series

                                                                                          CRM Community Learning Series


                                                                                        • Kaizen

                                                                                          Kaizen

                                                                                        • Functions

                                                                                          Functions

                                                                                        • Meetups

                                                                                          Meetups

                                                                                        • Kbase

                                                                                          Kbase

                                                                                        • Resources

                                                                                          Resources

                                                                                        • Digest

                                                                                          Digest

                                                                                        • CRM Marketplace

                                                                                          CRM Marketplace

                                                                                        • MVP Corner

                                                                                          MVP Corner







                                                                                            Design. Discuss. Deliver.

                                                                                            Create visually engaging stories with Zoho Show.

                                                                                            Get Started Now


                                                                                              Zoho Show Resources

                                                                                                Zoho Writer

                                                                                                Get Started. Write Away!

                                                                                                Writer is a powerful online word processor, designed for collaborative work.

                                                                                                  Zoho CRM コンテンツ




                                                                                                    Nederlandse Hulpbronnen


                                                                                                        ご検討中の方




                                                                                                                • Recent Topics

                                                                                                                • Automatically include all ticket attachments in the ticket resolution email

                                                                                                                  Hello Zoho Community, We are implementing Zoho Desk in a real customer-facing production environment and have run into a limitation that is becoming a blocking requirement for our clients. The problem When a ticket is closed or resolved, Zoho Desk sends
                                                                                                                • Keep Zoho People Feature Requests in the Zoho People Forum

                                                                                                                  Hello Zoho People Product Team, Greetings. We would like to submit a feature request regarding the handling of feature requests themselves, specifically for Zoho People. Issue: Feature Requests Being Moved to Zoho One Zoho People feature requests are
                                                                                                                • Finding text within a ticket: Expand All or Search this Ticket

                                                                                                                  The auto-collapse feature within a ticket is nice for screen scrolling, however it makes it difficult to find text within the ticket if the email is collapsed. In fact you cannot find text if it is collapsed. I would like to propose a feature that allows
                                                                                                                • Books & Desk. Client mapping

                                                                                                                  Hi, I’ve been using Zoho Books for several years and am now looking to improve my customer service. I'm experimenting with Zoho Desk and want to sync and map my client data from Zoho Books. However, it seems that mapping requires both contacts to have
                                                                                                                • String handling

                                                                                                                  If I cut a currency string from a quote and try and paste it into the Deal "Amount", it will fail unless I manually delete any commas. Dollar signs are no problem, but comma's seem to fail. Please correct this Input Validation error.
                                                                                                                • Allow Stripe Credit Card and Stripe ACH payment methods to be enabled separately on an invoice.

                                                                                                                  I need to be able to pick at the invoice level whether Stripe Credit Card and/or Stripe ACH payment methods are available. Currently, I'm not able to select from the two Stripe payment methods individually on an invoice. However, there are some larger
                                                                                                                • YouTube Live streaming? how to? Zoom has this feature, built-in. Can't find it on zoho meetings.

                                                                                                                  YouTube Live streaming? how to? Zoom has this feature, built-in. Can't find it on zoho meetings.
                                                                                                                • Feature Request - A Way To Search Item Groups

                                                                                                                  Hi Inventory Team, I can't find any way to filter or search by fields of Item Groups. It would be great to see that functionality added. I have a use case where a single product might come from 5 or more suppliers and each supplier's item is an Item in
                                                                                                                • Campaigns does not work!

                                                                                                                  I am running into so many problems trying to use Zoho Campaigns, that I am seriously considering dropping the app from my (shrinking) list of Zoho applications I actually use. Apart from having to fight the software trying to create a design and email,
                                                                                                                • How to filter Packages in zoho inventory api

                                                                                                                  Hi Team, I want to perform some tasks in a schedular on the packages which are in "Shipped" state. I tried to use filter_by in my api call but in return I get response as {"code":-1,"message":"Given filter is not configured"} My Api request is as follows
                                                                                                                • Syncing with Google calendar, Tasks and Events

                                                                                                                  Is it possible to sync Zoho CRM calendar, task and events with Google Calendar's tasks and events. With the increasing adoption by many major tool suppliers to sync seamlessly with Google's offerings (for instance I use the excellent Any.do task planning
                                                                                                                • How can i view "Child" Accounts?

                                                                                                                  It can be very useful in our field of business to know the parent-child account relationship. However, there seems to be a shortcoming in the parent account view: no child account list. How can we view the child accounts per each account?
                                                                                                                • Easily perform calculations using dates with the new DATEDIF function

                                                                                                                  Hey Zoho Writer users! We've enhanced Zoho Writer's formula capabilities with the new DATEDIF function. This allows you to calculate the difference between dates in days, months, and years. Function syntax: =DATEDIF(start_date, end_date, unit) Inputs:
                                                                                                                • Adding Comments Using Workflows - How to Change User Attributed

                                                                                                                  We have worklflows in Desk where a comment is added to a ticket based on certain criteria. It seems that the comment added is always attributed to the user who last edited the workflow. This does not make sense for us because: - It's misleading to other
                                                                                                                • Add Attachment Support to Zoho Flow Mailhook / Email Trigger Module

                                                                                                                  Dear Zoho Support Team, We hope you are well. We would like to kindly request a feature enhancement for the Mailhook module in Zoho Flow. Currently, the email trigger in Zoho Flow provides access to the message body, subject, from address, and to address,
                                                                                                                • Les dernières avancées en saisie de données et collaboration

                                                                                                                  Après une année dédiée à la recherche et au développement, notre équipe est prête à dévoiler des améliorations majeures pour Zoho Sheet. Ces nouveautés seront lancées par étapes afin d’en assurer une prise en main optimale. Nous commençons avec des fonctionnalités
                                                                                                                • Rich Text For Notes in Zoho CRM

                                                                                                                  Hello everyone, As you know, notes are essential for recording information and ensuring smooth communication across your records. With our latest update, you can now use Rich Text formatting to organize and structure your notes more efficiently. By using
                                                                                                                • Implement Meeting Polls in Zoho Bookings

                                                                                                                  Dear Zoho Bookings Support Team, We'd like to propose a feature enhancement related to appointment scheduling within Zoho Bookings. Current Functionality: Zoho Bookings excels at streamlining individual appointment scheduling. Users can set availability
                                                                                                                • Service Account Admin for API Calls and System Actions

                                                                                                                  Hello, I would like to request the addition of a Service Account Admin option in Zoho product. This feature would allow API calls and system actions to be performed on behalf of the system, rather than an active user. Current Issue: At present, API calls
                                                                                                                • How to Customize Task Creation to Send a Custom Alert Using JavaScript in Zoho CRM?

                                                                                                                  Hello Zoho CRM Community, I’m looking to customize Zoho CRM to send a custom alert whenever a task is created. I understand that Zoho CRM supports client scripts using JavaScript, and I would like to leverage this feature to implement the alert functionality.
                                                                                                                • Send Whatsapp with API including custom placeholders

                                                                                                                  Is is possible to initiate a session on whatsapp IM channel with a template that includes params (placeholders) that are passed on the API call? This is very usefull to send a Utility message for a transactional notification including an order number
                                                                                                                • ZO25: The refreshed, more unified, and intelligent OS for business

                                                                                                                  Hello all, Greetings from Zoho One! 2025 has been a remarkable year, packed with new features that will take your Zoho One experience to the next level! From sleek, customizable dashboards to an all-new action panel for instant task management, we’ve
                                                                                                                • Introducing Multi-Asset Support in Work Orders, Estimates, and Service Appointments

                                                                                                                  We’re excited to announce a highly requested enhancement in Zoho FSM — you can now associate multiple assets with Work Orders, Estimates, and Service Appointments. This update brings more clarity, flexibility, and control to your field service operations,
                                                                                                                • [Product Update] Locations module migration in Zoho Books integration with Zoho Analytics

                                                                                                                  Dear Customers, As Zoho Books are starting to support an advance version of the Branches/Warehouses module called the Locations module, users who choose to migrate to the Locations module in Zoho Books will also be migrated in Zoho Analytics-Zoho Books
                                                                                                                • Introducing Schedules for smarter availability management

                                                                                                                  Greetings from the Zoho Bookings team! We’re excited to introduce Schedules, a powerful enhancement to manage availability across your workspace. Schedules are reusable working-hour templates that help you define and maintain consistent availability across
                                                                                                                • Why Zoho Contracts Prefers Structured Approvals Over Ad-hoc Approvals

                                                                                                                  Approvals are one of the most important stages in a contract’s lifecycle. They determine whether a contract moves forward, gets revised, or needs further discussion. The approval process also defines accountability within the organization. Zoho Contracts
                                                                                                                • Whatsapp Connection Status still "Pending" after migration

                                                                                                                  Hello, I migrated my WhatsApp API to Zoho from another provider a day ago. So far the connection status is still “Pending”. There is a problem? How long does it usually take?
                                                                                                                • Kaizen #226: Using ZRC in Client Script

                                                                                                                  Hello everyone! Welcome to another week of Kaizen. In today's post, lets see what is ZRC (Zoho Request Client) and how we can use ZRC methods in Client Script to get inputs from a Salesperson and update the Lead status with a single button click. In this
                                                                                                                • How to Filter timewise question to check uploaded one month or two months before in these community question ?

                                                                                                                  i want to find the question that is asked some month or before any particular year, so how can i filter it ?
                                                                                                                • Proposal for Creating a Unique "Address" Entity in Zoho FSM

                                                                                                                  The "Address" entity is one of the most critical components for a service-oriented company. While homeowners may change and servicing companies may vary, the address itself remains constant. This constancy is essential for subsequent services, as it provides
                                                                                                                • Workflow Down/Bug

                                                                                                                  We have a workflow that sends an email to one of our internal departments 10 minutes after a record is created in a custom module. The workflow actually works correctly. However, we have now noticed that on January 8, between 3:55 p.m. and 4:33 p.m.,
                                                                                                                • Service Locations: Designed for Shared Sites and Changing Customers

                                                                                                                  Managing service addresses sounds simple—until it isn’t. Large facilities, shared sites, and frequently changing customers can quickly turn address management into an operational bottleneck. This is where Service Locations deliver clarity and control.
                                                                                                                • Can I re-send the Customer Satisfaction Survey after a ticket closure?

                                                                                                                  Hello, Some customers does not answer the survey right after closure, is it possible to re-send after a few days or weeks? Best Regards!
                                                                                                                • Is the app being developed?

                                                                                                                  Hi, is this app being developed/improved? Or is it just another app started and let go like others (market automation, campaign, etc)?
                                                                                                                • Filter contacts based on selected category in Zoho Desk ticket

                                                                                                                  Hello community, I’m setting up the Tickets module in Zoho Desk and I need help implementing the following: When a category is selected in a ticket, I want the Contact field to be filtered so that it only displays contacts that are related to that category.
                                                                                                                • Profile Page View Customization

                                                                                                                  I need to change the fields, sections from the profile view of an emplyoyee.
                                                                                                                • Zoho Desk Android app update: Filter, Sort and Saved filters Enhancements

                                                                                                                  Hello everyone! We are excited to introduce the below features on the Android version Zoho Desk mobile app: 1. Filter & Sort support has been introduced for the Contacts and Accounts modules. 2. Sort options is now available in Custom Modules as well.
                                                                                                                • Accessing shared mailboxes through Trident (Windows)

                                                                                                                  Hi, I have a created a couple of shared mailboxes. The mailboxes are showing up on the browser based Zoho workplace, but I cannot seem to figure out how to access my shared inboxes through Trident (Windows). Am I missing something or is this feature not
                                                                                                                • filtering lookup field options based on information in another module.

                                                                                                                  In our CRM system. We have the standard Accounts and Deals modules. We would like to introduce the ability to classify Accounts by Sector. Our desired functionality is to have a global list of all sectors that an Account can select, with the ability to
                                                                                                                • Introducing Assemblies and Kits in Zoho Inventory

                                                                                                                  Hello customers, We’re excited to share a major revamp to Zoho Inventory that brings both clarity and flexibility to your inventory management experience! Presenting Assemblies and Kits We’re thrilled to introduce Assemblies and Kits, which replaces the
                                                                                                                • Next Page