Post message to a channel using a simple one-line command!

Post message to a channel using a simple one-line command!

Hi Everybody!

This post is all about posting a message in a Channel using cURL, Wget and PowerShell. cURL is a light-weight, command interface used to transfer data to a server. The steps are pretty easy! 

The three most important points here are 
  • Generating an Auth token
  • Get your Channel Unique Name
  • Form your message as a JSON structure
Generating an Auth token

To use the 'Messaging API' you'll need Cliq's authentication token from Zoho Accounts. Generate an auth token by hitting the below-given URL in your browser.

Send message to a channel by using  the Channel Unique Name 

 How to get a Channel's Unique Name?

  • Hover over any channel name from Cliq's left pane. 
  • This'll open the channel's preview. Select the 'More info' icon in the channel preview.
  • Navigate to 'Connectors'
  • You'll find the Channel Unique Name highlighted in the API Endpoint URL of the channel. 

Your message structure in JSON 

A simple message needs to be defined as a key-value pair in JSON. The 'text' will contain the message, which you'd like to post. 

For example :

  1. {
  2. "text": "How to post a simple message to a Cliq channel? "
  3. }

Now, to send this JSON by making a standard POST request 

  1. curl -X POST -H "Content-type: application/json" -H "Authorization:Zoho-authtoken <authtoken>" https://cliq.zoho.com/api/v2/channelsbyname/<channel_unique_name>/message -d '{"text":"How to post a simple message to a Cliq Channel?"}'

Sample POST request using cURL:

If the channel uniquename is 'market-stats' and the authtoken is 'abaijd9ie3n9udnuxc92' then your curl command will be

  1. curl -X POST -H "Content-type: application/json" -H "Authorization:Zoho-authtoken abaijd9ie3n9udnuxc92" https://cliq.zoho.com/api/v2/channelsbyname/market-stats/message -d '{"text":"How to post a simple message to a Cliq Channel?"}'

Similarly using wget :

  1. wget --post-data="{'text':'How to post a simple message to a Cliq Channel?'}" --header="Content-type:application/json" --header="Authorization:Zoho-authtoken abaijd9ie3n9udnuxc92" https://cliq.zoho.com/api/v2/channelsbyname/market-stats/message
And finally using Powershell :
  1. Invoke-RestMethod -Uri https://cliq.zoho.com/api/v2/channelsbyname/market-stats/message -Method Post -Headers @{"Authorization" = "Zoho-authtoken abaijd9ie3n9udnuxc92"} -ContentType 'application/json' -Body '{"text" : "How to post a simple message to a Cliq Channel?'"}'
Go on and try posting a message in a channel! After all, its simple. 

Suggestions and discussions are welcome!

Best,
Manasa
Cliq

    • Sticky Posts

    • Convert a message on Cliq into a task on Zoho Connect

      Message actions in Cliq are a great way to transform messages in a conversation into actionable work items. In this post, we'll see how to build a custom message action that'll let you add a message as a task to board on Zoho Connect. If you haven't created

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

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

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

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

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

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

    • The Slash Command Series - Types of Command Suggestions

      Hi Everybody! I hope you guys tried the /zdocs command and now have an idea of how command suggestions with click to execute work. If you have no clue of what command suggestion is, I recommend you to take a look at all the Slash Command Series posts, especially the one on Command Suggestions ! This post is all about the different types of command suggestions.  Customise your command suggestions  Did you know you could customise your command suggestion list with a title, description, image? Well,