Deep Linking

Deep linking is the use of a hyperlink that directs a user to a specific page or location inside the product (e.g., "http://example.com/path/page"), instead of the website's home page (e.g., "http://example.com/").  In Cliq, Deep linking is a direct hyperlink for any conversation( channel/ adhoc chats/ direct messages or bots). These links come in handy to route the user to a conversation in Cliq directly from your application and are optimized for both web and mobile. 

There are 3 entities for which Cliq supports Deep linking

• Channels 
• Bots 
• Direct Message to a User

Channel Permalink 

The channel permalink can be used to direct a user to join the channel. The permalink routes the user to the channel preview page on Cliq web. Accessing this URL in mobile will open the respective channel in your Cliq app. For example, if you are a part of a channel and would like your colleague to join that channel, you can share the channel permalink to them if you don't have permissions to add a user to the channel! 

Sample Channel Permalink: 

https://cliq.zoho.com/channels/<channel_unique_name>

The channel permalink leads the user to the channel's preview page on Cliq web. 

In case of users who are not a part of this channel, Join this Channel button will be displayed instead of Continue.

Accessing the channel permalink in Cliq Mobile App

Clicking on the channel permalink from Cliq mobile app will direct the user to the join channel page if they are not a part of the channel or will open the channel in case they are a member already! 

How to get the Channel Permalink 

To get a channel's permalink, select the Actions menu present in the right corner of the chat window and choose the Channel Permalink menu option. The permalink will be copied to your clipboard. 

​

How to get the channel unique name

1. Hover over the channel name in the LHS and select the More Info option or click on Channel Info option in the Actions menu of the chat window. 
2. Click Connectors.
3. The API Endpoint URL contains the Channel Unique Name.

Bot Permalink

Bot permalink routes the user to the bot preview page, with details about the bot's creator, number of subscribers and the bot's description. Let's assume you've built a bot in Cliq which connects with your application to get data or perform any action. You can direct users from your application to subscribe to this bot (if they are using Cliq already) and get easy access to the application's data in Cliq directly! 

Sample Bot Permalink:

https://cliq.zoho.com/bots/<bot_unique_name>

In case of users who have not subscribed to the bot, Subscribe button will be displayed instead of Continue

How to get the bot permalink

To get a bot's permalink, select the Actions menu present in the right corner of the chat window and choose the Bot Permalink menu option. The permalink will be copied to your clipboard. 

How to get the bot unique name

1. Select Integrations from Cliq's top bar.
2. Click on Bots and select the bot you would like to message.
3. The API Endpoint URL in the Bot preview has the Bot Unique Name.

Deep link to direct message a user

Use this deep link URL to open a direct messaging space between you and a user. You can either give the user's email address or their ZUID. 

Sample URL:

https://cliq.zoho.com/users/<abc@example.com>