Plug Sample #9 - Get Notified on Cliq When Your Premium Customers Interact with SalesIQ's Zobot

Plug Sample #9 - Get Notified on Cliq When Your Premium Customers Interact with SalesIQ's Zobot

Hi everyone! 

We're here with another simple yet effective plug for your chatbot to integrate with Zoho Cliq to make your job easier. Just imagine whenever a potential lead or your premium customers are on your website, and they engage with your chatbot, you'll receive instant notifications on Cliq, complete with their details and a chat URL.

Sounds helpful, right? 

Now get all this information on your cliq as a message. If a prospect or a premium customer is conversing with the bot, then on a click you will be redirected to SalesIQ. You will get the complete information of the chat and can also take over the chat from the bot, thus providing your best assistance. 



Are you new to SalesIQ? Wondering what these plugs and bots are?

Zoho SalesIQ is a customer engagement and live chat platform for your website. To automate customer engagement, SalesIQ offers chatbots. With the Codeless bot builder, you can build chatbots by dragging and dropping cards. This bot builder has almost all essential cards needed to build your bot. However, at times, businesses would require unique actions from the bot and for those instances, we have Plugs. With plugs, you can create a unique action and bring it as a card inside the codeless bot builder like the rest of the cards. In this post, we will take a look at how to create a plug integrating your bot with Zoho Cliq and the possible benefits. 

How can this Plug help your business?
  • Get notified in Cliq when a specific type of visitor engages with chatbot. These visitors can be who you think are important for your business like premium customers, potential leads, visitor with a good lead score, visitors from a specific URL or source, visitor with CRM deal closing date period, etc. as per your requirement.
  • Cliq bot will notify on the personal chat (subscribers of the bot) or on a group channel based on the preference.
  • Get your visitor details like name, chat URL, and other information, in the message notification. 
  • Clicking on the chat URL, you will get redirected to the SalesIQ's bot conversation, where you can look at the bot chat. If required, you can take over the chat. 

Plug overview



  • The SalesIQ bot will collect the required information and send it to the Cliq bot while the conversation is ongoing. 
  • Next, the Cliq bot will send this information to personal chat or a group channel in Cliq as per your business needs.

How to build this Plug (promising lead engages with your bot) ?

Step 1 - Create a connection between SalesIQ and Zoho Cliq
  • In your SalesIQ Dashboard, navigate to Settings > Developers > Plugs > Click on Add .
  • Provide your plug a name, and description, select the Platform as SalesIQ Scripts , and finally, click on Connection to your left bottom. You will be redirected to the connection interface.
  • Click on Create connection at the top right corner. 

  • Under Default connection, select Zoho OAuth service. 

  • Provide your connection name, connection link name, and choose the scopes below.
    • ZohoCliq.Webhooks.CREATE
    • ZohoCliq.Messages.ALL
  • Click on Create And Connect to connect Zoho SalesIQ and Zoho Cliq.


Note: The Connection Link Name will be used in the scripts to invoke URL tasks.

Upon successful authentication,  Zoho SalesIQ will be connected with Zoho Cliq. 


  • The connection is successfully established. 


Step 2 - Build the Plug

