Enable your teams to respond in seconds by bridging the gap between booking confirmation and team notification. No sticky notes, no calendar nudges and no follow-up frenzies. For businesses that rely on scheduled appointments, real-time visibility is a crucial operational need.

Timely automated communication is essential for managing important appointments and bookings. Let's integrate Zoho Bookings with Zoho Cliq via the Cliq developer platform's bots and workflows, ensuring that every appointment confirmation is automated and reaches Cliq chats promptly.

Business Benefits

  1. Operational Efficiency: This custom solution eliminates the need for manual dashboard monitoring. Booking updates are automatically communicated to Cliq as they occur.
  2. Enhanced Customer Experience: Faster internal awareness leads to expedited confirmations, better-prepared staff, and a more seamless appointment experience.
  3. Centralized Communication: All booking activities are consolidated in the same Cliq channel your team uses daily, minimizing context switching and preventing information silos.
  4. Enterprise-Ready, No Additional Cost: Built entirely on the Zoho Cliq Developer platform, this custom solution requires no third-party middleware. It operates within your existing Zoho subscription framework.

Step 1: Create a bot 

  1. Go to the top-right corner of your profile and click on it.
  2. Select "Bots and Tools" from the dropdown menu.
  3. To create a new bot, click on "Create Bot" under the "Bots" section.
  4. Enter a name and description for your bot and ensure that channel configuration settings are enabled during setup.
  5. Finally, save the bot.

Step 2: Retrieve the bot webhook URL 

  1. Webhook tokens are listed in the Bots & Tools section along with other internal tools.
  2. When you access the webhook tokens module, you'll need to authenticate using two-factor authentication (2FA), verify your identity, and then click "Continue."
  3. After authenticating, you can create, edit, and manage your webhook tokens as needed.
  4. Generate a webhook token and retrieve the bot's webhook URL as instructed.
ⓘ Learn more about webhook tokens in Zoho Cliq.


Step 3: Generate Cliq bot incoming url  

To create the bot's incoming URL, combine the bot's endpoint with the webhook token.
  1. Navigate to the newly created bot and click on it. A pane will appear showing the bot's URL details.
  2. Copy your bot's incoming endpoint from this window and append your token to it:
  1. https://cliq.zoho.com/api/v2/bots/<yourbotname>/incoming?zapikey=<webhooktoken>
Keep this URL handy, as you will need to paste it into the Zoho Bookings workflow later.

Step 4 : Creating a workflow in Zoho Bookings 


  1. Log in to Zoho Bookings.
  2. In the left panel, navigate to one of the following options:
    1. Workflows → Custom Workflows → Create New Workflow
    2. or Workflows → Create Workflow → Create New Workflow.
  3. If you chose Workflows → Custom Workflows → Create New Workflow, complete the following fields:
    1. Workflow Name: Enter a name for your workflow.
    2. Trigger When: Select "Booked."
    3. Occurrence: Choose "Immediately."
    4. Choose Service (e.g., IT Consulting): Select your Service.
    5. Perform Action: Select "Execute Custom Functions."
    6. Customize Template: Paste the following code. 
  4. In the template editor, paste the code, replacing "<bot incoming url>" with the full URL you created in the previous step. 
    1. bookingInfoMap = Map();
    2. bookingInfoMap.put("BookingInfo",bookingInfo);
    3. cliqWebhookTrigger = invokeurl
    4. [
    5. url : "<bot incoming url>"
    6. type :POST
    7. parameters:{"Book Details":bookingInfo} + ""
    8. headers:{"content-type":"application/json"}
    9. ];
    10. info cliqWebhookTrigger;
  5. Click Create Workflow. With this setup, whenever a new appointment is booked, it will trigger a notification to your Cliq bot's incoming handler.

Step 6 : Setting up bot incoming webhook handler   

  1. Head back to Cliq, locate the bot you created under the "Bots and Tools" section, and access its incoming webhook handler.
  2. The incoming webhook handler is designed to allow third-party services, such as Zoho Bookings, to post messages directly to your bot.
  3. Copy and paste the below code, then click "Save".
Note: You can customize the message format using the Message Builder.

Pre-requisites before scripting:
  1. Create a Zoho Cliq Default Connection:

    Before you begin scripting the code below, you need to create a connection in Zoho Cliq. Once the connection is established, you can use it in Deluge integration tasks and invoke URL scripts to access data from the required service.

    Use a unique name for the connection with the scope set to ZohoCliq.Reminders.All.

    Note: Refer to the document on Connections in Cliq for more information.

  2. Post Alerts to a Channel:

    To post an alert to a channel, you'll need the unique names of both the channel and the bot. This is necessary as we will use the zoho.cliq.postToChannelAsBot Deluge task in the code below. Follow these steps to retrieve these names:

    How to Obtain the Channel Unique Name in Cliq?:

    • Navigate to the top right corner of your preferred channel and click on the three dots.
    • In the menu that appears, select "Channel info." A pop-up will display detailed information about the channel.
    • Hover over the "Connectors" section and click on it.
    • Under "API Parameters," you will find the channel unique name.

    How to Obtain the Bot Unique Name in Cliq?

    • Go to "Bots & Tools," and under the bots section, select your preferred bot.
    • Copy the API endpoint URL. The bot's unique name is located between "bots/" and the next slash ("/").

    Example:

    In this example, the bot's unique name is crmupdatesincliq.

  3. Retrieve the Bot Chat ID:
    • Open Zoho Cliq and navigate to your bot in the chat window.
    • Click on the bot to open the conversation.
    • Check the URL in your browser; the bot chat ID is the alphanumeric string that appears after "chats/".

    Example:

    In this example, the bot chat ID is CT_9874563201845670134_10005673821-B7.

