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

• 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

• Cliq Bots - Post message to a bot using the command line!

  If you had read our post on how to post a message to a channel in a simple one-line command, then this sure is a piece of cake for you guys! For those of you, who are reading this for the first time, don't worry! Just read on. This post is all about how

• Cliq Bots - How to make a bot respond to your messages?

  Bots are just like your buddies with whom you can interact. They carry out your tasks, keep you notified about your to-dos and come in handy when you need constant updates from a third party application.  So, how can you make your bot respond to a message? The bot message handler is a piece of code triggered when a message is sent to the bot. Message handlers help you customise your bot responses to make it look conversational. The message input from the user can be either a string or an option selected

• Cliq Bots - Get notifications about any action on an application with the incoming webhook handler!

  Webhooks can be used to get notified about events happening in other applications inside Cliq. All bots in Cliq have their own incoming webhook endpoint. This makes it simple to post messages to the bot from external applications. Unlike the send message

• Recent Topics

• [Zoho Writer Webinar] Working with tables in Zoho Writer

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for the month of September 2023: Working with tables. This webinar will help you understand the various ways you can use tables to meet your specific needs. The webinar will take

• [Zoho Writer Webinar] Customize Writer to suit your business process

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for the month of August 2023: Customize Writer to suit your business process. This webinar will cover the various ways to customize Writer to streamline business processes and improve

• Is there a way to print the dashboard?

  I would like the capability of printing the dashboard - is that possible?

• Workflows for Timesheet

  Good day, Any way to have timesheet as triggers? I looked into Zoho Flow and into Zoho Project automation but no where can I have timesheet as a trigger. Basically, I would like to trigger something upon timesheet approval. Right now, the only way to

• Linkedin - Recruiter System Connect

  Hi there! Does anyone here know how to connect Zoho Recruit to Linkedin Recruiter via Recruiter System Connect?

• [Webinar] A recap of Zoho Writer in 2024

  Hi Zoho Writer users, We're excited to announce Zoho Writer's webinar for December 2024: A recap of Zoho Writer in 2024. This webinar will provide a recap of the features, enhancements, and integrations released in 2024 to enhance your productivity. There

• Learn how to automate IT asset and incident management with Zoho Writer

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for November 2024: Learn how to use Zoho Writer's fillable forms for IT asset and incident management. This webinar will focus on how Zoho Writer can help you automate your organization's

• [Webinar] Learn how Zoho Writer can streamline your finance and admin operations

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for October 2024: Streamlining finance and admin operations with Zoho Writer. This webinar will focus on how Zoho Writer can help you generate payslips and automate claim processes.

• [Zoho Writer Webinar] Learn how Zoho Writer can enhance the productivity of sales teams

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for August 2024: Streamlining sales operations with Zoho Writer. This webinar will focus on how Zoho Writer can help you create sales documents and automate sales routines. There

• [Zoho Writer Webinar] Learn how to simplify your HR operations: Part 2

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for July 2024: Learn how Zoho Writer can simplify your HR operations: Part 2. This webinar will focus on how Zoho Writer can help HR teams streamline and automate their entire hiring

• [Zoho Writer Webinar] Learn how to simplify your day-to-day HR operations

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for June 2024: Learn how Zoho Writer can simplify your day-to-day HR operations. This webinar will focus on how to automate your entire hiring process and generate various types of

• [Zoho Writer Webinar] Use formulas and conditions in Zoho Writer's document automation

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for May 2024: Learn how to use formulas and conditions in Zoho Writer. This webinar will focus on how to use formulas and conditions when automating document generation in Zoho Writer.

• [Zoho Writer Webinar] Personalize Zoho Writer to suit your needs

  Hi Zoho Writer users, We're excited to announce the Zoho Writer webinar for April 2024: Learn how to personalize Zoho Writer to suit your needs. This webinar will focus on how to easily customize Writer's features at the user and organization level for