As we have created a connection between SalesIQ and Cliq successfully. It's time to build the plug.  The first step in building the plug is defining the parameters. You can enter the metrics (information) which you want the SalesIQ bot to send to Cliq bot. I've taken the name, lead score, requirement (lead's interest) and conversation ID to create the chat URL.  

Input Parameters
  • Name : name | Type : String
  • Name : leadScore | Type : String
  • Name : requirement | Type : String
  • Name : conversationID | Type : String


Script to notify a specific user via Cliq bot

If you want to notify (post information) to specific users in Cliq, copy the code below and paste it into your plug builder. Then, make the following changes. 
  • In line #16, get your portal's chat URL. For that, navigate to SalesIQ > Chats > Copy the URL except the conversation ID.

  • In line #22, replace the cliq bot name in the URL. To get the bot name from your Cliq dashboard, click on your profile in the top right corner > Bots & Tools. Then, create a new bot or click on any existing bot. (All subscribers of this bot will get notified.)

  • And, make sure, the connnection line name in line #25 is same as created during creating the connection between SalesIQ and Cliq (Step 1).
Plug Script/Code
  1. if(session.containsKey("name"))
  2. {
  3. name = session.get("name").get("value");
  4. }
  5. if(session.containsKey("leadScore"))
  6. {
  7. leadScore = session.get("leadScore").get("value");
  8. }
  9. if(session.containsKey("requirement"))
  10. {
  11. requirement = session.get("requirement").get("value");
  12. }
  13. if(session.containsKey("conversationID"))
  14. {
  15. id = session.get("conversationID").get("value");
  16. chat_url = "https://salesiq.zoho.com/zylkerinc/allchats/" + id;
  17. }
  18. list_data = {"text":"Lead Infomation","slides":{{"type":"list","data":{"Name - " + name,"Lead Score - " + leadScore,"Requirement - " + requirement,"Chat URL - " + chat_url}}},"broadcast":true};
  19. //replace your cliq bot name (salesiq)  in line #22
  20. sendText = invokeurl
  21. [
  22. url :"https://cliq.zoho.com/api/v2/bots/salesiq/message"
  23. type :POST
  24. parameters:list_data + ""
  25. connection:"cliq"
  26. ];
  27. response = Map();
  28. return response;
  • Then, click Save, preview the plug and Publish it. 
Note: API invoked in the plug is Post message to a bot

Script to notify a specific channel via Cliq bot

If you want to notify (post information) to a specific channel in Cliq, copy the code below and paste it in your plug builder. Then, make the following changes. 
  • In line #16, get your portal's chat URL. For that, navigate to SalesIQ > Chats > Copy the URL except the conversation ID.
  • In line #22, replace the Cliq bot and channel name in the URL. To get the bot name, click on your profile in the top right corner > Bots & Tools. Then, create a new bot or click on any existing bot. To get the channel name, click on the channel properties and get the channel's Unique Name. 
  • And, make sure, the connnection line name in line #25 is same as created during creating the connection between SalesIQ and Cliq (Step 1).
Plug Script/Code
  1. if(session.containsKey("name"))
  2. {
  3. name = session.get("name").get("value");
  4. }
  5. if(session.containsKey("leadScore"))
  6. {
  7. leadScore = session.get("leadScore").get("value");
  8. }
  9. if(session.containsKey("requirement"))
  10. {
  11. requirement = session.get("requirement").get("value");
  12. }
  13. if(session.containsKey("conversationID"))
  14. {
  15. id = session.get("conversationID").get("value");
  16. chat_url = "https://salesiq.zoho.com/zylkerinc/allchats/" + id;
  17. }
  18. list_data = {"text":"Lead Infomation","slides":{{"type":"list","data":{"Name - " + name,"Lead Score - " + leadScore,"Requirement - " + requirement,"Chat URL - " + chat_url}}}};
  19. //replace your cliq channel (leadsfromzobot) and bot name (salesiq) in line #22
  20. sendText = invokeurl
  21. [
  22. url :"https://cliq.zoho.com/api/v2/channelsbyname/leadsfromzobot/message?bot_unique_name=salesiq"
  23. type :POST
  24. parameters:list_data + ""
  25. connection:"cliq"
  26. ];
  27. response = Map();
  28. return response;
  • Then, click Save, preview the plug and Publish it. 
Note: API invoked in the plug is Post message in a channel

Step 3 - Adding the plug to the Codeless bot builder
  • Navigate to Settings > Bot > Add, provide the necessary information, and select Codeless Bot Builder as a bot platform or open an existing bot.
  • To notify in Cliq, click on Plugs under Action cards, select the plug you have created and provide the input values for the parameters defined in the plug builder.

  • As we want to notify only the visitors whose lead score is more than 500. Use the Criteria router card and set up a rule. 

  • For lead score, provide the value "more than 500".

  • Choose the %visitor.name% variable for the name.
  • Select the %Active conversation id% to get the conversation ID for the chat URL. 

  • Get the requirement before using any input card, save it in the context variable and select the variable here. 


Plug Output

This is how the Cliq users will be notified. 

To a specific user



To a specific channel



Upon clicking the chat URL, you will be redirected to the ongoing bot chat, where you can monitor and take the chat if required. 



See you again with another efficient plug sample :)