After creating the connection, retrieving the channel unique name, bot unique name, and bot chat ID, keep this information handy for use in the code below.

Script
  1. response = Map();
  2. info params;
  3. info headers;
  4. info body;
  5. bookingDetails = body.get("Book Details");
  6. info bookingDetails;
  7. bookingID = bookingDetails.get("booking_id");
  8. workspaceName = bookingDetails.get("workspace_name");
  9. customerEmail = bookingDetails.get("customer_email");
  10. startTime = bookingDetails.get("start_time");
  11. endTime = bookingDetails.get("end_time");
  12. timeZone = bookingDetails.get("time_zone");
  13. summaryUrl = bookingDetails.get("summary_url");
  14. responseMsgCard = {"text":"### 📅 New Appointment","card":{"theme":"modern-inline"},"slides":{{"type":"label","title":"Details","buttons": [
  15. {"label": "Open Summary","action": {"type": "open.url","data": {"web":summaryUrl}}}],"data":{{"🆔 Booking ID":bookingID},{"🏢 Workspace":workspaceName},{"📧Customer Email":customerEmail},{"🕒 Time":startTime + " - " + endTime},{"🌍 TZ":timeZone}}}}};
  16. info zoho.cliq.postToBot("<bot unique name>",responseMsgCard);
  17. //Post to your Bot
  18. info zoho.cliq.postToChannelAsBot("<Channel unique name>","<bot unique name>",responseMsgCard);
  19. //It will send to channel with bot permission.
  20. //--------------------------------- To set reminder -------------------------------//
  21. eventTimeZone = bookingDetails.get("time_zone");
  22. info eventTimeZone;
  23. userTimeZone = user.get("timezone");
  24. dateTimeObj = bookingDetails.get("start_time").toTime("dd-MMM-yyyy HH:mm:ss",eventTimeZone).toString("dd-MM-yyyy HH:mm:ss");
  25. info dateTimeObj;
  26. info dateTimeObj.toTime("dd-MM-yyyy HH:mm:ss",user.get("timezone")).subMinutes(60);
  27. datetime_30min_sub = dateTimeObj.toTime("dd-MM-yyyy HH:mm:ss",userTimeZone).subMinutes(30).toString("dd-MMM-yyyy HH:mm:ss",userTimeZone);
  28. datetime_60min_sub = dateTimeObj.toTime("dd-MM-yyyy HH:mm:ss",userTimeZone).subMinutes(60).toString("dd-MMM-yyyy HH:mm:ss",userTimeZone);
  29. info datetime_60min_sub+"datetime_60min_sub";
  30. info datetime_30min_sub+"datetime_30min_sub";
  31. secondsVal_60sec_before = datetime_60min_sub.unixEpoch(userTimeZone);
  32. secondsVal_30sec_before = datetime_30min_sub.unixEpoch(userTimeZone);
  33. info secondsVal_60sec_before;
  34. info secondsVal_30sec_before;
  35. reminderTimes = list();
  36. reminderTimes.add(secondsVal_60sec_before);
  37. reminderTimes.add(secondsVal_30sec_before);
  38. for each  reminderTime in reminderTimes
  39. {
  40. param = Map();
  41. content = "Zoho Bookings Reminder : " + bookingID;
  42. param.put("content",content);
  43. param.put("time",reminderTime);
  44. chatidsList = list();
  45. chatidsList.add("<Bot chat id>");
  46. param.put("chat_ids",chatidsList);
  47. createReminder = invokeurl
  48. [
  49. url :"https://cliq.zoho.com/api/v2/reminders"
  50. type :POST
  51. parameters:param + ""
  52. connection:"<your connection name>"
  53. ];
  54. info createReminder;
  55. }
  56. return response;


Team responsiveness and operational clarity are critical, and automated booking alerts create a measurable impact. Businesses managing a scalable client base and operating on appointments cannot afford delays in information. Every booking that goes unnoticed is a missed chance to respond and deliver.

This custom solution brings real-time Zoho booking data into the Cliq communication layer, effectively filling the gap, letting teams stay coordinated, respond faster, and deliver a consistently better experience to every customer.

If you have any further questions or need support, please reach out to support@zohocliq.com, and we'll be happy to assist you.