Convert a message on Cliq into a task on Zoho Connect

Message actions in Cliq are a great way to transform messages in a conversation into actionable work items. In this post, we'll see how to build a custom message action that'll let you add a message as a task to board on Zoho Connect. 

If you haven't created a board in Zoho Connect, then head over to this help document to know how to create one. 

For this example, we've created a board for the Zylker Campaigns team in Zoho Connect. The board has three sections: User Interface, Content Marketing, Customer Support. We'll see how the marketing team discusses about upcoming marketing initiatives and keeps track of tasks in their connect board. 

The workflow behind creating this message action is pretty simple. 

1. Once a user clicks on the Add Connect Task message action, the action's handler is triggered to display a form. 

2. The user fills all the information required. We use the form change handler to modify the form field values based on the users' inputs. For example, display networks that the user is a part of by default and on selecting a specific network, we'll show the list boards that the user is a part of under the selected network. The same applies for sections as well. 

3. On choosing the respective network, board and section, the user can add the task title, description, due date, assignee and more. Note that, the message on which the action was performed will be displayed as the task title by default. This can be modified.

4. On clicking Add Task, the form submit handler is invoked to create a task in Connect with all the provided details. 

Prerequisites

Create a connection between Cliq and Connect: 

You'll need an active connection between Cliq and Connect. To create a connection, 

1. Click on your display picture. This will open up the user panel. Now, click on Bots & Tools. 
   
2. Click on the Connections icon present on the left side menu of the Bots & Tools page. 
   
3. Now, click on Create Connection. 
   
4. In the Add Connections view, select the Zoho Oauth option. 
   
5. Name your connection. For example you can name your connection: zoho_connect or zohoconnect and choose the following scopes: zohopulse.networklist.READ, zohopulse.tasks.READ, zohopulse.tasks.CREATE
   
6. Make sure the Use Credentials of Login User option is enabled. 
   
7. Click on the Create and Connect button to generate the invoke URL task with the connection name. 
   

We'll be using this invoke URL task in our code. 

Create a message action 

To create a message action on Cliq, 

1. Click on your display picture. This will open up the user panel. Now, click on Bots & Tools. 
   
2. Click on Message Actions in the left pane.
   
3. Click on the Create Message Action button and fill in the required details. 
   
   Action Name: Provide your message action name. This field is mandatory.
   
   Hint: Brief explanation about the message action.
   
   Access Level: Decide who gets to access your message action. Choose between Organization, Team and Private. Default option is Private.
   
   Choose what kind of messages should have the message action. Options are Text messages, Attachments and Links. For this example, we're choosing messages of the type Text. 
   
4. Click on Save & Edit Code. 
   

Create a form function

To create a form function on Cliq, 

1. Click on your display picture. This will open up the user panel. Now, click on Bots & Tools.
   
2. Click on Functions in the left pane. Click on the Create Function button and fill in the required details. 
   

• Name: Give your function name. Ensure to use the same function name in your form's code as well. 
  
• Description: Briefly describe how your function works. 
  
• Function Type: Choose the component with which the function should be associated. For this example, we're using the function of the type: Form 
  

Step 1: Configuring the message action handler

The message handler is triggered to return the Create Task form as a response. 

1. messageText = message.get("content").get("text");
   
2. getNetworks = invokeurl
   
3. [
   
4. url :"https://connect.zoho.com/pulse/api/allScopes"
   
5. type :GET
   
6. connection: "" // Give your connection name
   
7. ];
   
8. getNetworks = getNetworks.get("allScopes").get("scopes");
   
9. netWorkOptions = List();
   
10. for each  network in getNetworks
    
11. {
    
12. networkList = Map();
    
13. networkList.put("label",network.get("name"));
    
14. networkList.put("value",network.get("id"));
    
15. netWorkOptions.add(networkList);
    
16. }
    
17. inputs = list();
    
18. inputs.add({"type":"select","name":"networks","label":"Network","hint":"Select a network","placeholder":"Select a network!","mandatory":true,"value":"","options":netWorkOptions,"trigger_on_change":true});
    