Best regards
Sasidar Thandapani

    • Recent Topics

    • Syncing with Google calendar, Tasks and Events

      Is it possible to sync Zoho CRM calendar, task and events with Google Calendar's tasks and events. With the increasing adoption by many major tool suppliers to sync seamlessly with Google's offerings (for instance I use the excellent Any.do task planning

    • Filtert products by multi select custom field

      Hello, this is seems like a must addition, why it can not be done now?

    • CRM quotes and sub forms.

      Recently upgraded to Enterprise CRM - now some added hopes/questions * In a subform in quotes, if I add a "Percent" field, called Overage for instance. I would expect it to allow me to enter a percent like "10%" and carry the percent forward to formulas

    • Is there a notification API when a new note is addeding

      Trying to push to Cliq, or email notification when there's a new note added in module. How to implement this?

    • Problem with WorkDrive and Vivo X200 Pro

      Hey there, after a long odyssey of searching for a new phone, several issues and defects with a phone from another brand and many reinstallations and transfers I stuck to the Vivo X200 Pro. So far, so great. Only thing not working is the Zoho WorkDrive,

    • Cambiar nombre de usuario

      Hola. Tengo una cuenta en zoho, por ejemplo Minombre @ midominio.es Y quiero cambiarlo a Miotronombre @ midominio.es Se puede cambiar??? Con la cuenta gratuita de zoho, cuantos nombres puedo tener en un dominio??? Gracias y buen dia

    • Can't add company logo and favicon as a superadmin

      I am logged in as the superadmin but can't add company logo and favicon - the fields are greyed out. Any idea as to what the problem could be?

    • Inquiry regarding B2B website through Zoho Commerce

      We are looking to build an online B2B customer portal for Consumer Goods primarily for order placement, with an e-commerce-style layout. Additionally, we would like to offer our customers features such as: 1.Viewing past orders and order updates 2.Accessing

    • ASAP Chrome Extension not loading

      We have ASAP enabled in Zoho Desk. I installed the ASAP Chrome Extension (Windows 10), but when I click the extension button while on our site, it never fully loads. I just get what's shown below.

    • Why is the Zoho portal not mobile friendly?

      I just got started with the portal and im sort of shocked how it looks. I already filled a hint/complaint about this. On the website you see a wonderful site with a modern design. Yet in real life its a mid 2000 look and feel. One major issue i see thats

    • New Asap Widget How to update my code

      I know you're still working on updating the documentation for calling the Asap Widget, the existing documentation is no longer valid. In the old 1.0 version I was able to do many things programmatically in javascript. I could open an article directly

    • Condition in templates

      Is it possible for me to add merge field conditionally in my templates. For example Dear ${Leads.Gender == "Male" ? "Sir" : "Ma"},

    • How to Dynamicaly display image in the Detailed View Report ?

      I have an "Add Employee" form that includes an image field for uploading an employee's profile picture from their local computer. In the "Apply Leave" form, I also have an image field where I want the employee's profile picture to be auto-populated based

    • Zoho Flow Custom Function to Register Sale in Zoho Thrive

      Hi Thrive team, I want to create a custom function which sends purchase information back into Thrive for Affiliate commission. I'm stuck on how to setup the connection, specifically creating an OAuth connection through https://api-console.zoho.eu/ Please

    • Sending User-centric reports to all users

      I would like to automate an e-mail report to all users that sends them a weekly e-mail listing their open Potentials.  I've created a Report that uses the ${CURRENTUSER} criterion and scheduled the report to send to several users, but they all receive

    • How do I add new line and format text in zoho desk ticket?

      I am generating a ticket via API and looking to update "description" field of ticket whenever I need. Is there a document where I can find supported formatting for description field on a ticket.  I need to find: Adding a new line and adding bold text,

    • Automation #6 - Prevent Re-opening of Closed Tickets

      This is a monthly series where we pick some common use cases that have been either discussed or most asked about in our community and explain how they can be achieved using one of the automation capabilities in Zoho Desk. Typically when a customer submits

    • Feature Request - Insert URL Links in Folders

      I would love to see the ability to create simple URL links with titles in WorkDrive. or perhaps a WorkDrive extension to allow it. Example use case: A team is working on a project and there is project folder in WordDrive. The team uses LucidChart to create a drawing/s for the project. The team member could create a link to the LucidChart drawing/s and allow WordDrive to truly be a repository for ALL the project documents, even those outside of WorkDrive. A folder is dedicated to a CRM account. A

    • ZOHO DESK ヘルプセンターの言語選択メニューの表示方法

      ZOHO DESK のヘルプセンターを構築し、多言語化設定をしました。 顧客のヘルプセンター画面右上に言語選択メニューが表示されないため、弊社の契約先会社に問い合わせましたが、「通常は多言語化をオンにすると表示するためCSS を触り過ぎではないか」 という指摘のみでした。 試行中ですが表示できません。 何か要因となる情報をお持ちの方がいましたらご教授いただけますと幸いです。 ↓の赤枠を表示したいのですが、表示できません。

    • How to reply to thread via API

      We have built a webapp for our customers that uses the Zoho Desk API to enable each customer to view their full list of tickets, view individual tickets and raise new tickets. The Zoho Desk API doesn't have the ability to reply to a ticket/thread. Replies

    • Email Builder Editor is not functioning or loading correctly

      Email editor function is not working or loading correctly in any template, new or old. Cleared my cache, restarted browser, problem unchanged.

    • Create Tasklist with Tasklist Template using API v3

      In the old API, we could mention the parameter 'task_template_id' when creating a tasklist via API to apply a tasklist template: https://www.zoho.com/projects/help/rest-api/tasklists-api.html#create-tasklist In API v3 there does not seem to be a way to

    • Issue in downloading the sent logs

      Hi Team, I'm unable to export the sent file for any email campaign. When selecting all fields, the system indicates that the document will be sent via email, but I haven't received it. At times, it shows a download option, but the file doesn’t get downloaded.

    • Integrate Google Chat with Zoho CRM for seamless collaboration

      Hello everyone, Sales is a team sport and sales reps have to be in constant communication with people inside and outside their organization. While email remains the most effective channel for important conversations, sales reps often collaborate via chat.

    • customers enter orders?

      Anyway we can let a customer into CRM and enter their own orders , no access to anything else except history reports, no access to any other contacts. Greg Aanes 2109 Queen Street Bellingha WA USA

    • Zoho Learn - URL Parameters for Externally Shared Articles?

      Hey Folks, Are there any parameters one can append to URLs for externally-shared articles? Specifically, can I add a parameter that hides the Manual name (use case being I want to embed the article in another webpage)? Also, can one password-protect an

    • Why Sharing Rules do Not support relative date comparison???

      I am creating a Sharing Rule and simply want to share where "Last Day of Coverage" (Date field) is Greater than TODAY (Starting Tomorrow). However, sharing rules don't have the option to compare a date field to a relative date (like today), only to Static

    • 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

    • Activity or History Log User Login

      Hi Everyone, I have Zoho Customer Portal, which has pages and reports. Is it possible to create 1 field such as true/false to find out users who have opened the customer portal? Like a kind of user activity log. Thank you so much.

    • How to associate a document sent in Zoho Sign with an deal in the CRM?

      Hi, often documents are loaded in Zoho sign and sent for signature. These sometimes are linked to a deal in the Zoho CRM and would be nice to see the status of the document within the CRM. I am aware of the integration, but that assumes that the document

    • Invalid Emails in CRM

      Is there a way to get a report or create a view that shows all email addresses that are invalid for any reason? I keep coming across them and want to ensure that they are flagged with users to update. This is on a custom module.

    • Add Custom Reports To Dashboard or Home Tab

      Hi there, I think it would be great to be able to add our custom reports to the Home Tab or Dashboards. Thanks! Chad

    • Associating an Email from CRM Email Parser to Contact Record via Function

      Is it possible to create a custom function that will associate email records from zCRM's Email Parser functionality to a contact record where specific fields match? Our use-case is that we have service providers using third-party event booking systems

    • Update Client Record based on creation of custom module record

      Hi! Hoping for someone's help with this one. I have a custom module called 'Agreement History. Whenever a deal is won, it creates a new record in this module with associated 'Products' and 'Clients' to track rental history and contracts. What I'm trying

    • Inputting VAT Pre-Registration expenses for first VAT Return

      Hi Zoho, I've just registered for VAT and am setting up Zoho to handle calculations and VAT return submissions. I'm struggling to figure out how to input the last 4 years worth of expenses into Zoho so that they're calculated in the VAT module. When I

    • How to Bring to front the picture?

      I have 2 pictures that have to layers but i can't find bring to front button, Thank

    • setting owner of note when adding via deluge

      My organization has requested the ability to mass update the notes related list in the deals module. Since this can't be done with the mass update feature, I created an update "notes single" line field and created a workflow rule that triggers a function

    • Creating email schedules with custom filters for Pivot/Summary Reports in Zoho Analytics

      Hi Zoho, I have a Weekly Inventory Report that I'd like to send out to various vendors. Is it possible to create an email schedule for each vendor with customized filtering at the scheduling level? Currently, we generate two pre-filtered reports (copies

    • Can Client generate Sales Order by himself?

      My business primarily operates in the B2B sector, and I've observed that my sales team and I spend an excessive amount of time obtaining sales orders from our customers. This is particularly relevant in a product-based business with multiple SKUs. I am

    • Python - code studio

      Hi, I see the code studio is "coming soon". We have some files that will require some more complex transformation, is this feature far off? It appears to have been released in Zoho Analytics already

    • Next Page