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. Under Basic Information, enter a Name and Description for the custom function.         

13. Under Argument Mapping, give a desired Method Name. Map the argument mapping as below: 

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

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

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