19. inputs.add({"type":"select","name":"boards","label":"Boards","hint":"Select a board","placeholder":"Select a board!","mandatory":true,"value":"","options":netWorkOptions,"disabled":"true","trigger_on_change":true});
    
20. inputs.add({"type":"select","name":"sections","label":"Section","hint":"Select a section","placeholder":"Select a section!","mandatory":true,"value":"","options":netWorkOptions,"disabled":"true"});
    
21. inputs.add({"name":"title","label":"Title","placeholder":messageText,"value":messageText,"hint":"Enter your task name","min_length":"0","max_length":"50","mandatory":true,"type":"text"});
    
22. inputs.add({"type":"textarea","name":"note","label":"Description","hint":"Describe your task.","placeholder":"To be done by Tuesday","mandatory":false});
    
23. inputs.add({"name":"duedate","label":"Due by","placeholder":"Give your task's due date.","mandatory":false,"type":"date"});
    
24. inputs.add({"type":"select","name":"priority","label":"Priority","hint":"Choose your task priority","placeholder":"High","mandatory":true,"value":"High","options":{{"label":"No Priority","value":"None"},{"label":"Low","value":"Low"},{"label":"Medium","value":"Medium"},{"label":"High","value":"High"}}});
    
25. addTask = {"name":"addTask","type":"form","title":"Add a task","hint":"Add a task to a board in Zoho Connect. ","button_label":"Add Task","inputs":inputs,"action":{"type":"invoke.function","name":"connectTask"}};
    
26. return addTask;
    

Step 2: Configuring the form change handler

The form change handler will be triggered when the user is filling up the form. The handler is responsible for modifying the form field values based on the user's inputs. 

1. targetName = target.get("name");
   
2. inputValues = form.get("values");
   
3. networkID = inputValues.get("networks").get("value");
   
4. actions = list();
   
5. if(targetName.containsIgnoreCase("networks"))
   
6. {
   
7. getBoards = invokeurl
   
8. [
   
9. url :"https://connect.zoho.com/pulse/api/myBoards"
   
10. type :GET
    
11. parameters:{"scopeID":networkID}
    
12. connection:"" // Give your connection name
    
13. ];
    
14. getBoards = getBoards.get("myBoards").get("boards");
    
15. boardOptions = List();
    
16. for each  board in getBoards
    
17. {
    
18. boardList = Map();
    
19. boardList.put("label",board.get("name"));
    
20. boardList.put("value",board.get("id"));
    
21. boardOptions.add(boardList);
    
22. }
    
23. actions.add({"type":"update","name":"boards","input":{"type":"select","name":"boards","label":"Boards","hint":"Select a board","placeholder":"Select a board!","mandatory":true,"options":boardOptions,"trigger_on_change":true}});
    
24. }
    
25. else if(targetName.containsIgnoreCase("boards"))
    
26. {
    
27. boardId = inputValues.get("boards").get("value");
    
28. getResponse = invokeurl
    
29. [
    
30. url :"https://connect.zoho.com/pulse/api/boardSections"
    
31. type :GET
    
32. parameters:{"scopeID":networkID,"boardId":boardId}
    
33. connection:"" // Give your connection name
    
34. ];
    
35. getSections = getResponse.get("boardSections").get("sections");
    
36. sectionOptions = List();
    
37. for each  section in getSections
    
38. {
    
39. sectionList = Map();
    
40. sectionList.put("label",section.get("name"));
    
41. sectionList.put("value",section.get("id").toString());
    
42. sectionOptions.add(sectionList);
    
43. }
    
44. getMembers = getResponse.get("boardSections").get("members");
    
45. if(getMembers.isempty() == false)
    
46. {
    
47. boardMembers = List();
    
48. for each  member in getMembers
    
49. {
    
50. memberList = Map();
    
51. memberList.put("label",member.get("name"));
    
52. memberList.put("value",member.get("zuid"));
    
53. boardMembers.add(memberList);
    
54. }
    
55. actions.add({"type":"update","name":"sections","input":{"type":"select","name":"sections","label":"Section","hint":"Select a section","placeholder":"Select a section!","mandatory":true,"options":sectionOptions}});
    
56. actions.add({"type":"add_after","name":"duedate","input":{"type":"select","name":"members","multiple":true,"label":"Assignees","hint":"Add assignees","placeholder":"Assign task to a member","mandatory":false,"options":boardMembers}});
    
57. }
    
58. else
    
59. {
    
60. actions.add({"type":"update","name":"sections","input":{"type":"select","name":"sections","label":"Section","hint":"Select a section","placeholder":"Select a section!","mandatory":true,"options":sectionOptions}});
    
61. }
    
62. }
    
