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

• Automate attendance tracking with Zoho Cliq Developer Platform

  I wish remote work were permanently mandated so we could join work calls from a movie theatre or even while skydiving! But wait, it's time to wake up! The alarm has snoozed twice, and your team has already logged on for the day. Keeping tabs on attendance

• Customer payment alerts in Zoho Cliq

  For businesses that depend on cash flow, payment updates are essential for operational decision-making and go beyond simple accounting entries. The sales team needs to be notified when invoices are cleared so that upcoming orders can be released. In contrast,

• 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

• Recent Topics

• Error with If formula

  I've got this super simple If formula, what is the reason for the error? If ( LEN(${Leads.Trial Slot Option}) == 3,'y','n') Syntax Error. Check the examples for any functions you're using to see if you formatted them correctly. Make sure your fields are

• Announcing Multi-language Support in Zoho FSM

  Zoho FSM now speaks your language. The much-awaited multi-language support is now available in Zoho FSM. The following languages are supported in Zoho FSM: Dutch (Nederlands) English - United Kingdom English - United States French (français) French -

• Creating multiple CRM leads from a Zoho Forms subform

  Hi all, We have a heavily used intake form that is used for new leads as a part of our intake. There is a subform that allows the lead to add additional team members, their titles and other basic info. That form submission creates a new Lead and the subform

• Free webinar! Build smarter apps with Zoho Sign and Zoho Creator

  Hello, Bring the power of digital signatures to the apps you build in Zoho Creator! Connect Zoho Sign as a microservice and enable seamless e-signature workflows in your applications. This integration allows you to automate signing tasks using Deluge.

