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,

Click on your display picture. This will open up the user panel. Now, click on Bots & Tools.
Click on the Connections icon present on the left side menu of the Bots & Tools page.
Now, click on Create Connection.
In the Add Connections view, select the Zoho Oauth option.
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
Make sure the Use Credentials of Login User option is enabled.
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,

Click on your display picture. This will open up the user panel. Now, click on Bots & Tools.
Click on Message Actions in the left pane.
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.
Click on Save & Edit Code.

Create a form function

To create a form function on Cliq,

Click on your display picture. This will open up the user panel. Now, click on Bots & Tools.
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.

messageText = message.get("content").get("text");
getNetworks = invokeurl
[
url :"https://connect.zoho.com/pulse/api/allScopes"
type :GET
connection: "" // Give your connection name
];
getNetworks = getNetworks.get("allScopes").get("scopes");
netWorkOptions = List();
for each network in getNetworks
{
networkList = Map();
networkList.put("label",network.get("name"));
networkList.put("value",network.get("id"));
netWorkOptions.add(networkList);
}
inputs = list();
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});
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});
inputs.add({"type":"select","name":"sections","label":"Section","hint":"Select a section","placeholder":"Select a section!","mandatory":true,"value":"","options":netWorkOptions,"disabled":"true"});
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"});
inputs.add({"type":"textarea","name":"note","label":"Description","hint":"Describe your task.","placeholder":"To be done by Tuesday","mandatory":false});
inputs.add({"name":"duedate","label":"Due by","placeholder":"Give your task's due date.","mandatory":false,"type":"date"});
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"}}});
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"}};
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.

targetName = target.get("name");
inputValues = form.get("values");
networkID = inputValues.get("networks").get("value");
actions = list();
if(targetName.containsIgnoreCase("networks"))
{
getBoards = invokeurl
[
url :"https://connect.zoho.com/pulse/api/myBoards"
type :GET
parameters:{"scopeID":networkID}
connection:"" // Give your connection name
];
getBoards = getBoards.get("myBoards").get("boards");
boardOptions = List();
for each board in getBoards
{
boardList = Map();
boardList.put("label",board.get("name"));
boardList.put("value",board.get("id"));
boardOptions.add(boardList);
}
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}});
}
else if(targetName.containsIgnoreCase("boards"))
{
boardId = inputValues.get("boards").get("value");
getResponse = invokeurl
[
url :"https://connect.zoho.com/pulse/api/boardSections"
type :GET
parameters:{"scopeID":networkID,"boardId":boardId}
connection:"" // Give your connection name
];
getSections = getResponse.get("boardSections").get("sections");
sectionOptions = List();
for each section in getSections
{
sectionList = Map();
sectionList.put("label",section.get("name"));
sectionList.put("value",section.get("id").toString());
sectionOptions.add(sectionList);
}
getMembers = getResponse.get("boardSections").get("members");
if(getMembers.isempty() == false)
{
boardMembers = List();
for each member in getMembers
{
memberList = Map();
memberList.put("label",member.get("name"));
memberList.put("value",member.get("zuid"));
boardMembers.add(memberList);
}
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}});
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}});
}
else
{
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}});
}
}
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.

response = Map();
formValues = form.get("values");
scopeID = formValues.get("networks").get("value");
boardId = formValues.get("boards").get("value");
sectionId = formValues.get("sections").get("value");
title = formValues.get("title");
priority_value = formValues.get("priority").get("value");
parameters = {"scopeID":scopeID,"boardId":boardId,"sectionId":sectionId,"title":title,"priority":priority_value};
desc = formValues.get("note");
if(desc != "" && !desc.isEmpty())
{
parameters.put("desc",desc);
}
duedate = formValues.get("duedate");
if(duedate != "" && !duedate.isEmpty())
{
duedate = duedate.toList("-");
eyear = duedate.get(0);
emonth = duedate.get(1);
edate = duedate.get(2);
parameters.put("eyear",eyear);
parameters.put("emonth",emonth);
parameters.put("edate",edate);
}
assignee = formValues.get("members");
if(assignee != {} && !assignee.isEmpty())
{
userIds = list();
for each assgineeID in assignee
{
userIds.add(assgineeID.get("value"));
}
parameters.put("userIds",userIds.toString());
}
addTask = invokeurl
[
url :"https://connect.zoho.com/pulse/api/addTask"
type :POST
parameters:parameters
connection:"" // Give your connection name
];
if(addTask.get("addTask").get("stream").isEmpty() == false)
{
taskTitle = "[" + addTask.get("addTask").get("stream").get("task").get("title") + "](" + addTask.get("addTask").get("stream").get("url") + ")";
taskpriority = addTask.get("addTask").get("stream").get("task").get("priority");
tasksection = addTask.get("addTask").get("stream").get("task").get("section").get("name");
taskboard = addTask.get("addTask").get("stream").get("partition").get("name");
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}}}}};
}
return response;

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

