Connections: How to integrate Cliq with third party applications?

Connections: How to integrate Cliq with third party applications?

Creating an integration component (Commands, Bots, Message Actions, Functions) that connects Cliq with another third party service can be implemented by Cliq Connections.
Now let us assume you are building a Wrike extension for Cliq. You want the extension to be power packed with all the below features -

  • Slash command to show the tasks you've added in your list. 
  • A bot that notifies you when a task is assigned to you and also reminder notifications for upcoming tasks! 
  • A message action to create a new task right from Cliq.
The most important step here would be to establish a way to connect Cliq and Asana. The best possible and also the most widely used method available right now is with OAuth 2.0 

What is OAuth 2.0?

Open Authorization or OAuth, is a standard protocol that applications use to provide authentication and allow secured and limited access to an application. In this case, access Asana from right from Cliq. 

Implementing OAuth 2.0 is quite cumbersome with all the different authorization grants available followed by the number of tokens that need to be generated in order to validate a user's identity. 

Connections execute the OAuth process for you!

Cliq Connections take care of this authorization process for any application you would like to integrate with. All you've to do is register your application (in this case, Cliq) with a third party service (Asana) and get a Client ID and Client Secret. 

Types of Cliq Connections

There are two different types of Cliq connections available. 

  • Connections listed under Pick Your Service 
  • Custom Service Connections
Connections listed under Pick your Service

Zoho already provides connections readily available with a list of services. The help page on 'Connections' explains how to create connection with a service listed under the Pick Your Service section. 

Creating a Custom Service Connection 
A simple example on how to create a custom connection with Wrike is given below:

Steps to be done in Wrike: 

1. The first step is to register your application (Cliq) in Wrike by giving the application name and redirect URL. Redirect URL is an important process in OAuth. Once an application is successfully authorized, the application redirects the user to this particular URL with a code or token.

The redirect URL for Cliq is :  https://deluge.zoho.com/delugeauth/callback

2. Generate a Client ID and Client Secret 

Steps to be done in Cliq: 


1. In the Add Connections page, select Custom Service
2. Click Create Your Own
3. In the Service Details section, add the following details for the respective fields: 
      Note: Refer this help page for the authorize URL, access token URL and the refresh token URL. 
4. In the Connection Details section, give your connection name.
5. Use Credentials of Login User: Enabling this option will ensure that, a user  is using their own credentials while            performing the integration. If this option is disabled, then the connection will use the admin (connection owner's) credentials to perform the integration.
6. Scope: OAuth scopes allow you to define exactly what data your application can access. For this example, we'll be defining the scopes required to access the 'Tasks' module in Wrike. Refer the scopes given for this module in this help page
7. Click Create and Connect
8. Use the generated 'Invoke URL' task in your commands, bots, message actions! 

This is simple pictorial representation how the custom connection works.


Below shown is a simple example on how to access the list of tasks in your Wrike Account directly from Cliq via a simple Slash Command. 



The source code for the command shown in the video is given below! Try creating the custom connection and executing this command.

  1. message = Map();
  2. response = invokeurl
  3. [
  4. url : "
  5. https://www.wrike.com/api/v3/tasks
  6. "
  7. type :GET
  8. connection:"wrike"
  9. ];
  10. taskDetails = response.get("data").toMap().get("title");
  11. taskURL = response.get("data").toMap().get("permalink");
  12. message.put("text","Tasks present in Wrike: \n Task Name: " + taskDetails + " \n Task URL: " + taskURL);
  13. return message;
Now you're all set to create a killer integration with Cliq! So get started. Comments and suggestions are welcome.

Best,
Manasa
Cliq



                        Zoho Marketing Automation
                                • 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 a board in Zoho Connect, then head over to this help document to know how to create one.  For this example, we've created a board for the Zylker Campaigns team in Zoho Connect. The board has three sections: User Interface, Content Marketing,
                                • 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 (/message) REST API, here any data can be posted to the endpoint which is further processed in the incoming handler before notifying in Cliq. The incoming webhook allows third-party applications to send notifications/alerts using the incoming webhook
                                • 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,


                                Manage your brands on social media



                                        Zoho TeamInbox Resources

                                          Zoho DataPrep Resources



                                            Zoho CRM Plus Resources

                                              Zoho Books Resources


                                                Zoho Subscriptions Resources

                                                  Zoho Desk Resources

                                                    Zoho Projects Resources


                                                      Zoho Sprints Resources


                                                        Qntrl Resources


                                                          Zoho Creator Resources


                                                            Zoho WorkDrive Resources



                                                              Zoho Campaigns Resources

                                                                Zoho CRM Resources

                                                                • CRM Community Learning Series

                                                                  CRM Community Learning Series


                                                                • Tips

                                                                  Tips

                                                                • Functions

                                                                  Functions

                                                                • Meetups

                                                                  Meetups

                                                                • Kbase

                                                                  Kbase

                                                                • Resources

                                                                  Resources

                                                                • Digest

                                                                  Digest

                                                                • CRM Marketplace

                                                                  CRM Marketplace

                                                                • MVP Corner

                                                                  MVP Corner

                                                                • Word of the Day

                                                                  Word of the Day


                                                                        Design. Discuss. Deliver.

                                                                        Create visually engaging stories with Zoho Show.

                                                                        Get Started Now