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
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
Connections in Cliq: https://www.zoho.com/cliq/help/platform/connections.html
Access your files securely from anywhere
New to Zoho Recruit?
Zoho Developer Community
New to Zoho LandingPage?
Zoho LandingPage Resources
New to Zoho Survey?
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Bigin?
Topic Participants
Manasa Manogaran
gilbert
ROHIT MATHEW
Mischa
Shivam mishra
Sticky Posts
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. ShareAutomating 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 ofApp 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 operationalAutomate 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 "quickBulk 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
New to Zoho TeamInbox?
Zoho TeamInbox Resources
Zoho CRM Plus Resources
Zoho Books Resources
Zoho Subscriptions Resources
Zoho Projects Resources
Zoho Sprints Resources
Qntrl Resources
Zoho Creator Resources
Zoho CRM Resources
Design. Discuss. Deliver.
Zoho Show Resources
Get Started. Write Away!
Writer is a powerful online word processor, designed for collaborative work.
Zoho CRM コンテンツ
-
オンラインヘルプ
-
Webセミナー
-
機能活用動画
-
よくある質問
-
Ebook
-
-
Zoho Campaigns
- Zoho サービスのWebセミナー
その他のサービス コンテンツ
Nederlandse Hulpbronnen
ご検討中の方
Recent Topics
Zoho CommunitySpacesとzoho CRM連携について
お世話になっております。 いつもご質問に丁寧に回答いただき大変助かっております。 今、当団体ではZoho CommunitySpacesを利用しており、利用ユーザ一覧をzoho CRMに自動登録（連携）したいと考えております。 そもそも可能なのか、もしあれば具体的な手順や方法はあるのかをご教授いただきたいです。 上記がないのなら、ユーザ一覧のエクスポート方法（メールアドレスと姓を含む）でもよいです。 お手数となりますが、お願いいたします。Zoho Wiki or new Zoho Learn
We are currently evaluating if we should move off confluence. At present in Confluence we have multiple levels within our documentation but with learn it looks like you can only have Space - Manual - Chapter Is it possible to have levels below Chapter? Also the same question for the existing wiki, can I have more sub-levels?Custom "create meeting" button with more functionality than Zoho currently has?
I'm looking for a little help/direction in how to do this. Even just some general high level pointers on how this might be able to be done. The current Zoho Meeting Activity functionality is not ideal for my org's workflow. I'd like to try and createValidation Rule for Controlled Stage Movement in Deals Module (Deluge Script)
For keeping a control over module stage or status, you can use the below deluge script. The below deluge script defines validation control over deals module stages: // Function to validate allowed stage transitions in the Deals module map validation_rule.LeadStatustValidation1(StringCannot categorize a bank deposit to an income sub-account
When I go to categorize a bank deposit, I am not able to see any income sub-accounts. If I set up an income account without a parent, then I am able to categorize a transaction into that account, but as soon as I make it a child account, it disappearsIs there a way to request a password?
We add customers info into the vaults and I wanted to see if we could do some sort of "file request" like how dropbox offers with files. It would be awesome if a customer could go to a link and input a "title, username, password, url" all securely and it then shows up in our team vault or something. Not sure if that is safe, but it's the best I can think of to be semi scalable and obviously better than sending emails. I am open to another idea, just thought this would be a great feature. Thanks,Sales without an invoice
Sales without an invoice is not included on the “payments received” report. Also, sales without an invoice is not listed in the transactions under the customer’s profile, also making it easy to do a double entry. Is there a way for me to see my salesZoho Sign API - Create a document from template.
1. I would like to create a document from a template and send the document to the customer for signing. Is this possible using the Zoho Sign API? If so, please share the api reference link. 2. Is there sand box for Zoho Sign to test the APIs without usingZoho Sign embedded iframe
Hello, we are looking for any of these options: a) some iframe that we can paste into our website for every signer, for onpage signing document. b) or get direct link for signers from Zoho sign API which we can redirect manually. Is any of these optionsWriting by Hand in "Write" Notes
Hi there! I just downloaded this app a few moments ago, and I was wondering if there was a way to write things by hand in "Write" mode instead of just typing in the keyboard. It would make things a bit more efficient for me in this moment. Thanks!Goods in transit
When creating a purchase order in Zoho Books, how can I properly reflect the inventory as "Goods in Transit" until it reaches its final destination?how to coming soon, holding site, or "under construction"
Hi! I was wandering if was possible to create a website with the simple sign of "Under construction or coming soon" while i work on the site. if possible, how? CheersAnnouncing Agentic AI - Ask Zia!
We are delighted to roll out the new agentic AI capabilities in Ask Zia, where every stage of the BI workflow is assisted by AI. With a human-in-the-loop approach, Ask Zia ensures that you’re in command of the decision, while AI handles the complexity.Kaizen #197: Frequently Asked Questions on GraphQL APIs
🎊 Nearing 200th Kaizen Post – We want to hear from you! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.Meeting integration with Otter.ai
Would love for an integration with an AI transcription service like Otter.ai to be integrated with Zoho Meeting. ThanksYodlee Bank Feeds
I'm well aware of the many bank feed issues out there that haven't been resolved, but I'm looking for information on Rules in relation to bank feeds. U.S based, Bank of America user and prior to Yodlee all of my banking feeds and Rules worked seamlessly.Zoho People LMS VS Zoho Connect Manuals VS Zoho Learn
in the past I came accross Zoho WIKI but did not like the platform because it could use a lot of upgrade. Over the time I have noticed Zoho People come out with a LMS module which allows us to created a shared knowledge for our internal team I also came across Zoho Connect which as a knowledge-based for internal team referred to as Manual Now I am seeing Zoho Learn which is a new and fine-tuned version of Zoho Wiki. All of these platforms are very similar but I am wondering what are the differencesDiscussion for “sub product”, “sub item” or “child products”
Hello everyone, In some CRM systems, there is the ability to associate products in a hierarchical manner within a quote. For example: Product A: Gold Plan Product B: Setup Product C: Connector Product D: Silver Plan Product B: Setup Product C: ConnectorMarketing Automation Activities in Zoho CRM
Hello, I've connected Zoho CRM and Marketing Automation, sent a campaign, but no data are displayed in CRM, neither in "campaigns" section inside contact profile. It is possible to display Marketing Automation activities in CRM? Also in CRM Timelines?Integrate with Power BI
Hi, How to connect Zoho CRM dashboards & reports with POWER BI ?Error Code 4: Invalid value passed for JSONString
Okay, I want to start by saying I know I'm a terrible scripter, so sorry if this is a dumb mistake. I just can't figure it out, even with LLM help. Here's my code: // --- Input Variables --- customer_id = salesorder.get("customer_id"); so_id = salesorder.get("salesorder_id");How do we get a follow up to Experts 22: Scale up your customer support with integrations & extensibility
Hi, How do we get a followup and answers to the questions we have asked during 'Experts 22: Scale up your customer support with integrations & extensibility'. I have repsonded to the answers but have no way of following up. Thanks BrettFrustrating Email Duplication and Timeline Issues Between Zoho Mail and CRM
Hi Zoho team, Can someone please help clarify what’s going on here? Here’s what’s happening: I initiate an email to a lead using Zoho Mail. The lead is created in Zoho CRM via the integration, and the email is correctly associated with that lead. Sometimes,Best Strategy to import contacts and when to create leads
Hi, I'm new to Bigin and looking for a "best" strategy. I had and have the following idea for an use case: 1. Search for websites which I want to contact 2. Create a contact in Bigin with all the required information based on this website (via API ifBetter implementation of Item Category on Invoices and Estimates
1) I have added Item Category as a custom field. Honestly, this should be a native part of the item itself, and either required, optional, or not used. 2) When entering an item on an invoice, you have to enter the first character(s) of the item, otherwiseItem Level Notifications
I need to create a custom workflow based on the creation of an estimate that has a SKU/Item name that matches certain criteria. I can have it generated based on a total amount, but not at the item level. Is this possible?Bulk Update (via the 'Accountant' menu)
Why can't we bulk update Expenses to Owner's Drawings? It always ends in failure with the error "Involved account types are not applicable". If such conversion isn't possible, why make the option available? Better to allow it though.Set Reply_to parameter for "Email an Invoice" API Endpoint
Is there a way to set "Reply To" email address when using the Email an invoice API endpoint? It doesn't seem to be in documentation, but sometimes there are undocumented parameters. If it doesn't exist, please consider adding it as parameter since allZoho Books adaptado a la legislación española. ¿Sustitutos?
Buenas a tod@s No tenemos información sobre la adaptación de Zoho Books a la nueva ley de facturación en España. Me preguntan usuarios de zoho que deberían hacer. Propongo una lista de alternativas, si al final se opta por no desarrollar la funcionalidadSending gmail to a particular person fails because the address gets changed to "gmaill", with a second "l" typo somewhere
I send to bob@gmail.com (example) and get an error sending to bob@gmaill.com, only for this one person. Note the extra "l" in the email the system tried to send to, which was not in the address I entered. Can't find a typo in the contact or anywhere elseA Question about Email Handling (Sending and Receiving)
Hello! I was looking into setting up Email Aliases for my domain that I purchased a while ago through Zoho Mail. I set up a singular alias already and have it linked with Gmail, and it seems to be working out well. However, I set up another alias today,How to Invoice Based on Timesheet Hours Logged on a Zoho FSM Work Order
Hi everyone, We’re working on optimizing our invoicing process in Zoho FSM, and we’ve run into a bit of a roadblock. Here’s our goal: We want to invoice based on the actual number of hours logged by our technicians on a job, specifically using the timesheetsFinding "like" projects
Hi Everyone! My team is running into several duplicating deals. I've been trying to get them all to name things the same way ex. State is 2 letters not spelled out. Things like that. What I am wondering if there is anything I can do as the superadminKaizen #201 - Webhooks, Functions, and Schedules
Hello everyone! Welcome back to another post in the Kaizen series! We are incredibly grateful for all the feedback we received, and as promised, we will answer all the queries in this Kaizen series. Last week, in our 200th post, we addressed one of theEstimates and invoices being sent from company-wide address, rather than individual
In our organization, team members send estimates and invoices through Zoho Books by using the "Send Email" function. However, for certain users, the system defaults to sending estimates and invoices from a shared organizational email address (e.g., company@example.com)Display multiple fields in lookup dropdown
I have a module called Technicians and a related module called submissions that registers technicians for different assignments. The lookup in Submissions to Technicians is the Technician ID (auto generated unique number). How do I display in the dropdownAgent name Alias
I am seeing that Full name of my staffs are written on every ticket response which is not good for some reasons. It is possible to user like this: Manny P. (First Name with Last Name's First Letter) or Manny (First Name) This is want we want to showRetrieve Accidental Deleted User
Is there a way to undelete a user who accidentally deleted themselves?Scan & Fill with double quote key/value pairs
Hi, An old Ticket moved to a Topic/Idea: I love the idea of the new Scan & Fill as it nearly covers my previous request for a QR Scanner to read a multi-part QR Code. My QR Codes are hard-coded as below: {"key1":"value1","key2":"value2","key3":"value3"}Zoho Projects Strict Dates for Tasks
Hi Zoho Projects team, I would love to see a feature to allow Strict Dates for Tasks. Sometimes in projects you have dates which must not move, even if predecessor Task dates change. For example, perhaps you need to book access to a facility to performNext Page