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






                    Zoho Campaigns Resources




                          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

                                                          • Customer payment alerts in Zoho Cliq

                                                            For businesses that depend on cash flow, payment updates are essential for operational decision-making and go beyond simple accounting entries. The sales team needs to be notified when invoices are cleared so that upcoming orders can be released. In contrast,

                                                          • Automating Employee Birthday Notifications in Zoho Cliq

                                                            Have you ever missed a birthday and felt like the office Grinch? Fear not, the Cliq Developer Platform has got your back! With Zoho Cliq's Schedulers, you can be the office party-cipant who never forgets a single cake, balloon, or awkward rendition of

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

                                                            Code reviews are critical, and they can get buried in conversations or lost when using multiple tools. With the Cliq Platform's link handlers, let's transform shared Github pull request links into interactive, real-time code reviews on channels. Share

                                                          • App Spotlight : PagerDuty for Zoho Cliq

                                                            App Spotlight brings you hand-picked apps to enhance the power of your Zoho apps and tools. Visit the Zoho Marketplace to explore all of our apps, integrations, and extensions. In today's fast-paced world, seizing every moment is essential for operational

                                                          • Automate your status with Cliq Schedulers

                                                            Imagine enjoying your favorite homemade meal during a peaceful lunch break, when suddenly there's a PING! A notification pops up and ruins your moment of zen. Even worse, you might be in a vital product development sprint, only to be derailed by a "quick


                                                          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

                                                                                                          • How to activate RFQ? What if a price list has ladder price for items?

                                                                                                            Where can I find the option to activate request for quotation? How does it work? If the item has ladder price, does it gets calculated depending on how many items are in the cart?

                                                                                                          • Can't join canal Developers Zoho User

                                                                                                            Hello, I received an invitation to join this channel, but I get an error when I try to join it, and I get the same error when I go to the Zoho Cliq interface > Search for a channel. Is this because I don't have a license linked to this email address?

                                                                                                          • Desk Email reply - set default font / use custom font

                                                                                                            Hello, in our e-mails, which we send to our customers, a certain font must be used (Corporate Design): Segoe UI https://en.wikipedia.org/wiki/Segoe#Segoe_UI How can this be included? How can this be set as the default font to ensure that this font is

                                                                                                          • PDF Templates - Checkbox Borders

                                                                                                            Is there a way to remove the border of a radio/checkbox on a PDF? I'd like to use the function of checkbox but if there's no easy way to remove the border (the PDF form already has a rectangle so it gets cluttered), then I'm forced to create a single

                                                                                                          • Settings Icon No Longer in ZOHO Desk?

                                                                                                            In ZOHO desk, there has been a gear icon for settings. as of yesterday, it is no longer there. I showed up briefly this morning but is gone again. Anybody else experiecing this?

                                                                                                          • Introducing the all-new email parser!

                                                                                                            Greetings, We are pleased to introduce to you, a brand-new, upgraded version of the Zoho CRM Email Parser, which is packed with fresh features and has been completely redesigned to meet latest customers needs and their business requirements. On that note,

                                                                                                          • Tip #43 - Track, Review, and Analyze Your Assist Sessions with Reports-'Insider Insights'

                                                                                                            Did you know you can generate detailed reports for both remote support sessions and unattended access sessions in Zoho Assist? This makes it easy to monitor technician activity, measure efficiency, and review customer interactions. Let us now take a closer

                                                                                                          • Function #20: Custom calculation in item table of invoices

                                                                                                            When you create an invoice in Zoho Books, the 'Amount' of a line item is typically calculated as the product of the "Quantity" and the "Rate" of the item. For instance, if an item has a sales rate of $50 and a quantity of 5 is sold, then the amount would

                                                                                                          • Simplified Call Logging

                                                                                                            Our organization would like to start logging calls in our CRM; however, with 13 fields that can't be removed, our team is finding it extremely cumbersome. For our use case, we only need to record that a call happened theirfor would only need the following

                                                                                                          • Sub form doesn't as formula field

                                                                                                            Is it possible to get formula field in sub form in futures?

                                                                                                          • Week date range in pivot table

                                                                                                            Hello, I need to create a report that breakouts the data by week.  I am using the pivot table report, and breaking out the date by week, however the date is displayed as 'Week 1 2014' format.  Is there anyway to get the actual dates in there? ex. 1/6/2014-1/12/2014 Thanks,

                                                                                                          • How do I get Status History data of my Projects?

                                                                                                            I want to build a table in Zoho Analytics that Groups by Date, when Projects entered a certain status. I cannot find Status History or any such useful data available in the Setup of my Data Source sync. Please advise how I can achieve this?

                                                                                                          • Is it possible to hide fields in a Subform?

                                                                                                            Since layout rules cannot be used with Subforms, is there another way, or is it even possible, to hide fields in a subform based on a picklist fields within said subform? For example, if the Service Provided is Internet, then I do not want to see the

                                                                                                          • Weekly Tips :Instantly find what you need with Attachment Viewer

                                                                                                            Your inbox must be packed with project emails, shared notes, and scattered attachments. You are looking for one specific file—a presentation slide or maybe a media clip from a team update—but don’t want to dig through endless email threads or switch between

                                                                                                          • Missing Zoho Desk integration option for form workflows

                                                                                                            According to the help page "Configure Zoho Desk integration in form workflows" we should be able to select Zoho Desk as an integration target but when I open the integrations list then Zoho Desk is not being listed in it. We are on the Premium plan which should already support Zoho Desk integrations.

                                                                                                          • Gantt for 2 or more projects

                                                                                                            Hello, I'm trying the free version of your produtc. It is veryyy good!!!! I don't know if in the Standard plan, I can overview a Gantt Graph for 2 or more Projects Milestone. This would be very helpfull for managing teams and taking decisions about who I will assign a task to. In the paid plan Do I have this possibility? Thank you.

                                                                                                          • Integrating a Zoho Project Gantt Chart into Reports

                                                                                                            Is is possible to integrate a Zoho Project Gantt Chart into a Zoho Report Dashboard. I am in the process of creating Project Status Dashboards for the projects that we track in Zoho Projects and I would like to incorporate the gantt chart within Reports.  Please let me know! Thanks

                                                                                                          • ZOHO BOOKS - EXCESSIVELY SLOW TODAY

                                                                                                            Dear Zoho Books This is not the first time but it seems to be 3 times per week now that the system is extremely slow. I work on Zoho Books 95% of my day so this is very frustrating. Zoho you need to do something about this. I have had my IT guy check

                                                                                                          • Gantt Chart - Zoho Analytics

                                                                                                            Are there any plans to add Gantt Charts capabilities to Zoho Analytics?

                                                                                                          • Displaying related quotes in sales order and back

                                                                                                            Hi, My colleague liked to see to which sales orders, the quote has been converted. Quote shows Invoices, but not SO. Same, they would like to see the quotes in the sales order, as they can see invoices, packages, shipment, How can we achieve this ? Thank

                                                                                                          • Tip of the Week #71–Auto-move incoming messages to the right inboxes with keywords

                                                                                                            We all know that customer-facing teams, especially your sales and support teams, can’t afford to miss even a single customer conversation. But sometimes, sales queries or support requests can easily get lost in a crowded inbox or even end up in the wrong

                                                                                                          • Clearing Fields using MACROS?

                                                                                                            How would I go about clearing a follow-up field date from my deals? Currently I cannot set the new value as an empty box.

                                                                                                          • Migrating a Zoho Forms form into Zoho Creator

                                                                                                            Hi, How can I migrate my Zoho Forms form into Zoho Creator? Thanks. Truly, Emad

                                                                                                          • Is there any way to recall an email sent using Zoho CRM?

                                                                                                            If an email is sent using Zoho Mail, there is a recall option/functionality that is available to the sender. Is there any way to recall an email if it was sent using Zoho CRM? I can't seem to find that option. Any help would be appreciated.

                                                                                                          • Problem with reports due to "Connected" items change - Yes this IS a problem

                                                                                                            Now that the change has been made to use "connected" items I can no longer run the reporting I need in CRM. I should be able to start with Deals as the parent, connect down to the Account (Account_Name) on the deal as the child, then to any child items

                                                                                                          • Introducing notifications in the vendor portal

                                                                                                            Imagine this: You're a recruiter working with multiple vendors on a high-volume hiring project. You’ve just updated a job description after a last-minute change from the hiring manager. One of your vendors, however, is still working off the older version

                                                                                                          • CRM limit reached: only 2 subforms can be created

                                                                                                            we recently stumbled upon a limit of 2 subforms per module. while we found a workaround on this occasion, only 2 subforms can be quite limiting in an enterprise setting. @Ishwarya SG I've read about imminent increase of other components (e.

                                                                                                          • LESS_THAN_MIN_OCCURANCE - code 2945

                                                                                                            Hi I'm trying to post a customer record to creator API and getting this error message. So cryptic. Can someone please help? Thanks Varun

                                                                                                          • Analytics for notes created

                                                                                                            Is there a way I can see how many notes were created per day? Via reporting or analytics?

                                                                                                          • Cannot update Recurring_Activity on Tasks – RRULE not accepted

                                                                                                            Hello, I am trying to update Tasks in Zoho CRM to make them recurring yearly, but I cannot find the correct recurrence pattern or way to update the Recurring_Activity field via API or Deluge. I have tried: Sending a string like "RRULE:FREQ=YEARLY;INTERVAL=1"

                                                                                                          • Add image to report...

                                                                                                            Greetings, I send a weekly color coded report via Creator email. I would like to add the legend somewhere in the report. Header, footer where ever. I have the legend saved on Google Drive and can access it via shared link. Sure someone has wanted to add

                                                                                                          • More controls for User Fields in CRM

                                                                                                            Dear All, We are here with a minor but crucial enhancement to the user fields—now set accessibility permissions to the records for user field. User field allows you to extend co-ownership of records to your peers. You can collaborate with them for certain

                                                                                                          • Calls to accounts rather than leads or contacts?

                                                                                                            So..... We have a dilemma and I'm hoping someone has encountered this before and figured out a fix. We have just migrated to Zoho. It's great.....expect for how "Calls" are handled.... We are B2B. We do not use the leads module. A "Lead/Prospect" for

                                                                                                          • Image Upload Field | Zoho Canvas

                                                                                                            I'm working on making a custom view for one of our team's modules. It's an image upload field (Placement Photo) that would allow our sales reps to upload a picture of the house their working on. However, I don't see that field as a opinion when building

                                                                                                          • Power of Automation :: Automated 'Delayed & Closed' Status Update Based on Due Date

                                                                                                            Hello Everyone, A custom function is a software code that can be used to automate a process and this allows you to automate a notification, call a webhook, or perform logic immediately after a workflow rule is triggered. This feature helps to automate

                                                                                                          • Lead Blueprint transition in custom list view

                                                                                                            Hi, Is It possible to insert the Blueprint transition label in a custom Canvas list view? I am using Lead module. I see the status, but it would be great if our users could execute the Blueprint right from the list view without having to enter the detailed

                                                                                                          • Range names in Zoho Sheet are BROKEN!

                                                                                                            Hi - you've pushed an update that has broken range names. A previously working spreadsheet now returns errors because the range names are not updating the values correctly. I've shared a video with the support desk to illustrate the problem. This spreadsheet

                                                                                                          • populate email address and name in zoho desk?

                                                                                                            Is it possible to populate the email address and name in the zoho desk widget? We only use it in the context of an authenticated user, so we already know the user's name and email. Thanks,

                                                                                                          • Are there default/pre-built dashboards in Zoho Desk?

                                                                                                            Hi, I am looking for some pre-built dashboard templates in Zoho Desk, similar to what we can find in CRM/Projects, etc Thank you

                                                                                                          • SAP S/4 HANA to CRM Integration - change the SAP Client ID

                                                                                                            Hi I am trying to push the business partners from SAP S/4 HANA to ZOHO CRM module. The SAP Client ID is 421 in my case....kindly let me know how do I specify the sap client because it's a dropdown with specific values as of now. Thanks Ravi Aswani

                                                                                                          • Next Page