63. return {"type":"form_modification","actions":actions};
    

Step 3: Configuring the form submit handler

We'll call the create task API in form submit handler. The submit handler typically receives all the inputs filled by the user and will be triggered on form submission. 

1. response = Map();
   
2. formValues = form.get("values");
   
3. scopeID = formValues.get("networks").get("value");
   
4. boardId = formValues.get("boards").get("value");
   
5. sectionId = formValues.get("sections").get("value");
   
6. title = formValues.get("title");
   
7. priority_value = formValues.get("priority").get("value");
   
8. parameters = {"scopeID":scopeID,"boardId":boardId,"sectionId":sectionId,"title":title,"priority":priority_value};
   
9. desc = formValues.get("note");
   
10. if(desc != "" && !desc.isEmpty())
    
11. {
    
12. parameters.put("desc",desc);
    
13. }
    
14. duedate = formValues.get("duedate");
    
15. if(duedate != "" && !duedate.isEmpty())
    
16. {
    
17. duedate = duedate.toList("-");
    
18. eyear = duedate.get(0);
    
19. emonth = duedate.get(1);
    
20. edate = duedate.get(2);
    
21. parameters.put("eyear",eyear);
    
22. parameters.put("emonth",emonth);
    
23. parameters.put("edate",edate);
    
24. }
    
25. assignee = formValues.get("members");
    
26. if(assignee != {} && !assignee.isEmpty())
    
27. {
    
28. userIds = list();
    
29. for each  assgineeID in assignee
    
30. {
    
31. userIds.add(assgineeID.get("value"));
    
32. }
    
33. parameters.put("userIds",userIds.toString());
    
34. }
    
35. addTask = invokeurl
    
36. [
    
37. url :"https://connect.zoho.com/pulse/api/addTask"
    
38. type :POST
    
39. parameters:parameters
    
40. connection:"" // Give your connection name
    
41. ];
    
42. if(addTask.get("addTask").get("stream").isEmpty() == false)
    
43. {
    
44. taskTitle = "[" + addTask.get("addTask").get("stream").get("task").get("title") + "](" + addTask.get("addTask").get("stream").get("url") + ")";
    
45. taskpriority = addTask.get("addTask").get("stream").get("task").get("priority");
    
46. tasksection = addTask.get("addTask").get("stream").get("task").get("section").get("name");
    
47. taskboard = addTask.get("addTask").get("stream").get("partition").get("name");
    
48. response = {"text":"Task added in " + taskboard + ". Take a look at the task details below.","card":{"title":"Task Details","theme":"modern-inline"},"slides":{{"type":"label","title":"Task Details: ","data":{{"Title":taskTitle},{"Priority":taskpriority},{"Section":tasksection},{"Board":taskboard}}}}};
    
49. }
    
50. return response;
    
51. 
    

End notes: 

Message actions in Cliq are super versatile like all other Cliq platform components. You can choose to create a message action that's specific to a message type. This example can be customized even to suit messages of the type attachments and links. So go ahead and give it a try! You can download the source code file attached with this post or access this link here: https://workdrive.zohoexternal.com/external/6OxchwzzBCF-J8HFH

Useful Links: 
Zoho Connect Rest API Guide: https://www.zoho.com/connect/api/intro.html

Forms in Cliq: https://www.zoho.com/cliq/help/platform/cliq-form.html