Sticky Posts
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,
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

Recent Topics
Conditional Email Forwarding
How can I set conditional email forwarding of the users? For example: Mail should be forwarded to a address only if it comes from a particular sender. So, I want such email forwarding, which forwards mails based on particular conditions, like the incoming
Why am I seeing deleted records in Zoho Analytics syncing with Zoho CRM?
I have done a data sync between Zoho CRM and Zoho Analytics, and the recycle bin is empty. Why do I see deleted leads/deals/contacts in Zoho Analytics if it doesn't exist in Zoho CRM? How can I solve this problem? Thanks
Enhancements to Zoho Map integration tasks
Hello everyone, We're excited to announce enhancements to the Zoho Map integration tasks in Deluge, which will boost its performance. This post will walk you through the upcoming changes, explain why we're making them, and detail the steps you need to
Let’s Talk Recruit: Meet Zia, your all-in-one AI assistant (Part-3)
Welcome back to the Let’s Talk Recruit series. In the part 2 post, we explored how Zia has evolved with smarter summaries and seamless AI-assisted content creation. This time, we’re diving into the latest upgrades that take productivity even further —
Announcing Early Access to "Zoho CRM for Everyone" — A new and exciting update to Zoho CRM
Update : Zoho CRM For Everyone's Nextgen Interface gets an upgrade! Hello everyone, We’ve updated the Zoho CRM for Everyone Nextgen interface based on your feedback. The UI is now simpler with a unified sidebar, a more visible global search and features
Problem with signature on zoho survey
Hello, I'm trying to export individual responses with signatures on zoho survey. But the signatures on some of my surveys are not exported as the original image, but as a generic image, same for all (screen joins). Is there a solution to have the signatures
Unable to verify domain for Zoho People
I have added TXT records in my DNS (GoDaddy) [screenshot attached], but unable to verify even after 12 hours after adding. On checking the console, it shows some errors [screenshot attached]. It appears that the verification flow is broken - please provide
Zoho Invoice Now Supports VeriFactu for Businesses in Spain
Starting from January 1, 2026, Spain requires real-time invoice reporting for all B2B transactions. From July 2026, this requirement will extend to B2C transactions as well. All reporting must be carried out through the VeriFactu to AEAT (Agencia Estatal
Zoho Billing Now Supports VeriFactu for Businesses in Spain
Starting from January 1, 2026, Spain requires real-time invoice reporting for all B2B transactions. From July 2026, this requirement will extend to B2C transactions as well. All reporting must be carried out through the VeriFactu to AEAT (Agencia Estatal
Weekly Tips : Make your email content error free with Spell check in Zoho Mail
As someone who writes multiple emails a day, we are bound to make both grammatical and spelling errors. Most of them we may not even notice, and even if we do, we may not have the time to correct each one individually when we are in a hurry. So how do
Introducing Enhanced Storage Management
We’re excited to roll out two new enhancements in Zoho Recruit, Subscription Information and Storage Management — designed to give admins complete visibility into subscription details, feature limits, and storage consumption — all from one place inside
How to add Product Add-Ons, Mandatory Forms, and Auto-Save Address in Zoho Commerce
Hi all, I need help setting up several behaviors in Zoho Commerce. I can’t find the correct configuration options, so I want to confirm whether these are supported or if there is a workaround. 1. Product-Specific Add-Ons (Example: GWB Subscription) When
how to download all my files
We are in the middle of zoho docs to zoho workdrive migration. I can not access my zoho docs page. I get redirected immediately to a zoho workdrive page. I would like to download all my files so that I have a backup in case something goes wrong with the
Convert Zoho Books SalesOrder - Invoice
Converting a Zoho Books Sales Order into an Invoice Using the SalesOrder Convert API Hello Zoho Developers, Today, we are sharing a simple and effective solution to convert a Zoho Books Sales Order into a Zoho Books Invoice using the SalesOrder Convert
Zoho Expense - Report Templates
Hi Expense Team, I do a recurring trip once every week which has the same cost: Per diem Milage Toll Payment It would be great if there was a feature which allowed me to clone a previously submitted report or create a template reports. This would save
How to add tabular data when execute Add Record API
Hi everyone! I was send api updateRecord follow by this request url : https://people.zoho.com/people/api/forms/json/<formLinkName>/updateRecord with parameters "inputData", "tabularData", "recordId". Ex picture below And response success: But. When I
Tip #51- Centralized Contact Management for Better Remote Support- 'Insider Insights'
For our final topic of November, we’re diving into one of the most helpful features in Zoho Assist, the Contacts section on Zoho Assist;s dashboard. Whether you’re managing multiple clients, tracking past sessions, or simply looking to streamline your
Using gift vouchers
We would like to be able to offer a limited number of gift vouchers, of varying values, to our customers, and are looking for the best way to do this. We have looked at Coupons and Gift Certificates, but neither seem to fit the bill perfectly. Coupons:
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
Say Hello to Telephony in Zoho FSM
Zoho FSM now brings complete telephony support so your team can manage inbound and outbound calls without switching tabs. Faster responses, smarter routing, and total call visibility—all in one place. Choose the telephony setup that works for you Zoho’s
Zoho Sign - Zoho CRM extension upgrade
Hi everyone, We've updated Zoho Sign extension for Zoho CRM with significant internal changes. Impact on existing Zoho Sign extension users Users using the extension without customization If you are using the integration without implementing Zoho Sign's
Sent mail sort by date disappeared
Hello, We used to be able to sort the emails by date in the sent folder, but this feature has recently disappeared. Can we bring it back?
E-Invoicing in Belgium with Zoho Inventory
Starting January 1, 2026, Belgium is introducing mandatory electronic invoices (e-invoicing) for all B2B transactions between VAT-registered businesses. Invoices and credits notes must be exchanged in a prescribed digital format. How E-Invoicing Works
Employee ID is not correct in get records api V2 for leave
Hi Team, We are facing an issue when calling the Get Records API V2. The employee.id returned in the response is not the actual employee record ID in Zoho People. As a result, our integration is forced to make an additional Get Record API call for every
Formatting Mailing Labels
I want to use the "Print Mailing Labels" function on the drop down list, but I am not seeing a way to change the formatting on the mailing labels. At the moment, the information that appears on the mailing labels ARE NOT mailing addresses, but random
Zoho People. Updating TabularData
I am trying to update tabular data in the record. I always have the same response. I have checked many times. Section ID is correct. May be something wrong with request structure itself. Can someone help me. Body content type: form urlencoded query params
Canvas View - Print
What is the best way to accomplish a print to PDF of the canvas view? Latest update (27th November 2025): We are excited to announce that the Canvas Print View is now available! We encourage you all to try it out and share your feedback with us. Learn
New to automation - please help
Hi there! We are new to automations in Zoho. We built out one automation campaign and it seems to be firing off for some people but others not. Please advise what's the best practice or if anything we should tweak. Thank you so much!
E-Invoicing in Belgium with Zoho Billing
Starting January 1, 2026, Belgium is introducing mandatory electronic invoices (e-invoicing) for all B2B transactions between VAT-registered businesses. Invoices and credits notes must be exchanged in a prescribed digital format. How E-Invoicing works
Zia Conversation Summary: Context at a glance for every customer interaction
Hello everyone! Every customer conversation tells a story—but in CRM, that story is rarely in one place. A sales rep moving between multiple leads has to reopen long email threads, check call remarks, and revisit meeting notes just to remember what was
How to update Multi File upload field
Assume that i have a multi file upload field,how can i update the same field again?
How to set a fixed width of column/cells
Is there a way to set a 'fixed' width for cells in zoho sheet? I know how to adjust the size of the colums.... but after I past a large block of text into a cell, it expands the cell size again. (yes, I have turned off word wrap) How can I set a fixed width so the cells don't change size each time I add data to a cell? Thanks.
Cliq iOS can't see shared screen
Hello, I had this morning a video call with a colleague. She is using Cliq Desktop MacOS and wanted to share her screen with me. I'm on iPad. I noticed, while she shared her screen, I could only see her video, but not the shared screen... Does Cliq iOS is able to display shared screen, or is it somewhere else to be found ? Regards
Workdrive Oauth2 Token Isn't Refreshing
I have set up oauth for a bunch of zoho apis and have never had a problem with oauth. With workdrive i am using the exact same template i usually use for the other zoho apps and it is not working. All requests will work for the first hour then stops so
Adding Reports to Portals
Is there a way to add Reports to portals so only the user can see report templates relevant to them?
Single Portal for Multiple Apps
Hello, I'm just getting started with Zoho and I'm very overwhelmed. I am currently using the free trial of Zoho One, but if I can figure it out, I intend to upgrade to the paid version. Zoho One, of course, gives me access to an entire suite of services/applications. One of the things I'd like to do is have a single place for clients (customers?) to log in and view current projects, invoices, contact information, etc. A single login for my clients. A single portal. I've come across documentation
【開催報告】大阪ユーザー交流会 2025/11/20（木）Zoho CRM Plus 活用のアイデアとデータの“見える化”
皆さま、こんにちは。コミュニティチームの中野です。 11/20（木）に、大阪ユーザー交流会を開催しました。本投稿では、その様子をお届けします。当日の登壇資料などもこちらに共有しますので、参加できなかった皆さまもご参照ください。（Zoho 社員セッションの登壇資料については、11/28(金)に開催予定の東京回の開催報告で共有いたします）今年2回目の開催となる大阪ユーザー交流会では、株式会社KDDIウェブコミュニケーションズ山田さんによる Zoho CRM Plus の事例セッションのほか、「Zoho
Every rating counts: Shaping customer experience
We are back to that beautiful time of the year. It is the season to reflect, be thankful, and appreciate everything that has happened throughout the year. Thanksgiving is a time we connect with our family, friends, and relatives to strengthen relationships,
Paging through API results. a major gap in your documentation.
There is no way for me. to get all of my data through a single API call. Typically REST APis have mechanisms for paging through API results. But the documentation for the API I am using: https://desk.zoho.com/DeskAPIDocument#Introduction Has no mention
How to remove duplicate contacts
Next Page

Convert a message on Cliq into a task on Zoho Connect

Convert a message on Cliq into a task on Zoho Connect

Topic Participants

Manasa Manogaran

gilbert

ROHIT MATHEW

Mischa

Shivam mishra

Sticky Posts

Customer payment alerts in Zoho Cliq

Automating Employee Birthday Notifications in Zoho Cliq

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

App Spotlight : PagerDuty for Zoho Cliq

Automate your status with Cliq Schedulers

Recent Topics

Conditional Email Forwarding

Why am I seeing deleted records in Zoho Analytics syncing with Zoho CRM?

Enhancements to Zoho Map integration tasks

Let’s Talk Recruit: Meet Zia, your all-in-one AI assistant (Part-3)

Announcing Early Access to "Zoho CRM for Everyone" — A new and exciting update to Zoho CRM

Problem with signature on zoho survey

Unable to verify domain for Zoho People

Zoho Invoice Now Supports VeriFactu for Businesses in Spain

Zoho Billing Now Supports VeriFactu for Businesses in Spain

Weekly Tips : Make your email content error free with Spell check in Zoho Mail

Introducing Enhanced Storage Management

How to add Product Add-Ons, Mandatory Forms, and Auto-Save Address in Zoho Commerce

how to download all my files

Convert Zoho Books SalesOrder - Invoice

Zoho Expense - Report Templates

How to add tabular data when execute Add Record API

Tip #51- Centralized Contact Management for Better Remote Support- 'Insider Insights'

Using gift vouchers

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

Say Hello to Telephony in Zoho FSM

Zoho Sign - Zoho CRM extension upgrade

Sent mail sort by date disappeared

E-Invoicing in Belgium with Zoho Inventory

Employee ID is not correct in get records api V2 for leave

Formatting Mailing Labels

Zoho People. Updating TabularData

Canvas View - Print

New to automation - please help

E-Invoicing in Belgium with Zoho Billing

Zia Conversation Summary: Context at a glance for every customer interaction

How to update Multi File upload field

How to set a fixed width of column/cells

Cliq iOS can't see shared screen

Workdrive Oauth2 Token Isn't Refreshing

Adding Reports to Portals

Single Portal for Multiple Apps

【開催報告】 大阪 ユーザー交流会 2025/11/20（木）Zoho CRM Plus 活用のアイデアとデータの“見える化”

Every rating counts: Shaping customer experience

Paging through API results. a major gap in your documentation.

How to remove duplicate contacts

Next Page

【開催報告】大阪ユーザー交流会 2025/11/20（木）Zoho CRM Plus 活用のアイデアとデータの“見える化”