• How to refresh/update module fields in

  Hi, I created a Workspace for CRM years ago. Since that time I've updated the layouts in several modules in CRM but Zoho Analytics displays the previous state fields only. How to refresh the module fields to reflect the actual state in Analytics? BR

• Data update/pull from a specific field or module

  Hi Team, Currently, if I need a data from a newly added field on a product like Zoho CRM, I need to refresh the whole module to get the new field. This is taking much time for the data to be visible. If the data pull/refresh can be granularized to fetch

• Lookup field in User module cannot look up to custom modules!

  Hi there, Expense has been great so far but it's sad to see that a simple thing such as allowing a lookup to custom modules from the Users module is not yet implemented. Hope to see this in the next release. Do you have any plan for that?

• Trigger Zoho Cliq Channel Workflows for API Messages

  Dear Zoho Cliq Team, I hope this message finds you well. We have noticed that reminders or messages posted to Zoho Cliq channels via the API do not trigger channel-based workflows. This limitation means that any bot configured with a participation handler

• Webhook Trigger for New Messages in Cliq Channels

  Hello, I would like to request a feature to enable webhook triggers when a new message is added to a Cliq channel. This functionality would allow us to seamlessly send important information from Cliq to other relevant systems. This webhook trigger can

• Ability to Edit the "Current Job Title" dropdown field

  Current experience/Issue: When a user (candidate) uploads resume to Zoho Recruit candidate portal, some fields are prefilled with the info from the resume/cv correctly. However, we've observed that; 1. the "Current Job Title" dropdown field is usually

• I'm getting an "Invalid_scope" error, even though I used an access token generated with the correct scope.

  I'm getting an "Invalid_scope" error, even though I used an access token generated with the correct scope. Here’s what I did in Postman: Generated the code to create an access token using the following URL: https://accounts.zoho.eu/oauth/v2/auth?scope=ZohoCampaigns.contact.UPDATE&client_id=<client_id>&response_type=code&access_type=offline&redirect_uri=https://1882-2-26-193-161.ngrok-free.app

• Problem viewing document imported from google drive.

  Hello, When I add a document via my google drive, it is impossible to preview it. I get the error “Files without extensions cannot be previewed. Download to view this file”. Could you please help me? Also, and this is more of a question: is there a way

• Problem configuring/customizing sales pipeline steps

  Hello, I have created several sales pipelines with different stages in them. Unfortunately I forgot to properly configure these steps (conversion probability, forecast category). How can I modify and customize all these steps? Thnak you by advance M

• workflow for bounced email gets triggered, but email is status = opened

  Hello, I have a workflow that sends me an email if outgoing email are bounced. Now I got some kind of this emails, but the corrosponding contacts have status = open at the email. Why this bounce-workflow is triggered? Reports > Email Reports > Bounce

• Power of Automation :: Automatically start / pause / stop timer on task status update.

  Hello Everyone, A Custom function is a user-written set of code to achieve a specific requirement. Set the required conditions needed as when to trigger using the Workflow rules (be it Tasks / Project) and associate the custom function to it. Requirement:-

• Website Access Blocked (from one pc only) when attempting unattended access to any device

  Hello From one of my laptops I cannot access any remote device using unattended access. A Zoho Assist error page didplays 'Website Access Blocked. See attached.

• Zoho sheets to crm and mapping

  i want to know more about mapping the contacts that i upload from the spreadsheet also couldnt able to understand flow

• Zoho Analytics to Zoho Sheets - automatic update?

  Hi all, If I create a zoho sheet from an Analytics Report or Analytics Data, is there a way for the zoho sheet to automatically update as the Report / Data in analytics updates?

• Update Zoho Flow on Sprint Work Item Status Change

  Hello, I've contacted Zoho One support but have been unable to help in a timely manner, so I'm asking the community. I want to start using sprints, but I'm having an issue. I need to post updates to Slack when a Work Item has a status change. My understanding

