Introduction to Slash Commands in Cliq

Introduction to Slash Commands in Cliq

In Steve Jobs' words,

The most precious resource we all have is time.


And rightly so, aren't we all looking for quick ways to perform our tasks? Automating even the most trivial actions, can save us some time and make us more productive. If you are looking for an interface to quickly carry out your actions, then Slash Command is the answer. So today, lets learn about slash commands and also try programming a simple command. 

Now that I've kindled your curiosity, let me give a brief overview about slash commands. Slash commands is an interface, with a fixed syntax and can be triggered to complete your task or perform an action right inside the chat window. If using a slash command is easy, creating one is way more easier and interesting. More about creating and managing slash commands are explained in our help page. Additionally, watch this video on how to create and execute a slash command!



Let us try building a command /weather that can fetch you the weather information of a location. The use case we are looking at here, is to get the weather details for the day or to fetch the weather forecast details for the upcoming five days. 
  
The next step would be to get necessary APIs. The APIs used are from https://developer.accuweather.com/apis. Once you source out the necessary APIs, create the command by giving the name, description, hint followed by command parameters. 

The command parameters (options) we require here are :
- city : To get the location from the user. ( Drop a hint to the user to mention the place name! ) 
 
The command execution flow is given in the flowchart below:


Breaking down the command execution flow in 2 simple steps: 
 
1. Each location is assigned with a location key. To get the weather details for a location, the first step would be to get this location key for the place mentioned in the command input parameter. 
 
2. This location key is then used in either the current conditions URL or the weather forecast conditions URL. This again depends on the command input. 
 
Take a look at the /weather command execution code: 
 
  1. //Define new empty Map expressions, Message and Card - to post message on command execution. 

  3. message = Map(); 
  4. card = Map(); 
  5. card.put("theme","modern-inline"); 
  6. card.put("title","Weather Information"); 

  8. //Store the user entries (options) in the a variable 

  10. place = options.get("city"); 
  11. locationURL = "http://dataservice.accuweather.com/locations/v1/cities/search?apikey=API_KEY&q=" + encodeurl(place) + ""; 
  12. response = getURL(locationURL); 

  14. // Convert the string response to a map to get the "Location Key" from the response. Store the location key in a variable. 
  15. locationkey = response.toMap().get("Key"); 

  17. // Any string passed while executing a command will be stored in"arguments" 

  19. if(arguments.containsIgnoreCase("forecast")) 
  20. { 
  21. //API to get weather forecast for the specified location 
  22. ForecastURL = "http://dataservice.accuweather.com/forecasts/v1/daily/5day/" + encodeurl(locationkey) + "?apikey=API_KEY"; 
  23. forecastdata = getURL(ForecastURL); 

  25. // Convert the response to a map. 
  26. DailyForecasts = forecastdata.toMap().get("DailyForecasts"); 

  28. // From the response obtained, get the information you would like to show in your command response. And organize it in a table and post as a message card! 
  29. slides = List(); 
  30. slidedata = Map(); 
  31. slidedata.put("type","table"); 
  32. rows = List(); 
  33. for each DailyForecast in DailyForecasts 
  34. { 
  35. clock = DailyForecast.get("Date"); 
  36. Time = clock.getDay()+"/"+clock.getMonth(); 
  37. Temp = DailyForecast.get("Temperature").toMap().get("Minimum").toMap().get("Value"); 
  38. Celsius = ((Temp - 32) * 0.5556).round(1) + "°C"; 
  39. row = Map(); 
  40. row.put("Date", Time); 
  41. row.put("Temperature",Celsius); 
  42. rows.add(row); 
  43. }
  44. data = Map(); 
  45. headers = List(); 
  46. headers.add("Date"); 
  47. headers.add("Temperature"); 
  48. data.put("headers",headers); 
  49. data.put("rows",rows); 
  50. slidedata.put("data",data); 
  51. slides.add(slidedata); 
  52. message.put("slides",slides); 
  53. message.put("text","Weather forecast for the next 5 days in "+place ); 

  55. }
  56. else 
  57. { 
  58. CurrentWeatherURL = "http://dataservice.accuweather.com/currentconditions/v1/" + encodeurl(locationkey) + "?apikey=API_KEY"; 

  60. // API to get current weather conditions for the specified location 
  61. current_weather_data = getURL(CurrentWeatherURL); 

  63. // Convert the string response to a map. 
  64. WeatherInfo = current_weather_data.toMap(); 

  66. // From the response obtained, get the information you would like to show in your command response. 
  67. climateinfo = WeatherInfo.get("WeatherText"); 
  68. climate = WeatherInfo.get("Temperature"); 
  69. Metrics = climate.get("Metric"); 
  70. Celcius = Metrics.get("Value"); 
  71. Unit = Metrics.get("Unit"); 

  73. // The required information from the response will be posted as a message 
  74. message.put("text","The weather in " + place + " is " + climateinfo + " with a temparature of " + Celcius + "°" + Unit + ""); 
  75. } 

  77. //Post the message to a chat with the help of the deluge task : zoho.cliq.postToChat (); 
  78. aa = zoho.cliq.postToChat(chat.get("id"),message); 
  79. message.put ("card",card); 
  80. return message; 