Form Function: https://www.zoho.com/cliq/help/platform/form_functions_workflow.html

Connections in Cliq: https://www.zoho.com/cliq/help/platform/connections.html

• Topic Participants

• Manasa Manogaran

• gilbert

• ROHIT MATHEW

• Mischa

• Shivam mishra

• Sticky Posts

• Automating Employee Birthday Notifications in Zoho Cliq

  Have you ever missed a birthday and felt like the office Grinch? Fear not, the Cliq Developer Platform has got your back! With Zoho Cliq's Schedulers, you can be the office party-cipant who never forgets a single cake, balloon, or awkward rendition of

• Accelerate Github code reviews with Zoho Cliq Platform's link handlers

  Code reviews are critical, and they can get buried in conversations or lost when using multiple tools. With the Cliq Platform's link handlers, let's transform shared Github pull request links into interactive, real-time code reviews on channels. Share

• App Spotlight : PagerDuty for Zoho Cliq

  App Spotlight brings you hand-picked apps to enhance the power of your Zoho apps and tools. Visit the Zoho Marketplace to explore all of our apps, integrations, and extensions. In today's fast-paced world, seizing every moment is essential for operational

• Automate your status with Cliq Schedulers

  Imagine enjoying your favorite homemade meal during a peaceful lunch break, when suddenly there's a PING! A notification pops up and ruins your moment of zen. Even worse, you might be in a vital product development sprint, only to be derailed by a "quick

• Bulk user onboarding for Cliq Channels in a jiffy

  As developers, we frequently switch between coding, debugging, and optimizing tasks. The last thing we want is to be burdened by manual user management. Adding users one by one to a channel is tedious and prone to errors, taking up more time than we could

• Recent Topics

• Zoho Projects Roadshows 2025 - USA

  Dear Users, After an amazing response to our roadshows in 2024, we are excited to be back for the second year in a row! Join our team of experts as they walk you through the most-used features in Zoho Projects, explore powerful automation capabilities,

• Billing Management: #6 Usage Billing for SaaS

  Imagine a customer shuffling across multiple subscriptions, a streaming service, a music app, cloud storage, and a design tool. Each one charges a flat monthly fee, regardless of how much or how little they use. Some months, the customer barely opens

• Send Automated WhatsApp Messages and Leverage the Improved WhatsApp Templates

  Greetings, I hope all of you are doing well. We're excited to announce a major upgrade to Bigin's WhatsApp integration that brings more flexibility, interactivity, and automation to your customer messaging. WhatsApp message automation You can now use

• Filter Based API request in Zoho Books using POSTMAN

  How do I GET only specified CONTACTS based on created time or modified time in Zoho Books using POSTMAN. In the api documentation, it is written we can apply filters but I need a sample request.

• Directly Edit, Filter, and Sort Subforms on the Details Page

  Hello everyone, As you know, subforms allow you to associate multiple line items with a single record, greatly enhancing your data organization. For example, a sales order subform neatly lists all products, their quantities, amounts, and other relevant

• GST Slabs Redefined: Stay Compliant Using Zoho Books!

  Hello Everyone! The Government of India is rolling out new GST rates, a major reform aimed at simplifying the current tax structure starting 22 September 2025. GST will move from four slabs (5%, 12%, 18%, 28%) to two main slabs (5% and 18%), plus a special

• Allow syncing Activities from other applications

  Marketing Automation could be a much more powerful platform if you were able to sync activities into the platform (e.g. purchase, donation, etc) outside of a user doing something on your website. I'd love it if you could sync Custom CRM Modules as activities,

• Create static subforms in Zoho CRM: streamline data entry with pre-defined values

  Last modified on (9 July, 2025): This feature was available in early access and is currently being rolled out to customers in phases. Currently available for users in the the AU, CA, and SA DCs. It will be enabled for the remaining DCs in the next couple

• Zoho CRM IP Addresses to Whitelist

  We were told to whitelist IP addresses from Zoho CRM.  (CRM, not Zoho Mail.) What is the current list of IP Addresses to whitelist for outbound mail? Is there a website where these IP addresses are published and updated?  Everything I could find is over

