Cliq Bots - How to involve bots in your conversation and increase productivity?

Cliq Bots - How to involve bots in your conversation and increase productivity?

Cliq bots share a few similarities to Cliq users; that is all bots have a profile where you can set their display pictures, a status and can be mentioned in a conversation too! Just typing ' @ ' followed by the bot name will mention the bot in a conversation. We're drawing this analogy here to convey the idea behind a bot's mention handler. This handler is prompted to act when a bot is mentioned by a user in a conversation. 

What happens when you mention a bot?
 
The handler will enable the bot to perform an action it is programmed to do so. During this execution, the bot handler receives a list of attributes. Learn more about these attributes in the bot mention handler help page

For example, " @geekbot give me some interesting fact!" 

The bot response would look something like this - "Did you know? The character Mario from the video game Mario Bros is best known as a plumber. But he originally debuted as a carpenter in the game Donkey Kong." 

The geekbot's mention handler is triggered to respond to the conversation with an interesting fact. How? The bot identifies the keywords to give an appropriate answer if the keywords do not match, then you don't get a fact. As simple as that!

Sample Scenario Illustration 

Let us try to build a bot for the support team of an organization. A typical work day for any support executive will consist of handling multiple chats and replying to tons of emails. How can a bot be helpful as an assistant here? When a support agent is trying to discuss a request raised by a customer, the agent simply @mentions the TicketBot to get details about this ticket. The bot posts the response in a message card in the same conversation for everybody to see!

The TicketBot 's mention handler code is shown below. Take a look!

  1. response = Map();
  2. userinput = message;
  3. if(userinput.containsIgnoreCase("#"))
  4. {
  5. ticketID = userinput.subString(userinput.indexOf("#"));
  6. id = ticketID.subString(0,ticketID.indexOf(" "));
  7. ticket = zoho.support.searchRecords("Requests","Zylker","ZylCal","Request Id",id,1,10,"desk","true");
  8. if (ticket.size() > 0)
  9. {
  10. response = {"text":"Details for the ticket " + id,"card":{"theme":"modern-inline"},"slides":{{"type":"label","data":{{"Ticket Status":ticket.toMap().get("Status")},{"Contact Name":ticket.toMap().get("Contact Name")},{"Contact Email":ticket.toMap().get("Email")},{"View More Details":"[Take me to desk!](https://desk.zoho.com" + ticket.toMap().get('URI') + ")"}}}}};
  11. }
  12. else
  13. {
  14. response = {"text" : "Hey! Looks like the ticket ID is invalid. :neutral:"};
  15. }
  16. }
  17. else
  18. {
  19. response = {"text":"Hi There! \n I can get you the ticket details for any ticket. Just try mentioning me followed by the #ticketID. Just like this: *@salesbot* give me details about *#12345*","card":{"theme":"prompt"}};
  20. }
  21. return response;





Key Points to Note 
  • zoho.support.searchRecords is the deluge task to get a record from Zoho Desk. To learn more about this task refer the searchRecords help page. The format of this deluge task is 
  1. records = zoho.support.searchRecords("<Module_Name>","<Organization_Name>","<Department_Name>","Status","Open",1,10,"<Connection_Link_Name>", User_Access);
  • In the code snippet, ' desk ' is the connection link name, created for Zoho Desk and Zoho Search. If you're looking to create a bot that integrates with other products or within Zoho, then you'll have to create a connection. Learn how to create connections here
  • This code in mention handler is invoked when the bot is mentioned in any conversation. The response is posted in the same conversation by the bot. 
  • To structure the response of the bot as a message card, refer this help page
The bot mention handler is a great way to ask your bot to do custom tasks for you or your team and also to involve your bot in group conversations. So start building your bot mention handler right away!

Comments and suggestions are welcome!
 