• Restrict Addresses in Zoho Forms?

  In the address field, is there a way to restrict the addresses that auto populate (via Zoho Maps or Google Maps) to a specific state (I know it's possible with the country). Additionally, how often does the address in Zoho Maps get updated? Certain addresses

• Weekly Tips: Secure your attachment downloads with Zoho Mail

  Safety is one of our main concerns, whether it’s about device security or online protection. We use tools like fingerprint scanners, facial recognition, and two-factor authentication to keep our devices and email accounts secure. We use methods like OTP

• Resume Harvester: New Enhancements for Faster Sourcing

  We’re excited to share a set of enhancements to Resume Harvester that make sourcing faster and more flexible. These updates help you cut down on repetitive steps, manage auto searches more efficiently, and review candidate profiles with ease. Why we built

• Looking for best practices to import data from SAP Business One (on-prem) into Zoho Analytics via Zoho DataPrep / Databridge — daily automated schedule

  Hi all, I’m using SAP Business One on-prem (SQL Server / or HANA — depending on DB backend) as our ERP. I want to build a pipeline that, every morning at 9:00 AM IST: pulls transactional data (invoices, customers, products, stock, etc.) from SAP B1, loads

• Zoho One Unified Portal - Applications

  Hello, It is great to see the work on the New Unified Customer Portal. Thanks for that. The number of applications is limited though. It is now only around the Zoho Books ecosystem (Books, Expense...) and Zoho Social. = Are other applications planned

• Marketing Tip #10: Start a customer loyalty program

  Winning a new customer is great, but keeping them coming back is even better. A loyalty program rewards repeat buyers with points, giving them more reasons to shop again. Over time, this builds trust and long-term relationships. Try this today: Set up

• Zia Actions: AI-powered Workflow Automation for Faster and Smarter Execution

  Hello everyone, Updated on 12th Dec 2025 Zia actions for Workflow is available for Enterprise edition ONLY. These features are currently available in the following DCs: US, CA, EU, IN, and AU Email Auto reply and Content Generation are available as Early

• Do Individual Forums within Categories, in Desk Community, Produce Their Own RSS Feed?

  Do Individual Forums within Categories, in Desk Community, Produce Their Own RSS Feed? If not, can anyone share a work-around that could help me get an RSS feed for individual category forums?

• Incremental Migration Issue – Ticket Showing Resolution on Dec 9 Despite Urgent MX Cutover (Ticket ID: 152080262)

  I am experiencing an issue with Zoho Mail incremental migration from Rackspace. The initial full migration completed successfully, but the incremental migration for one mailbox failed immediately with the message: “User not exist” This appears to be a

• Resend Client Portal Invitation + View Email Delivery Status

  Hi Zoho Team, We hope you are doing well. We would like to request two important enhancements related to the Zoho Creator Client Portal invitation process. At the moment, when we add a user to the Client Portal, Zoho Creator automatically sends an invitation

• Get user last login

  1. Is there a way to programmatically get the last user login to trigger certain workflows? 2. Is there a way to programmatically access the custom fields on a user's account?

• Seeking Zoho Creator Expert (Delivery Management App / Logistics Ops) — Built & Deployed Before

  Hi everyone, We’re building a Delivery Management App (focused on delivery operations for now) using Zoho Creator. We’re looking for a Zoho Creator expert who has already developed and deployed a similar delivery/workflow system and can assist us with

• Adding Multiple Files to a Zoho Vault Entry

  There is a old blog post talking about adding multiple file attachments to one Zoho Vault Secret: https://www.zoho.com/blog/vault/introducing-new-features-in-zoho-vault-powerful-password-sharing-wider-storing.html Is that still possible, I can see how

• FNB South Africa Bank Feed

  I should've thought this wouldn't work. As suspect, Zoho claims to be able to pull bank feeds from First National Bank (South Africa), but fails everytime. I suppose Xero (or even Sage One) is the way to go? If they (miraculously) get it to work again,

• Zoho unreliable

  Some mails are delivered, others not. How can I trust Zoho any more? Some friends get my e-mail, some don't. Same with receiving e-mails: Some I get, some not. If I use Google, everything works well. But Zoho?!!! How to solve this problem? I already reported this problem before, but didn't get any reply. Thanks, Kim

• the custom domain forwards by default to the old career site / how to switch it off??

  dear friends, how to switch off the old version of the career site?? The set up custom domain forwards directly to the old site, so that I cant publish it... Any ideas? Thank you! KR, Victoria

• Preserve Ticket Issue Mapping When Migrating from Jira to Zoho Projects

  Hello Zoho Projects Team, We hope you are doing well. We are currently exploring a full migration from Jira to Zoho Projects, and we identified a critical limitation during the migration process involving Zoho Desk integration. Current Situation: We use

• Recording Shopify/Amazon fees in Zoho Books - Zoho Inventory

  We are currently flushing out the connections between Shopify/Amazon and Zoho Inventory. For other users of Zoho Books - Zoho Inventory, where and at what point do you record the merchant fees associated with theses channels? I have gotten mixed responses

• Pre-fill webforms in Recruit

  I don't want to use the career site portal (as I have my own already), but I would like to direct users to the application forms for each role, from my website job pages. Is there a way to pre-fill fields in Recruit application forms, so that I only have

• Taxes Payable Adjustment

  I am from Canada and I need to make an adjustment to my Taxes Payable (HST) account.  Basically I need to take a portion of the amount within Taxes Payable and expense that portion to another account.  The adjusting entry would like like the following:

• ASAP Widget Not showing "My Tickets"ed

  Hello Team, I have created a ZOHO ASAP Widget and embedded to my portal app.clearvuiq.com , widget renders ok and I can open tickets from widget. However I want my opened tickets to be visible in the widget. How can I achieve that?

• How to view CRM Sales Orders in Desk

  What's the usual way to view all CRM sales orders linked to a contact, when viewing a ticket in Desk? I don't want to have to open a new tab to see the order in CRM. And the Desk CRM sidebar doesn't seem to be configurable. Would I have to use an extension

• Kaizen #219: Actions API - Webhooks APIs - Part 1

  Hello all!! Welcome back to a fresh Kaizen week. In the previous weeks, we covered Workflow Rules APIs, Actions APIs - Email Notification APIs, Tasks Update API, and Field Update API. This week, we will continue with another Actions API - Webhooks API

• Pricing Strategies: #3 Services never Stop with just Plans

  "Hey, while you're here, could you also take a look at the vegetable patch?" Aaron hears that line almost every week. He runs a small gardening service, the kind where customers subscribe to a simple monthly plan that includes basic maintenance, mowing,

• Cropping Photos for Zoho Sites

  Hi, I'm wondering if there is a built in crop tool for zoho sites for my photos so I can crop them and see what the crop looks like on the site?

• Possible for first Signer of Sign Form to specify the next signer in the sequence

  We have many use cases where multiple signers need sign the same document. We'd love to be able to use sign forms, where the a signer who uses the Sign Form link can specify the name and email address for the next person in the sequence.

• BUG: Can't copy-paste data outside Sheet

  Currently I can't paste data copied from inside any of my Zoho Sheet files to any other app. Copy-paste works inside the sheet It does NOT work between two different sheets These sheets are built from automation templates Everything works fine if I create

• Zoho CRM Community Digest - November 2025 | Part 1

  Hello Everyone! Here’s what came through in the first half of November: new updates and a few helpful community discussions with real, notable solutions. Product Updates: Android App Update: Inctroducing Swipe Actions You can now swipe left or right on

• Upload own Background Image and set Camera to 16:9

  Hi, in all known online meeting tools, I can set up a background image reflecting our corporate design. This doesn't work in Cliq. Additionally, Cliq detects our cameras as 4:3, showing black bars on the right and left sides during the meeting. Where

• Truesync for Linux

  Is Truesync available on linux ?

• Hidding/excluding specific picklist options from filter

  Hi. Is it possible to hide/exclude specific picklist options from this filter? I don't want them to be shown when someone tries to filter in the leads module

• Subforms to Capture Multi-Row Data in Job Sheets

  Subforms transform your job sheets from simple checklists to powerful, data-rich forms. In field service work — whether maintenance, inspection, installation, or repair — a single job can involve multiple repeatable entries: readings, parts used, activities

• Add "Fetch Composite Item" Action for Inventory

  I want to make a Flow that uses information returned in the GET call for Composite Items, and it's not currently available in Zoho Flow. Please consider adding this functionality.

• Adress Labels for sending of the oder und barcode

  We want to print with my address labels to stick on the order of the ware can. there are these options?

• printing individual labels - Dymo LabelWriter

  I am trying to print individual labels to my Dymo LabelWriter - has anyone done this? Latest Update (December 2025): The Canvas Print View is now available! We encourage you all to try it out and share your feedback with us. Learn more here: Zoho CRM

• Zoho Creator for Agriculture

  Greetings, I am starting to work on  Zoho Creator specifically for the agricultural field, any recommendations, tips or ideas that might be helpful ? Also, if you are interested by any means in working on such project, kindly contact me. The project is

• Next Page