Automation#21: Track Ticket Transfers Across Departments

Hello Everyone!

With Halloween just around the corner, we'd like to let you know the Zoho Desk team is always there to sweep away your customer service troubles!

This week, we’re excited to introduce a custom function that tracks tickets moved between departments.

While Zoho Desk has simplified customer service, keeping your support team stress-free and your customers happy often requires thoughtful adjustments. Zylker Techfix found a great solution with this feature. They handle services for different gadget types under specific departments, but sometimes tickets accidentally end up in the wrong department. Agents moved them to the correct one, but needed a way to track these transfers. By using the Time Entry feature and a custom function, they generated reports of all moved tickets effortlessly.

Here’s the custom function that utilizes the Time Entry feature to track tickets transferred between departments.

Prerequisites

1. Create Custom Fields

To track tickets moved from one Department (call it Dep A) to the other Department (call it Dep B) or vice versa, 

1.1 Go to Setup (S) >> Customization >> Layouts and Fields. Select Time Entry under Layouts and the Department (let's say Dep B) to which you would like to move the ticket. 

1.2 Create three custom single line fields in the Time Entry layout of the respective department (Dep B) . Click on the layout, 

1.2.1 Add a single line field with a label From department.

1.2.2 Add another single line field with a label To Department.

1.2.3  Add the third single line field with the label Agent Name.

1.3 Note the API names for the the single line fields to insert into the custom function. 

To find the API name, Click on the Gear wheel icon of the single line field. Click on Edit Properties, you will find the API Name under the Edit Field. Refer to Create Custom Fields. 

If you would like move the ticket from Dep B to Dep A, create the similar fields in the time entry layout for Dep A.

2. Create a connection

      2.1 Go to Setup(S) and choose Connections under Developer Space.

      2.2 Click Create Connection.

      2.3 Select Zoho OAuth under Default Connection.

      2.4 Set the connection name as ticket_time_entry_add.

      2.5 Under Scope, choose the below scope values:

             Desk.tickets.READ

             Desk.tickets.UPDATE

      2.6 Click Create and Connect.

      2.7 Click Connect and click Accept.

Connection is created successfully.

Create a Workflow Rule

1. Go to Setup(S), choose Workflows under Automation. 

2. In Workflow Rules, select the Department (Dep B) to which you want to move the tickets. 

3. Under Workflows, click Rules >> Create Rule.

In the Basic Information section,

4. Select Tickets from the drop-down menu under Module.

5. Enter a Rule Name and Description for the rule.

6. If you want to activate the rule right away, select the Active checkbox. Else, create the rule and activate it later.

7. Click Next.

In the Execute on section, follow these steps:

8. Select Create.  

9. Click Next.

10. Leave the Criteria section blank and click Next. 

11. In the Actions section, click the + icon and select New next to Custom Functions.

12. Enter a Name and Description for the custom function.         

                                         

13. In the script window, insert the Custom Function given below:

1. //----------- User Input -------------
2. deskURL = "https://desk.zoho.com";
3. fromDepartmentFieldAPIName = "cf_from_department";
4. toDepartmentFieldAPIName = "cf_to_department";
5. agentAPIName = "cf_agent_name";
6. //----------- Configuration ------------------
7. logs = Collection();
8. timeEntryParam = Map();
9. cf = Map();
10. historyParam = Map();
11. historyParam.put("from",0);
12. historyParam.put("limit",1);
13. historyParam.put("fieldName","departmentId");
14. ticketHistory = invokeurl
15. [
16. url :deskURL + "/api/v1/tickets/" + ticketId + "/History"
17. type :GET
18. parameters:historyParam
19. connection:"ticket_time_entry_add"
20. ];
21. logs.insert("ticketHistory":ticketHistory);
22. if(ticketHistory != null && ticketHistory.get("data") != null)
23. {
24. historyDetails = ticketHistory.get("data").get("0");
25. logs.insert("historyDetails":historyDetails);
26. if(historyDetails.get("eventName") == "TicketUpdated" && historyDetails.get("eventInfo").get(0).get("propertyName") == "Department")
27. {
28.   departmentDetailsChanges = historyDetails.get("eventInfo").get("0").get("propertyValue");
29.   previousDepartment = departmentDetailsChanges.get("previousValue").get("name");
30.   currentDepartment = departmentDetailsChanges.get("updatedValue").get("name");
31.   agent = historyDetails.get("actor").get("name");
32.   departmentChangedTime = historyDetails.get("eventTime");
33.   cf.put(fromDepartmentFieldAPIName,previousDepartment);
34.   cf.put(toDepartmentFieldAPIName,currentDepartment);
35.   cf.put(agentAPIName,agent);
36.   timeEntryParam.put("executedTime",departmentChangedTime);
37.   timeEntryParam.put("cf",cf);
38.   logs.insert("timeEntryParam":timeEntryParam);
39.   createTimeEntry = invokeurl
40.   [
41.   url :deskURL + "/api/v1/tickets/" + ticketId + "/timeEntry"
42.   type :POST
43.   parameters:timeEntryParam.toString()
44.   connection:"ticket_time_entry_add"
45.   ];
46.   logs.insert("createTimeEntry":createTimeEntry);
47. }
48. }
49. info logs;

NOTE

a. In Line 2, Replace ".com" with the domain extension based on your Data Center.

b. In Line 3, add the API name of the From Department created in the Time Entry Layout.

c. In Line 4, add the API name of the To Department created in the Time Entry Layout.

d. In Line 5, add the API name of the Agent Name created in the Time Entry Layout.

14. Click Edit Arguments and include the argument mapping as below: 

       14.1 In the Name field, type ticketId and from the Value drop-down list, select Ticket Id under the Tickets Section.

15. Click Save to save the custom function.

16. Click Save again to save the workflow.

If you would like to move the ticket from Dep B to Dep A, create  the workflow rule in Dep A as well. 

Creating Ticket Tracking Reports

To track the ticket moved from one department, you can generate Reports under Analytics. 

Go to the Analytics module >> Choose Reports >> Add Report >> Select Tickets module and Time Entry under Related modules. Refer to Create Custom Report.

This custom function will help you keep an eye on your ticket movements, ensuring that none of your important tickets go missing!

Wishing you a delightful Halloween filled with joy and treats, along with a wonderful fall season! 🎃🍂

Until next week,

Warm regards,

Lydia Kiruba | Zoho Desk 

• Topic Participants

• Lydia | Zoho Desk

  

• Mohd Hayzee

• Ajith | Zoho Desk

  

• Shivani | Zoho Desk

  

• Sticky Posts

• Zoho Desk Virtual Meetup: US Central, October 5 - 7, 2021

  After the interactive Virtual Meetups in the other regions, we are starting with the US Central and Midwest regions from October 5 to October 7, 2021. The dates for other regions will be announced soon.  At this event, we will explore the topics which

• Register for Zoho Desk Beta Community

  With the start of the year, we have decided to take a small step in making the life of our customers a little easier. We now have easy access to all our upcoming features and a faster way to request for beta access. We open betas for some of our features

• Ask the Experts 10: A 5-hour online Q&A on Zoho Desk Best Practices

  Welcome to Zoho Desk's Ask the Experts session! This is a monthly discussion on our  forums; wherein a panel of experts will take on questions  specific to topics related to Zoho Desk. The panel will be available for a 5-hour period and will answer any questions posted here.   Let's begin the year learning some best practices from our experts. In this month's ATE we are opening the floor to questions on how to use Zoho Desk the best way.  If you have a business use case but not sure if Workflow is

• Share your Zoho Desk story with us!

  Tell us how you use Zoho Desk for your business and inspire others with your story. Be it a simple workflow rule that helps you navigate complex processes or a macro that saves your team a lot of time; share it here and help the community learn and grow with shared knowledge. 

• Ask the Experts 7: A 5-hour online Q&A on Telephony and Call Module

  Welcome to Ask the Experts session! This is a monthly discussion in forums; each session, a panel of experts will take questions on specific topics related to Zoho Desk. The panel will be available for a 5-hour period and answer any questions posted here. In this month's Ask the Experts, we will take questions on everything related to Telephony and the Call Module in Zoho Desk. We will discuss the following aspects:  Integration with different Telephony vendors Routing calls to agents Converting

• Recent Topics

• How to add tags to a record with jS SDK 1.2/ZohoEmbededAppSDK

  Hello Is it possible to add tags to a record with jS SDK : https://live.zwidgets.com/js-sdk/1.2/ZohoEmbededAppSDK.min.js ZOHO.CRM.API.updateRecord Thanks for insights

• URGENT: Zoho Forms reCAPTCHA v2 Spam Issue

  Hello Everyone, We are encountering a critical issue with Zoho Forms despite having reCAPTCHA v2 enabled. Our business is accessibility-focused, and we are receiving a high volume of spam submissions, which is significantly affecting our workflow and

• View all Products by pipeline deal

  Very good CRM I use it everyday only problem is modules not being interconnected especially products module. The main problem of products module are separated from contacts and company modules and only being connected to the Deals module. This way there's

• Add "Lead Image" in Bulk?

  Each of our Leads is accompanied with a URL containing a photo of the lead when they come in. We currently have to manually download then upload the photo to the lead. This is a HUGE waste of time. Is there any way to AUTOMATICALLY add the photos to the

• Map fields from CRM record to Finance Suite/Books Invoice fields

  I'm trying to auto-fill unique record specific field inputs that I have in my Contacts and Deals modules onto Invoices created from the record's finance suite related list upon creation.  One example is a field called "Job Number" that I have in my Contact

• Add and Remove Agents from Departments and Groups in Zoho One

  Hi Zoho Flow Team, We hope you're doing well. Currently, Zoho Flow provides an action to add an agent to a group in zoho one, but there is no action to remove an agent from a group or a department. Another action that we find missing is the option to

• Zoho CRM - best way to search an account and assign to a deal

  Hi Everyone I am looking for some advice. I want to find the best way to complete the below steps. We have a deal and once it reaches a certain stage we need to allocate a supplier / vendor to this deal along with the salesperson. I want to add (ideally

• What's New in Zoho Analytics - December 2024

  Hello Users! We’re excited to bring you a roundup of the latest features and improvements in Zoho Analytics. These updates are designed to elevate your data analytics experience, making it more powerful, interactive, and seamless. Let’s dive in! Expanded

• trying to access CRM Variables with JS SDK

  Hello i built a widget with Sigma, i create CRM VARIABLES in custom properties. I try to access them in function : ZOHO.embeddedApp.on("PageLoad",function(data) with : ZOHO.CRM.CONFIG.getVariable("mycrmvariable").then(function(data){ console.log("mycrmvariable

• Writing on sketch cards is bugged when zoomed in

  When zoomed in, it writes a noticeable distance above or to the side of where you're actually trying to write. The further you're zoomed in, the more noticeable it is. Zooming is also entirely absent on the desktop version.

• Private Project

  Hi, I would like to know if a user can create a Private project that only he's able to see it. Not even the ADMIN user. Thanks

• Accordion in tabs to create FAQs, etc.

  Accordion elements do not seem to be able to be placed in the tabs. It would be useful to be able to do this. Thank you.

• Which are the IP addresses to use for 'split delivery' with Office 365? (Zoho mail inbound gateway)

  Hi, I'm trying to set up 'split delivery' (email routing) with Office 365. I'm following the instructions to set up Office 365 as the primary server (https://www.zoho.com/mail/help/adminconsole/coexistence-with-office365.html) One of the prerequisites

• Zoho Projects 2024 Recap

  Dear Users, As we conclude another remarkable year, it's the time to reflect on the journey we've just completed. The year 2024, defined by significant milestones, challenges, achievements, and important lessons. Every moment has contributed to the story

• Custom Fields at Line Level

  Hi, is there an ability to add custom fields at line level? I need to track the start and the end date for each product within an invoice and I can't seem to find an option to do this.

• Zoho API Error Code 7019 when adding job.

  Hello, I am following the documentation found here. https://www.zoho.com/people/api/timesheet/adding-jobs.html Regardless of how I try and post the data (including just using the example requests), I receive back the response {'response': {'message':

• How to see changes with ZOHO.CRM.API.updateRecord(config) without reload page

  hello got a widget in account, trigger with a button i copy data to account when click on a button, in my popup All is working well. But i need to reload the page to see the update. How can i see the changes without reloading page, only when close the

• How to call a Creator function which is in a different Creator application?

  How to call a Creator function which is in a different Creator application?

• Unable to send message; Reason: 554 5.1.8 Email Outgoing Blocked

  My account is mino@flawless-frames.com, or flawlessframesstudio@gmail.com Could you please unblock my account, I've got restricted from sending more emails

• Stock Count

  The stock count is a nice new feature, but we cannot figure out how to: 1. Use it without assigning to a person, we have a team or one of multiple do stock counts as do most any company. 2. Add any extra fields to what the "counter" sees. The most important

• Move a Contact from Current Account to a NEW Account

  I do not believe the functionality to Move a Contact from a Current Account to a New Account is not available. Please someone tell me I am missing something! I have been through designing, developing, using and selling CRM systems for over 25 years and had this functionality20+ years ago in other CRMs.  In the real world people move from one organisation to another. In the sales, finance and technical world it is nice to see the communication history with that person in their old account and also

• Force Specific Layout for CRM Contacts Portal

  Hello: We're in trial on ZOHO One and looking at the CRM Portal (just for the contacts module). We have a client layout set up for Contacts that is working well for our internally, but for the portal we don't want to require (make mandatory) some of the

• Automatic Removal of Departments and Groups for Inactive Employees in Zoho One

  Hi Zoho One Team, We hope you're doing well. Currently, when an employee is marked as inactive in Zoho One, they remain listed as a member of their department and associated groups. This creates a challenge in maintaining accurate records and ensuring

• Change eMail Template for Event-Invitations

  Hello ZOHO-CRM Team How I can change the eMail Template for Event-Invitations? I work with the German Version of the Free Version. I know how I can modify eMail alerts or Signature Templates, but where I can other eMails modify you send out? Thank you for your answer. Regards, Juerg

• Zoho Social integration with Zoho Flow

  Is there any plans for Zoho Social integration with Zoho Flow?

• Zoho CRM Widget and translations

  Hi everyone! We're building a Widget with zoho-extension-toolkit, how is localization supposed to work? "zet init" created a translations/en.json file, but what should go inside it and how is it supposed to be accessed from the Widget/javascript? Thanks

• Bienvenue à Zoho FSM : l'optimisation des opérations locales qui offre une expérience de service impeccable

  Nous sommes ravis de vous présenter Zoho FSM, la plateforme de gestion des services terrain de bout en bout. Les solutions de gestion des services locaux s'adressent aux organisations qui effectuent des activités d'installation, de réparation et de maintenance

• Adding tag to specific record as an acion in a workflow

  Hi! I've created the following workflow in the module 'Leads'. When a record meets the criteria, there should be a tag added to the specific record in the module 'Contacts'. In the module 'Leads', there is a look-up field named 'Kandidaat' which is connected

• Trying to catch error with ZOHO.CRM.HTTP.get (Response Code)

  Hello, I'm trying to get response header from ZOHO.CRM.HTTP.get, in order to catch error like 404 or something else but it seems that ZOHO.CRM.HTTP.get() method only returns the body of the response, and I see no way to access the headers returned. Is

• FSM - How to ADD PHOTOS to Estimates & Invoices

  How can you add photos to estimates and invoices that are being emailed to the client so the can see what you are estimating and your completed work?

• Free developer edition of Zoho CRM

  A question for Zoho and other developers: How can you set up a demonstration version of a Zoho CRM implementation to show employers/clients what can be achieved? Do you pay for Zoho CRM Enterprise/Zoho One for this purpose? Does Zoho offer a free version

• Can I add Conditional merge tags on my Templates?

  Hi I was wondering if I can use Conditional Mail Merge tags inside my Email templates/Quotes etc within the CRM? In spanish and in our business we use gender and academic degree salutations , ie: Dr., Dra., Sr., Srta., so the beginning of an email / letter

• Where are scheduled emails stored?

  After you schedule an email to go out through the CRM, how do you go about changing that scheduled email? Or even where can I see the list of emails scheduled to go out? They are not listed in my Zoho Mail account in Outbox which has been the only answer

• CRM Home Page Dashboard, how can i add zoho desk cases?

  How can i see which tickets are in my group as a dashboard component on the home tab in zoho crm? I don't see any way of adding this.

• Frontal interview scheduling - room availability in office using Google Workspace?

  Hi, We're using Zoho Recruit as our ATS and Google Workspace as our email, calendar and resources management. We want to use the interview feature to schedule an in-person (frontal) interview with the applicants. How can we sync the room resources availability

• Custom Module missing SDK function fetchRelatedRecords(...) in a Client Script

  Good day, We have added a new module with a Multi-Lookup relation to Contacts.  When we tried to use the fetchRelatedRecords(id, related_list_api_name) function to get Related Records it is missing for our new custom module. https://js.zohocdn.com/crm/5124797/documentation/DotSDK/Modules.html

• Assistance with Setting Default Values for Zoho Chat Custom Fields

  I am currently using the Zoho Chat JavaScript API to successfully add custom fields to the chat interface. While the implementation of these fields has been smooth, I am now looking to set default values for these custom fields. However, I couldn't find

• Subform Client Script

  Good day,  I have a subform where users can subscribe to various magazines. I would like to prevent the user from selecting the same magazine twice when adding a new row. Is there a way to prevent the user from doing this? (Can it be done via a client

• Checklist/ save to onedrive/ a group of items invoicing in Zoho FSM

  hi, is there a way to add a specific checklist to any WO without passing eachtime by the model customization? can we save file such picture directly in our sharepoint ak onedrive? is there any way to add a group of item pre defined to make invoicing easier

• Serious question: Are there actually "solo-preneurs"/small business owners who made Zoho-one work well for them?

  L.S. After already many years of continued struggle with Zoho-One, I am seriously wondering if there are actually solo-preneurs (one person small business owners - without a large, dedicated IT dept.) who got it (Zoho-One) to work well for their businesses.

• Next Page