Best,
Manasa
Cliq

    Access your files securely from anywhere

        All-in-one knowledge management and training platform for your employees and customers.






                              Zoho Developer Community




                                                    • Desk Community Learning Series


                                                    • Digest


                                                    • Functions


                                                    • Meetups


                                                    • Kbase


                                                    • Resources


                                                    • Glossary


                                                    • Desk Marketplace


                                                    • MVP Corner


                                                    • Word of the Day


                                                    • Ask the Experts



                                                              • Sticky Posts

                                                              • 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
                                                              • Add Claude in Zoho Cliq

                                                                Let’s add a real AI assistant powered by Claude to your workspace this week, that your team can chat with, ask questions, and act on conversations to run AI actions on. This guide walks you through exactly how to do it, step by step, with all the code
                                                              • 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,


                                                              Manage your brands on social media



                                                                    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

                                                                                        • CRM Community Learning Series

                                                                                          CRM Community Learning Series


                                                                                        • Kaizen

                                                                                          Kaizen

                                                                                        • Functions

                                                                                          Functions

                                                                                        • Meetups

                                                                                          Meetups

                                                                                        • Kbase

                                                                                          Kbase

                                                                                        • Resources

                                                                                          Resources

                                                                                        • Digest

                                                                                          Digest

                                                                                        • CRM Marketplace

                                                                                          CRM Marketplace

                                                                                        • MVP Corner

                                                                                          MVP Corner







                                                                                            Design. Discuss. Deliver.

                                                                                            Create visually engaging stories with Zoho Show.

                                                                                            Get Started Now


                                                                                              Zoho Show Resources

                                                                                                Zoho Writer

                                                                                                Get Started. Write Away!

                                                                                                Writer is a powerful online word processor, designed for collaborative work.

                                                                                                  Zoho CRM コンテンツ




                                                                                                    Nederlandse Hulpbronnen


                                                                                                        ご検討中の方




                                                                                                                • Recent Topics

                                                                                                                • Zia Dashboard Insights : turn your dashboard into decisions

                                                                                                                  When you look at a chart or KPI in a dashboard, you would possibly see something like: Revenue: $2.4M ↓ 18% vs last month. It can be a positive growth or a negative one, or a dip in revenue, a spike in deals, a slowdown in renewals—all you usually see
                                                                                                                • Tickets without registration

                                                                                                                  Hi, would it be possible to give customers the opportunity to be able to read their tickets without registration?
                                                                                                                • Zoho Desk Answer Bot vs. Zia Agents – Knowledge Base & Ticket Access

                                                                                                                  Hi everyone, I’m currently evaluating AI options in Zoho Desk and ran into some limitations with the Answer Bot: Answer Bot limitations Only uses Knowledge Base articles No access to tickets Limited control over sources: Either one Help Center or all
                                                                                                                • Como estruturar automações eficientes no Zoho Creator

                                                                                                                  Como estruturar automações eficientes no Zoho Creator Introdução No contexto de aplicações empresariais, automação não é apenas uma conveniência, é um fator crítico para ganho de produtividade, redução de erros e escalabilidade operacional. O Zoho Creator
                                                                                                                • Changing the status of a work-order

                                                                                                                  Is there a way to change the status of a work-order?
                                                                                                                • Trigger workflows from SLA escalations in Zoho Desk?

                                                                                                                  Hey everyone, I’m currently working with SLA escalation rules in Zoho Desk and ran into a limitation that I’m hoping someone here has solved more elegantly. As far as I can tell, SLA escalations only support fairly limited actions (like changing the ticket
                                                                                                                • What is a realistic turnaround time for account review for ZeptoMail?

                                                                                                                  On signing up it said 2-3 business days. I am on business-day 6 and have had zero contact of any kind. No follow-up questions, no approval or decline. Attempts to "leave a message" or use the "Contact Us" form have just vanished without a trace. It still
                                                                                                                • Zia Agents in Zoho CRM: a better way to set up digital employees

                                                                                                                  Hello everyone, If you've been using Zia Agents in Zoho CRM, so far using Connections was the only deployment method you're familiar with. You create an agent in Zia Agents (define its objective, write instructions, use tools, add knowledge base) and
                                                                                                                • Bank Feeds

                                                                                                                  Since Friday my bank feeds wont work. I have refreshed feeds, deactivate and reactivate and nothing is working
                                                                                                                • Logged out

                                                                                                                  Hi, just been working on a sheet when a pop up box appeared telling me I'm going to be logged out in x number of seconds and if I reload I may lose any edits, or words to that effect. It did indeed log me out and I did indeed lose my last edits. Any idea
                                                                                                                • Zoho API

                                                                                                                  I have little experience with API. I'm trying to get a Custom API working with Zoho creator. I have created a Custom API and created an Endpoint URL, but i get a 9400 error code "The provided HTTP method is not valid for this custom API". Based off the
                                                                                                                • #157127950

                                                                                                                  Where did my initial question go?
                                                                                                                • Zoho writer unable to merge documents to PDF with basic fonts in Hebrew or fonts from my computer

                                                                                                                  I created several forms that will be merged into PDF files through Zoho Writer and I am unable to receive the PDF in the basic fonts of the Hebrew language or in the fonts I have on my computer. The writer exports to PDF an exchange font that looks very
                                                                                                                • Create formula calculations in Assemblies for scaling quantities

                                                                                                                  Something we have been encountering with our composite items is dealing with scaling of quantity of one or more items within the composite assembly relative to the number of complete units being sold. I.e. running the equation 2(n-1) on one of the assembly
                                                                                                                • How I Implemented Subscription-Based Access Control and Expiry Handling in Zoho Creator

                                                                                                                  I recently worked on a use case where users come into the application to request a service, but they should only be able to continue the process after completing a subscription. The challenge was not just controlling access, but also making sure that
                                                                                                                • Zoho Forms API

                                                                                                                  Is there any way to get all form entry list using API? Looking forward to hear from you
                                                                                                                • Zoho Projects : Task should auto-update to 'In Progress' if timer started

                                                                                                                  Namaskaram. Right now, if a Task's timer is started, the Task stays in 'Not Started' status. One has to manually update it to 'In Progress'. From a #uxdesign standpoint, it is an unnecessarily two step process to start working on a task. It would be better that, if I start the timer on a task, it should automatically change to 'In Progress' status. Crafted with ❤️ Zoho Gurus | Zoho One Practice Team @ CubeYogi Zoho Authorised Partner | 7+ Yrs | 200+ Projects | 100+ Customers
                                                                                                                • Laatste facturen en betalingen niet zichtbaar in mijn account

                                                                                                                  Wij gebruiken ZOHO invoice al jaren, maar sinds afgelopen week is mijn laatst verzonden factuur niet zichtbaar in mijn account, en tevens de laatst betaalde facturen zie ik niet. Hoe kan dit? Ik heb de pagina al diverse keren gerefreshed.
                                                                                                                • Undelivered Mail uncategorized-bounce errors when sending invoices

                                                                                                                  Recently we have been getting Undelivered Mail bounce notification when sending invoices. Reason: uncategorized-bounce Some go through no problem some bounce back. We recently sent 10 invoices, 6 received bounce notifications. After reaching out to the
                                                                                                                • Option to Delete Chats in IM

                                                                                                                  Currently, there is no option to delete any chats in IM, regardless of their source.
                                                                                                                • CRM x WorkDrive: File storage for new CRM signups is now powered by WorkDrive

                                                                                                                  Availability Editions: All DCs: All Release plan: Released for new signups in all DCs. It will be enabled for existing users in a phased manner in the upcoming months. Help documentation: Documents in Zoho CRM Manage folders in Documents tab Manage files
                                                                                                                • Can I import MSG files into Microsoft 365 without Outlook?

                                                                                                                  Yes, absolutely. You do not need Outlook installed to import MSG files into Microsoft 365. Aryson MSG file Converter is a dedicated tool that eliminates the Outlook dependency entirely, making the migration process simple and efficient for all users.
                                                                                                                • All new Address Field in Zoho CRM: maintain structured and accurate address inputs

                                                                                                                  Availability Update: 29 September 2025: It's currently available for all new sign-ups and for existing Zoho CRM orgs which are in the Professional edition exclusively for IN DC users. 2 March 2026: Available to users in all DCs except US and EU DC. 24
                                                                                                                • Introducing Radio Buttons and Numeric Range Sliders in Zoho CRM

                                                                                                                  Release update: 1. 2 March 2026: Currently out for CN, JP, AU and CA DCs (Free and standard editions). For other DCs, this will be released by mid-March. 2. 26 March 2026: CA, SA, AU, JP, CN DCs - Free, Standard, Professional, Enterprise, Ultimate, CRM
                                                                                                                • Feature Request - A Way To Search Item Groups

                                                                                                                  Hi Inventory Team, I can't find any way to filter or search by fields of Item Groups. It would be great to see that functionality added. I have a use case where a single product might come from 5 or more suppliers and each supplier's item is an Item in
                                                                                                                • Zoho Books/Inventory - Update Marketplace Sales Order via API

                                                                                                                  Hi everyone, Does anyone know if there is a way to update Sales Orders created from a marketplace intigration (Shopify in this case) via API? I'm trying to cover a scenario where an order is changed on the Shopify end and the changes must be reflected
                                                                                                                • Ticket id issues

                                                                                                                  When I reply a ticket from desktop, it doesn't have ticket id in the subject and it's great. When I reply a ticket from Zoho desk mobile, Zoho adds ticket id in the subject and I don't want that. Please help in this matter.
                                                                                                                • Advanced email configuration - agent's name vs. department name

                                                                                                                  We currently have all four Advanced Configuration options turned ON at the Global-level (Channels > Email > Advanced Configuration) - including the "Show Agent name in Ticket replies and outgoing emails" option. We also had that same option turned ON
                                                                                                                • sync two zoho crm

                                                                                                                  Hello everyone. Is it possible to sync 2 zoho crm? what would be the easiest way? I am thinking of Flow. I have a Custom Module that I would like to share with my client. We both use zoho crm. Regards.
                                                                                                                • Add Bounced as an Email Action / Notification for Bounced Emails

                                                                                                                  This is one of the hard requirements for the clients we're servicing. They want to get an internal email notification whenever the email they sent to their contacts have bounced, so that they can look into it and update the email address. Currently, the
                                                                                                                • Files Uploaded to Zoho WorkDrive Not Being Indexed by Search Engines

                                                                                                                  Hello, I have noticed that the files I upload to Zoho WorkDrive are not being indexed by search engines, including Google. I’d like to understand why this might be happening and what steps I can take to resolve it. Here are the details of my issue: File
                                                                                                                • Zoho Recruit - Email Relay

                                                                                                                  Good day, Has anyone succeeded in setting up an email relay for Office 365? If I add the details from https://support.microsoft.com/en-us/office/pop-imap-and-smtp-settings-8361e398-8af4-4e97-b147-6c6c4ac95353, I get the connection error. Regards, Eka
                                                                                                                • Notebook AI limits

                                                                                                                  Hi folks, Working with the AI transcription tools in Notebook, on the Mac App, which I find quite handy, but the one thing I am struggling with is the inability to either edit or copy the results of the transcript: I can't click in any of the boxes, and
                                                                                                                • not able to convert pdf to jpg and other forms and vice versa.

                                                                                                                  i want to change my pdf to jpg, word, etc and some times jpg to pdf. i don't know how to do in this.
                                                                                                                • What’s New in Zoho Analytics - March 2026

                                                                                                                  Hello Users! In this month's update, we bring improvements across integrations, security, reporting, and analytics capabilities to help you work with your data more efficiently and with greater control. Explore what’s new and see how these enhancements
                                                                                                                • Zoho People > Performance Management > Appraisal cycle

                                                                                                                  Hello All I am using this 2 users to test out how it work on Performance Management User 1 - Reportee User 2 - Reporting Manager : Li Ting Haley User 1 : Self Appraisal Error How do i fix this error?
                                                                                                                • SalesIQ Tip for Admins: Guide Operators in Real-time Without Interrupting the Chat

                                                                                                                  Consider this. You're a supervisor and you're looking through the active conversations. An associate is mid-chat with a high-value prospect. The prospect asks something unexpected, maybe about a tailor-made subscription plan or a bulk discount that’s
                                                                                                                • Early Access: Check Printing in Zoho Books

                                                                                                                  Hello Everyone,   Are you constantly writing checks to pay your vendors?   We've got a great news to share with you! You can now pay your vendors by writing and printing a check directly from Zoho Books. The feature is ready and we'll be rolling it out to our customers in phases.  It is available in the  US Edition of Zoho Books and also in the Global edition, where the country is selected as USA and the currency is USD.   Here’s a summary of what’s possible:   1. Write and print a check. 2. Make
                                                                                                                • Connecting Zoho Inventory to ShipStation

                                                                                                                  we are looking for someone to help connect via API shipStation with Zoho inventory. Any ideas? Thanks. Uri
                                                                                                                • Syncing zoho books into zoho crm

                                                                                                                  I was wondering how I can use zoho books in crm as I have been using them separately and would like to sync the two. Is this possible and if so, how? Thanks
                                                                                                                • Next Page