• Global Sets for Multi-Select pick lists

  When is this feature coming to Zoho CRM? It would be very useful now we have got used to having it for the normal pick lists.

• Introducing Profile Summary: Faster Candidate Insights with Zia

  We’re excited to launch Profile Summary, a powerful new feature in Zoho Recruit that transforms how you review candidate profiles. What used to take minutes of resume scanning can now be assessed in seconds—thanks to Zia. A Quick Example Say you’re hiring

• Integración Books para cumplir la ley Crea y Crece y Ley Antifraude (VeriFactu)

  Hola: En principio, en julio de 2025, entra en vigor la ley Crea y Crece y Ley Antifraude (VeriFactu). ¿Sabéis si Zoho va a cumplir con la ley para cumplir con la facturación electrónica conectada a Hacienda? Gracias

• Ask the Experts #1

  Hello everyone! It’s time to transform how you manage projects. Define the processes. Automate the tasks. Streamline the workflows. Let us dive into automation in Zoho Projects — from configuring workflows and custom functions to building triggers, using

• Has anyone been experiencing slow issues?

  Dear all, I just want to ask if anyone has been experiencing slow issues with Zoho Creator in the past two weeks? I worked with the ISP to improve network quality by changing routes and upgrading bandwidth, but nothing changed. I am in Vietnam.

• Option to Customize Career Site URL Without “/jobs/Careers”

  Dear Zoho Recruit Team, I hope you are doing well. We would like to request an enhancement to the Career Site URL structure in Zoho Recruit. In the old version of the career site, our URL was simply: 👉 https://jobs.domain.com However, after moving to

• How to overcome Zoho Deluge's time limit?

  I have built a function according to the following scheme: pages = {1,2,3,4,5,6,7,8,9,10}; for each page in pages { entriesPerPage = zoho.crm.getRecords("Accounts",page,200); for each entry in entriesPerPage { … } } Unfortunately, we have too many entries

• Setting Default Views for Custom, List and Detail Views

  Hey, Is it possible to set a default custom view, list view and detail view for a module for every user? We are onboarding a lot of non technical people that struggle with these things. Setting the views as default would really help. Btw: also setting

• Zoho Sheet - Printing - Page Breaks and Printing Customization

  I think the title is descriptive enough in that I cannot find help documentation on a simple task of adding in page brakes for separating pages on print. Thanks

• Checking if Creator has Change History

  Like zForms - whenever an entry was updated there's an option to attached change history to email notif. Trigger -> Successful form submission

• Zoho Sheet - Desktop App or Offline

  Since Zoho Docs is now available as a desktop app and offline, when is a realistic ETA for Sheet to have the same functionality?I am surprised this was not laucned at the same time as Docs.

• Zoho sites header

  Good day, Im stuck with this situation. I choose a template for my website creation. I have tweaked every instance of the visual editor, regarding the header, I have created created customize fonts presets... I have followed every single step. and my

• Your bot just got smarter: AI-Powered routing that reads between the lines

  What if your bot could tell the difference? Between a visitor who just needs a quick answer, someone actively comparing options, and a frustrated customer one click away from leaving? Most bots can't. They deliver the same response to everyone, missing

• Recurring Supervisor Rule Reminders for Open/In-Progress Tickets

  Hello Zoho Support Team, I would like to suggest a potential improvement regarding reminders for tickets and activities in Zoho Desk. Currently, it is possible to set reminders only once. In the Supervisor Rules section, it is possible to configure reminders

• Round robin

  Hi, I'm trying to set up a round robin to automatically distribute tickets between agents in my team but only those tickets that are not otherwise distributed by other workflows or direct assignments. Is that possible and if so which criteria should I

• Kaizen #152 - Client Script Support for the new Canvas Record Forms

  Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achieved

• Unable to create embed code for resource of workdrive using API

  Hello Team, I am trying to create embed code for a resource using workdrive api in powershell, however facing some issues with injecting data in body. Followed Doc: https://workdrive.zoho.com/apidocs/v1/filefoldersharing/shareeveryone Please help, below