And that's how you can use a simple slash command to fetch weather details, right inside your chat window! Let us know how this post helped you. Feel free to post your queries , suggestions here!

Cheers,
Manasa 
Cliq                   

    Access your files securely from anywhere

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






                              Zoho Developer Community



                                  Bootcamp
                                  Community
                                  Pricing
                                  Webinars
                                  What's New
                                  Integrations
                                  Contact Support
                                  Contact Sales
                                    Zoho Survey Resources
                                      Features
                                      Survey Templates
                                      Integrations
                                      Community
                                      iOS Mobile Surveys
                                      Pricing
                                      Android Mobile Surveys
                                      Insurvey Blogs
                                      Insight Blogs
                                      Tips & Tricks





                                                  Latest Feature Updates

                                                    • Desk Community Learning Series


                                                    • Digest


                                                    • Functions


                                                    • Meetups


                                                    • Kbase


                                                    • Resources


                                                    • Glossary


                                                    • Desk Marketplace


                                                    • MVP Corner


                                                    • Word of the Day


                                                    • Ask the Experts




                                                        Zoho SalesIQ Resources

                                                              • 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
                                                              Access Zoho Social

                                                                Zoho Pagesense Resources


                                                                    Zoho TeamInbox Resources

                                                                      Zoho DataPrep 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

                                                                                                                • Mass emails - Allow preview of which emails will receive the email based on the criteria

                                                                                                                  Feature request. Please allow us to view and confirm the exact recipients of the mass emails based on the criteria we've chosen before sending. It can be quite sensitive if you send the mass email to some wrong accounts accidently, so it would be great

                                                                                                                • Limitation in Dynamic Constant Sum Based on Previous Question Selections in Zoho Survey

                                                                                                                  Zoho Survey supports the Constant Sum question type, allowing respondents to distribute a fixed total (such as 100) across a set of options. However, it does not support dynamically populating these options based on selections made in a previous question.

                                                                                                                • SAP Business One(B1) integration is now live in Zoho Flow

                                                                                                                  We’re excited to share that SAP Business One (B1) is now available in Zoho Flow! This means you can now build workflows that connect SAP B1 with other apps and automate routine processes without relying on custom code. Note: SAP Business One integration

                                                                                                                • 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.

                                                                                                                • Showing the map along with mileage expense

                                                                                                                  When you use the GPS to track mileage, it shows you the map of the actual path travelled. It would be very useful and practical to save that map with the mileage expense, so that when the report is created, it provides a map of each mileage expense associated

                                                                                                                • Import MSG to Yandex Mail Account | Fast & Reliable Solution

                                                                                                                  If you are facing problem to import MSG files to Yandex Mail account can be challenging if done manually, especially when handling multiple files. A reliable solution is using the MacGater Mac MSG Converter, which simplifies the entire process with accuracy

                                                                                                                • Copy all reports in a folder

                                                                                                                  I currently have a database that I need to create multiple charts filtered by market. All of the charts are identical, I just change to of the filters and then I have the next market's set of charts. The only way I've been able to copy charts (reports)

                                                                                                                • OpenURL working Intermittently

                                                                                                                  Never had this issue before, everything was working fine up to a few days ago. We have a buttons on reports to open forms with pre-filled fields. Now, there are instances where it will throw and error and gives no feedback. What is really strange is not

                                                                                                                • Zoho Recruit mailserver get blocked by Microsoft!

                                                                                                                  Hi, We have experienced this issue twice now, where Zoho Recruit outbound IP addresses are being blocked by Microsoft. We are confident that Microsoft is the blocking party, as all outbound emails to candidates with @hotmail.com, @live.com, and @outlook.com

                                                                                                                • Calculate Hours Minutes Sec in Zoho Creator Using Deluge

                                                                                                                  check_In = "8-Aug-2023 10:00:00".toDateTime().toLong(); checkout = "8-Aug-2023 18:00:00".toDateTime().toLong(); //difference = start.timeBetween(end); check_In = "8-Aug-2023 17:56:50".toDateTime().toLong(); checkout = "8-Aug-2023 18:00:00".toDateTime().toLong();

                                                                                                                • Build Smarter Apps with AI in Zoho Creator

                                                                                                                  Build Smarter Apps with AI in Zoho Creator This is truly the era of AI, and businesses that adapt now will lead tomorrow. Zoho is already moving ahead in this direction, continuously evolving its platform with powerful AI capabilities. With Zoho Creator,

                                                                                                                • 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?

                                                                                                                • Online Payment Fees

                                                                                                                  We don't take many online credit card payments so the merchant service provider (PayPal) charges us the 2.9% fee for processing the amount. I would like the ability for the fee to be automatically added to the total amount for "ease of payment". We'd

                                                                                                                • 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

                                                                                                                • 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.

                                                                                                                • 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.

                                                                                                                • 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

                                                                                                                • 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

                                                                                                                • 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?

                                                                                                                • Next Page