• Fixed Assets Register

  Thank you Zoho Books for adding fixed assets register. BUT there are certian tweeks that needs to be implemented. I found the following issues and seek improvements. 1) Fixed Asset Register Report in the Report Section has columns which are so much confusing.

• Why can't I sync my Zoho Mail tasks and notes with my mobile device, and is there a way to fix this issue?

  I'm having trouble syncing my Zoho Mail tasks and notes with my mobile device. Despite following the usual steps, the tasks and notes don't appear on my phone. Is there a way to fix this issue? Regards, Adamjes, Tekskills India Pvt Limited, India.

• Link to Desk tickets

  Hello, We are using Analytics to analyze data in Desk. Is there a way to embed a link to a ticket in reports? We'd love to be able to see the drill down data, and click a value in a result row that would launch the Desk Ticket in another window/tab. Thanks

• Announcing new features in Trident for macOS (v.1.11.0)

  Hello everyone! Trident for macOS (v.1.11.0) is here with interesting features and enhancements to elevate your workplace communication and productivity. Let's take a quick look at them. Export emails. You can now export emails in the .eml file format

• Zoho Sign Product updates - H2 2024

  Hello! We have almost come to the end of 2024! Here's a list of features and enhancements that went live in the later half of the year. NOM 151 certification Witness signing Formula, conditional, and custom fields Zoho Sign's extension for Bigin by Zoho

• Build custom AI solutions with Catalyst’s QuickML capabilities in CRM

  Hello everyone, We’re thrilled to announce an improvement for our Zoho CRM Enterprise users: the ability to create custom AI solutions using Catalyst’s QuickML directly from Zoho CRM. As you may already know, Zia, Zoho CRM’s AI-powered assistant, offers

• 【Zoho CRM】Webフォームに関するアップデート

  ユーザーの皆さま、こんにちは。コミュニティチームの中野です。 「Zoho CRM アップデート情報」の中からWebフォームに関するアップデートについて紹介します。 今回、以下２点のアップデートがありました。 ダブルオプトイン（2段階の同意確認）後の確認メッセージのカスタマイズ 登録から確認まで一貫したユーザーエクスペリエンスを顧客に提供するために、カスタマイズされた確認メッセージを作成できるようになりました。 ダブルオプトイン認証メールのカスタマイズ 顧客に最初から興味を持ってもらえるよう、パーソナライズされたメールを作成できるようになりました。ユーザーのブランドに合った本文を作成し、パーソナライズすることで、様々な顧客に対応することができます。

• Converting Time and Time Zones

  Hi Everyone I am trying to convert a time Zone to the local time of the user. I am fetching some data from an API, and it is coming back in this format: 2024-12-09T16:49:23Z This is in UTC/GMTZulu time. I am looking to convert it to the user time. In

• Tip of the week 34 - 5 ways to maintain your email list

  A proper email list often reflects the reach of an institution. This reach is coveted by all but achieved by some. We often forget about drawbacks and incline towards numbers. Success is often reflected by quality and not quantity. This simple message reverberates in maintaining a hygienic email list. Here are five tips which will help you maintain a proper email list.    Organic email lists   Non-stop competition can make us susceptible to shortcuts like buying and renting lists from third party

• Whatsapp Limitation Questions

  Good day, I would like to find out about the functionality or possibility of all the below points within the Zoho/WhatsApp integration. Will WhatsApp buttons ever be possible in the future? Will WhatsApp Re-directs to different users be possible based

• Can not send campaign

  Hi, I'm trying to send a newsletter to my subscribers, but seems is not working - or maybe I did some wrong steps re. upgrades. I'm the admin for this account, no other person is using Zoho for my campaigns and I did not access the platform during last

• Multilingual Newsletter

  Hi, Can Zoho campaign give the possibility to create and send a campaign in English and French, giving the possibility to the person receiving it to switch from default language chosen for a campaign? thnaks

• Next Page