• how to use validation rules in subform

  Is it possible to use validation rules for subforms? I tried the following code: entityMap = crmAPIRequest.toMap().get("record"); sum = 0; direct_billing = entityMap.get("direct_billing_details"); response = Map(); for each i in direct_billing { if(i.get("type")

• Adding contact role to a specific deal js sdk malfunctioning

  i was trying to add the contact role to a specific deal contact but repeatedly i am getting this error: { "code": "SUCCESS", "details": { "statusMessage": { "code": "INVALID_DATA", "details": { "expected_data_type": "jsonobject" }, "message": "body",

• WIDGET in related record list ZOHO CRM; how to get and put data to subform custom fields?

  he need: Read and write two custom subform line-item fields on Quotes: Segment_wyceny (picklist/text) and W_pakiecie (number). Write works; read does not return these fields via SDK. Environment Zoho CRM Widget Zoho Embedded App SDK v1.2 Module: Quotes

• So we ran with it for the week

  In our company i bit the bullet and ran with FSM for a whole week. Service calls, deliveries and surveys. Covering about 30-120 miles a day to domestic properties. Loved the appointment list and satnav integration. Loved the timer to measure the appointments.

• Q3 Updates from Bigin!

  Hey Biginners, Hope you’re doing great! As we approach the end of 2025, we truly hope Bigin has been a part of helping you build your dream business this year! We've been busy working behind the scenes to bring you features that make running your business

• New Series Announcement - Ecommerce Marketing Tips

  Running an online business is more than just having a website. It’s about getting the right customers to discover you, trust you, and keep coming back. To support your growth journey, we’re launching a weekly Marketing Tips series right here on Zoho Commerce

• Client Script | Update - Introducing Subform Events and Actions

  Are you making the most of your subforms in Zoho CRM? Do you wish you could automate subform interactions and enhance user experience effortlessly? What if you had Client APIs and events specifically designed for subforms? We are thrilled to introduce

• {"errors":[{"id":"500","title":"Servlet execution threw an exception"}]}

  Here's the call to move a file to trash. The resource_id is accurate and the file is present. header = Map(); header.put("Accept","application/vnd.api+json"); data = Map(); data_param1 = Map(); att_param1 = Map(); att_param1.put("status",51); data_param1.put("attributes",att_param1);

• Converting Sales Order to Invoice via API; Problem with decimal places tax

  We are having problems converting a Sales Order to an Invoice via API Call. The cause of the issue is, that the Tax value in a Sales Order is sometimes calculated with up to 16 decimal places (e.g. 0.8730000000000001). The max decimal places allowed in

• Empowered Custom Views: Cross-Module Criteria Now Supported in Zoho CRM

  Hello everyone, We’re excited to introduce cross-module criteria support in custom views! Custom views provide personalized perspectives on your data and that you can save for future use. You can share these views with all users or specific individuals

• Zoho Canvas - Custom templates for related lists

  Hi, I see that the example pages load always one of our related lists in a custom template, but I dont know how to work with that:  1) How can i make my own custom templates for related lists?  2) Where and how can i check out existing custom templates?

• Kaizen #147 - Frequently Asked Questions on Zoho CRM Widgets

  Heya! It's Kaizen time again, folks! This week, we aim to address common queries about Zoho CRM Widgets through frequently asked questions from our developer forum. Take a quick glance at these FAQs and learn from your peers' inquiries. 1. Where can I

• Scheduling Calls in CommandCenter / Blueprints

  I would love it if you could add a function to schedule a call in the lead's record for a future date. I know you can add a Task by going to Instant Actions > Task and completing the form: These tasks go into the lead's record under Open Actions. But

• open word file in zoho writer desktop version

  "How can I open a Microsoft Word (.doc or .docx) file in Zoho Writer if I only have the file saved on my computer and Zoho Writer doesn't appear as an option when I try 'Open with'? Is there a way to directly open the .doc file in Zoho Writer?"

• Next Page